Stream接口

新建Stream

推流类型stream,用户只需要在域名下指定app、stream名称,就可以拼接推流地址。

推流

直播推流的状态包括下列几种:

  • 已就绪 ready
  • 直播中有输入流 ongoing:streaming;无输入流 ongoing:no_resource。streaming,no_resource为ongoing的子状态,会因为网络等因素导致直播不稳定而切换状态。
  • 已暂停 paused

查询所有Stream

接口描述

查询特定Domain下的所有Stream。

请求语法

GET /v<version>/domain/<playDomain>/stream HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求头域

无特殊请求头域。

请求参数

参数 类型 描述 是否必须
playDomain String 直播域名
status String Stream状态,有效值:READY、ONGOING、PAUSED
marker String 本次请求的marker,标记查询的起始位置
maxSize Integer 本次请求的Stream数目,不超过200。默认值:200

请求示例

GET /v5/domain/demo.domain.com/stream HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/f1a2705d3cf8448cb917684c4f40ac1f/2016-01-28T07:19:17Z/3600/host;x-bce-account;x-bce-console-rpc-id;x-bce-date;x-bce-request-id/31b7dce808571441fb78077e74c048495945536909bbebd37e4037b7c796bf15

{
  "playDomain": "demo.domain.com",
  "status": "READY"
 }

响应头域

无特殊响应头域。

响应参数

参数 类型 描述
marker String 本次请求的marker,标记查询的起始位置
isTruncated Boolean 数据是否截断。True表示后面还有数据,False表示已经是最后一页
nextMarker String 获取下一页所需要传递的marker值,仅当"isTruncated": true时有效
streams Array 流列表
+sessionId String stream 对应的sessionID
+app String app信息
+playDomain String 直播域名
+description String 流描述
+publish Object 直播源信息
++region String 流所属区域
++pushStream String 推流Stream
++pullUrl String 拉流url,仅对拉流有效
+status String 直播状态,有效值:READY/ONGOING/PAUSED
+streamingStatus String 直播流状态,仅当status=ONGOING时存在,有效值:STREAMING、NO_SOURCE、FAILED
+error Object 直播流错误信息,仅当streamingStatus=FAILED时存在
++code String 错误码
++message String 错误详情
++image String 图片水印模版名称列表
++timestamp String 时间戳水印模版名称,单模版支持创建一个时间戳水印
+createTime Date 流创建时间

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
Cache-Control: no-cache
Server: BWS
Date: Thu, 28 Jan 2016 07:19:17 GMT
Content-Type: application/json;charset=UTF-8

{
  "isTruncated": true,
  "marker": "p-ga3h4ihs3dededaa",
  "nextMarker": "p-ga3h9q00hu7ayxmp",
  "streams" : [ 
    {
    "app": "demo_app",
    "createTime": "2016-07-14T08:20:02Z",
    "description": "",
    "playDomain": "demo.domain.com",
    "publish": {
        "pullUrl": "http://testpull.baidu.com",
        "pushStream": "demo_stream",
        "region": "bj"
    },
    "sessionId": "p-ggps1qiiin8b0a3z",
    "statistics": {
        "bandwidthInBps": 0,
        "playCount": 0
    },
    "status": "ONGOING"
    "streamingStatus": "STREAMING"
    }, ...
  ]
}

查询所有App

接口描述

查询特定Domain下所有App(不包括默认App)。

请求语法

GET /v<version>/domain/<playDomain>/app HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

GET /v5/domain/demo.domain.com/app HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

[
    "demo_app",
    "live0",
    "test_app"
]

查询特定Stream

接口描述

查询特定Domain下的特定Stream。

请求语法

GET /v5/domain/<playDomain>/app/<app>/stream/<stream> HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

GET  /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/f1a2705d3cf8448cb917684c4f40ac1f/2016-01-28T07:19:19Z/3600/host;x-bce-account;x-bce-console-rpc-id;x-bce-date;x-bce-request-id/47a7d2dc00dce815ed39b5420b05a102bf070568c36c30066ce06ea900159bd3

响应头域

无特殊响应头域。

响应参数

参数 类型 描述
sessionId String 流的唯一标识
playDomain String 直播域名
app String App名称
description String 流描述
preset String 转码模板
presets Object 多码率下转码模板列表
+L0 String L0模式下使用的转码模板名称
+L1 String L1模式下使用的转码模板名称
+L2 String L2模式下使用的转码模板名称
+L3 String L3模式下使用的转码模板名称
+L4 String L4模式下使用的转码模板名称
publish Object 直播源信息
+region String 流所属区域
+pushStream String 推流Stream
+ pushUrl String 推流地址,仅对推流有效
+ pullUrl String 拉流地址,仅对拉流有效
play Object 直播播放信息
+hlsUrl String hls直播播放地址
+rtmpUrl String rtmp直播播放地址
+flvUrl String flv直播播放地址
+hlsUrls Object 多码率下hls直播播放地址列表
++L0 String L0模式hls直播播放地址
++L1 String L1模式hls直播播放地址
++L2 String L2模式hls直播播放地址
++L3 String L3模式hls直播播放地址
++L4 String L4模式hls直播播放地址
+rtmpUrls Object 多码率下rtmp直播播放地址列表
++L0 String L0模式rtmp直播播放地址
++L1 String L1模式rtmp直播播放地址
++L2 String L2模式rtmp直播播放地址
++L3 String L3模式rtmp直播播放地址
++L4 String L4模式rtmp直播播放地址
+flvUrls Object 多码率下flv直播播放地址列表
++L0 String L0模式flv直播播放地址
++L1 String L1模式flv直播播放地址
++L2 String L2模式flv直播播放地址
++L3 String L3模式flv直播播放地址
++L4 String L4模式flv直播播放地址
status String 流状态,有效值:READY/ONGOING/PAUSED
recording String 录制模板
thumbnail String 缩略图模板
watermarks Object 水印模版,包括图片水印模版和时间戳水印模版,每个流不能超过五个水印模版
+image String 图片水印模版名称列表
+timestamp String 时间戳水印模版名称,单模版支持创建一个时间戳水印
notification String 通知
securityPolicy String 安全策略
audit String 内容审核名称
scene String 直播场景名称
createTime Date 流创建时间
statistics Object 即时流统计信息
+bandwidthInBps Number 当前流的占用带宽(bps)
+playCount Number 当前流的播放人数

响应示例

{
    "app": "demo_app",
    "audit": "default",
    "createTime": "2016-07-14T08:20:02Z",
    "description": "",
    "play": {
        "flvUrl": "http://play.hello.com/test_app/test_stream.flv",
        "rtmpUrl": "rtmp://play.hello.com/test_app/test_stream"
    },
    "playDomain": "demo.domain.com",
    "preset": "live.rtmp_hls_forward_only",
    "presets": {
        "L0": "live.rtmp_hls_forward_only"
    },
    "publish": {
        "pullUrl": "http://testpull.baidu.com",
        "pushStream": "demo_stream",
        "region": "bj"
    },
    "scene": "normal",
    "securityPolicy": "default",
    "sessionId": "p-ggps1qiiin8b0a3z",
    "statistics": {
        "bandwidthInBps": 0,
        "playCount": 0
    },
    "status": "ONGOING"
    "streamingStatus": "STREAMING"
}

查询活跃的Stream

接口描述

查询指定的播放domain下所有推流中的Stream(活跃Stream)。

请求语法

GET /v{version}/domain/{playDomain}/streaming HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求参数

参数 类型 是否必须 描述 可选值 默认值
playDomain String 查询的域名 - -

请求示例

GET /v5/domain/demo.domain.com/streaming HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/f1a2705d3cf8448cb917684c4f40ac1f/2016-01-28T07:19:19Z/3600/host;x-bce-account;x-bce-console-rpc-id;x-bce-date;x-bce-request-id/47a7d2dc00dce815ed39b5420b05a102bf070568c36c30066ce06ea900159bd3

响应参数

参数 类型 描述
streams List 活跃流的信息
+ sessionId String 会话ID
+ app String app信息
+ playDomain String 所属播放域名
+ stream String 推流stream
+ userId String 用户Id

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
Cache-Control: no-cache
Server: BWS
Date: Thu, 28 Jan 2016 07:19:17 GMT
Content-Type: application/json;charset=UTF-8

{
    "streams" : [ 
    {
      "app": "demo_app",
      "playDomain": "demo.domain.com",
      "stream": "demo_stream",
      "sessionId": "f-23ps11iiin8b0a3z",
      "userId": "aabbccddeeffhh112233445566778899"
    }, ...
  ]
}

封禁特定Stream

接口描述

封禁播放domain下特定播放stream时,将直接封禁该条直播流,无法推流和播放。

请求语法

PUT /v5/domain/<playDomain>/app/<app>/stream/<stream>?pause HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?pause HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

解禁特定Stream

接口描述

解禁特定Domain下的特定Stream。

请求语法

PUT /v5/domain/<playDomain>/app/<app>/stream/<stream>?resume HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?resume HTTP/1.1
host: lss.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

删除特定Stream

请求语法

DELETE /v5/domain/{playDomain}/app/{app}/stream/{stream} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: lss.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

DELETE /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream HTTP/1.1
content-length: 0
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
connection: keep-alive
accept: */*
user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
host: lss.bj.baidubce.com
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

重置特定stream

中断当前直播流,并保证下次可以再次推流成功。

请求语法

PUT /v5/domain/{playDomain}/app/{app}/stream/{stream}?reset HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: lss.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?reset HTTP/1.1
content-length: 0
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
connection: keep-alive
accept: */*
user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
host: lss.baidubce.com
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

添加metadata信息

接口描述

为某个直播中的流添加metadata信息,本接口仅对streamingStatus=STREAMING的stream有效。

请求语法

PUT /v5/domain/{playDomain}/app/{app}/stream/{stream}?addMetadata HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: lss.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

参数 字段类型 是否必须 字段描述
metadata Map 新增的metadata信息

请求示例

PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?addMetadata HTTP/1.1
content-length: 0
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
connection: keep-alive
accept: */*
user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
host: lss.bj.baidubce.com
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

{
    “metadata”: {
        “k1”: “v1”,
        “k2”: “v2”
    }
}

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

更新Stream水印模版

接口描述

更新Stream水印模版的配置。

  • 默认继承域名下配置的水印模板,也可以通过本接口,对某个Stream单独设置水印模板。
  • 如果watermarks为空,则更新结果为null,继承域名下的水印模板配置。

请求语法

POST /v5/domain/{playDomain}/app/{app}/stream/{stream}?watermark HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: lss.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

参数 字段类型 是否必须 字段描述
watermarks Object 更新的水印模版配置
+ image Array 图片水印模版名称列表
+ timestamp Array 时间戳水印模版名称列表

请求示例

POST /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?watermark HTTP/1.1
content-length: 0
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
connection: keep-alive
accept: */*
user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
host: lss.bj.baidubce.com
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

"watermarks": {
      "image":["demo_image_watermark1", "demo_image_watermark2"],
      "timestamp": ["demo_timestamp_watermark"]
}

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

更新Stream录制模版

接口描述

更新Stream录制模版的配置。

  • 默认继承域名下配置的录制模版,也可以通过本接口,对某个Stream单独设置录制模板。
  • 如果本接口recording为空,则更新结果为null,继承域名下的录制模板配置。

请求语法

PUT /v5/domain/{playDomain}/app/{app}/stream/{stream}?recording={recording} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: lss.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

参数 字段类型 是否必须 字段描述
recording String 更新录制模板

请求示例

PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?recording=recording_gz HTTP/1.1
content-length: 0
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
connection: keep-alive
accept: */*
user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
host: lss.bj.baidubce.com
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

更新stream转码模版

接口描述

更新stream转码模版的配置。

  • 默认继承域名下配置的转码模版,也可以通过本接口,对某个Stream单独设置转码模板。
  • 如果本接口presets为空,则更新结果为null,继承域名下的转码模板配置。

请求语法

POST /v5/domain/{playDomain}/app/{app}/stream/{stream}?presets HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: lss.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

参数 字段类型 是否必须 字段描述
presets Map 更新的转码模版配置
+L1 String L1线路下使用的转码模板名称
+L2 String L2线路下使用的转码模板名称
+L3 String L3线路下使用的转码模板名称
+L4 String L4线路下使用的转码模板名称

注意:

  1. presets更新的合法keys仅限于L1,L2,L3,L4线路。
  2. L0为系统默认字段,不能自定义模版。

请求示例

PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?presets HTTP/1.1
content-length: 0
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
connection: keep-alive
accept: */*
user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
host: lss.bj.baidubce.com
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

"presets": {
    "L1": "preset_l1"
}

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

更新stream目标推流地址

接口描述

更新stream目标推流地址

请求语法

PUT /v5/domain/{playDomain}/app/{app}/stream/{stream}?destinationPushUrl={destinationPushUrl} HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: {utc-date-string}
host: lss.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: {bce-request-id}
content-type: application/json
authorization: {bce-authorization-string}

请求头域

无特殊请求头域。

请求参数

参数 字段类型 是否必须 字段描述
destinationPushUrl String 更新目标推流地址

请求示例

PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?destinationPushUrl=rtmp://demo.baidu.com/destination.flv HTTP/1.1
content-length: 0
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
connection: keep-alive
accept: */*
user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
host: lss.bj.baidubce.com
x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

响应头域

无特殊响应头域。

响应参数

N/A

响应示例

HTTP/1.1 200 OK

实时直播源信息

接口描述

查询某条正在直播推流的直播源详细信息,本接口仅对streamingStatus=STREAMING的stream有效。

请求语法

GET /v{version}/domain/{playDomain}/app/{app}/stream/{stream}?sourceInfo HTTP/1.1

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

GET /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?sourceInfo HTTP/1.1

响应头域

无特殊响应头域。

响应参数

参数 字段类型 字段描述
sessionId String 流的唯一ID
sourceIP String 返回将直播流推向媒体中心CDN的对应IP
publishIP String 推流端IP地址
score Number 推流拉流质量评分[0,100],100表示质量最好,0 表示质量最差
captureTime Date 直播源信息采时间
inputBitRateInBps Number 实时输入总码率,包括视频/音频/数据
video Object 视频信息
+ codec String 视频codec,NA表示无视频或未识别
+ profile String 视频profile,NA表示无视频或未识别
+ level String 视频level,NA表示无视频或未识别
+ widthInPixel Number 视频宽度,0表示无视频或未识别
+ heightInPixel Number 视频高度,0表示无视频或未识别
+ frameRate Number 视频标称帧率,0表示无视频或未识别
+ bitRateInBps Number 视频实时码率
+ realFPS Number 视频实时帧率
audio Object 音频信息
+ codec String 音频codec,NA表示无音频或未识别
+ profile String 音频profile, NA表示无音频或未识别
+ sampleRateInHz Number 音频采样率,0表示无音频或未识别
+ channels Number 音频声道数,0表示无音频或未识别
+ bitRateInBps Number 音频实时码率

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: cde8bf42-8021-46de-8e9c-5cd088bfcee2
Cache-Control: no-cache
Server: BWS
Date: Thu, 04 Feb 2016 03:00:58 GMT
Content-Type: application/json;charset=UTF-8

{
  "sessionId" : "p-ga3pk3t3t9wc1h60",
  "sourceIP" : "10.111.65.220",
  "score" : 100,
  "captureTime" : "2016-02-04T03:00:56Z",
  "inputBitRateInBps" : 5980249,
  "video" : {
    "codec" : "H264",
    "profile" : "High",
    "level" : "3.1",
    "widthInPixel" : 1280,
    "heightInPixel" : 720,
    "frameRate" : 29.1,
    "bitRateInBps" : 5828568,
    "realFPS" : 28.9269
  },
  "audio" : {
    "codec" : "AAC",
    "profile" : "Main",
    "sampleRateInHz" : 44100,
    "channels" : 2,
    "bitRateInBps" : 151680
  }
}

域名下实时直播源信息

接口描述

查询域名下所有正在直播推流过程的直播源详细信息,本接口仅对streamingStatus=STREAMING的stream有效。

请求语法

GET /v{version}/domain/{playDomain}/sourceInfo HTTP/1.1

请求头域

无特殊请求头域。

请求参数

N/A

请求示例

GET /v5/domain/demo.domain.com/sourceInfo HTTP/1.1

响应头域

无特殊响应头域。

响应参数

字段名称 字段类型 字段描述
sourceInfoList Array sourceInfo List
+ sessionId String 会话ID,用户无需关注
+ playDomain String 播放域名
+ app String app名称
+ stream String stream名称
+ sourceIP String cdn节点IP地址,NA表示未知
+ score Number 推流拉流质量评分[0,100],100表示质量最好,0 表示质量最差
+ captureTime Date 直播源信息采时间
+ inputBitRateInBps Number 实时输入总码率,包括视频/音频/数据
+ video Object 视频信息
++ codec String 视频codec,NA表示无视频或未识别
++ profile String 视频profile,NA表示无视频或未识别
++ level String 视频level,NA表示无视频或未识别
++ widthInPixel Number 视频宽度,0表示无视频或未识别
++ heightInPixel Number 视频高度,0表示无视频或未识别
++ frameRate Number 视频标称帧率,0表示无视频或未识别
++ bitRateInBps Number 视频实时码率
++ realFPS Number 视频实时帧率
+ audio Object 音频信息
++ codec String 音频codec,NA表示无音频或未识别
++ profile String 音频profile, NA表示无音频或未识别
++ sampleRateInHz Number 音频采样率,0表示无音频或未识别
++ channels Number 音频声道数,0表示无音频或未识别
++ bitRateInBps Number 音频实时码率

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: cde8bf42-8021-46de-8e9c-5cd088bfcee2
Cache-Control: no-cache
Server: BWS
Date: Thu, 04 Feb 2016 03:00:58 GMT
Content-Type: application/json;charset=UTF-8

[
  {
    “sessionId” : “p-ga3pk3t3t9wc1h60”,
    “playDomain”: “play.demo.com”,
    “app”: “demoapp”,
    “stream”: “demostream”,
    “nodeIp” : “10.111.65.220”,
    “score” : 100,
    “captureTime” : “2016-02-04T03:00:56Z”,
    “inputBitRateInBps” : 5980249,
    “video” : {
      “codec” : “H264”,
      “profile” : “High”,
      “level” : “3.1”,
      “widthInPixel” : 1280,
      “heightInPixel” : 720,
      “frameRate” : 29.1,
      “bitRateInBps” : 5828568,
      “realFPS” : 28.9269
    },
    “audio” : {
      “codec” : “AAC”,
      “profile” : “Main”,
      “sampleRateInHz” : 44100,
      “channels” : 2,
      “bitRateInBps” : 151680
    }
  }, ...
]