Stream接口
更新时间：2022-08-11
新建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?status=READY 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响应头域
无特殊响应头域。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| 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
响应示例
{
"appList": [
"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更新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线路下使用的转码模板名称 |
注意：
- presets更新的合法keys仅限于L1，L2，L3，L4线路。
- 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
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?sourceInfo 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响应头域
无特殊响应头域。
响应参数
| 参数 | 字段类型 | 字段描述 |
|---|---|---|
| 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
host: lss.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
GET /v5/domain/demo.domain.com/sourceInfo 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响应头域
无特殊响应头域。
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| 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”,
“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
}
}, ...
] 查看实时流推流url参数
接口描述
查询某条正在直播推流的推流url参数信息
请求语法
GET /v{version}/domain/{pushDomain}/app/{app}/stream/{stream}/params 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/{app}/stream/{stream}/params 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响应头域
无特殊响应头域。
响应参数
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| params | Object | 推流参数列表 |
| + param1 | String | 参数名，值为参数值 |
| + param2 | String | 参数名，值为参数值 |
响应示例
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
{
"params" : {
"param1": "paramValue1",
"param2": "paramValue2"
}
}