Stream接口
更新时间：2022-08-11
新建Stream
推流类型stream，用户只需要在域名下指定app、stream名称，就可以拼接推流地址。
推流
直播推流的状态包括下列几种：
- 已就绪 ready
- 直播中有输入流 ongoing:streaming；无输入流 ongoing:no_resource。streaming，no_resource为ongoing的子状态，会因为网络等因素导致直播不稳定而切换状态。
- 已暂停 paused
查询所有Stream
接口描述
查询特定Domain下的所有Stream。
请求语法
Plain Text
1GET /v<version>/domain/<playDomain>/stream HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| playDomain | String | 直播域名 | 是 |
| status | String | Stream状态，有效值：READY、ONGOING、PAUSED | 否 |
| marker | String | 本次请求的marker，标记查询的起始位置 | 否 |
| maxSize | Integer | 本次请求的Stream数目，不超过200。默认值：200 | 否 |
请求示例
Plain Text
1GET /v5/domain/demo.domain.com/stream?status=READY HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: 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 | 流创建时间 |
响应示例
Plain Text
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
4Cache-Control: no-cache
5Server: BWS
6Date: Thu, 28 Jan 2016 07:19:17 GMT
7Content-Type: application/json;charset=UTF-8
8
9{
10 "isTruncated": true,
11 "marker": "p-ga3h4ihs3dededaa",
12 "nextMarker": "p-ga3h9q00hu7ayxmp",
13 "streams" : [
14 {
15 "app": "demo_app",
16 "createTime": "2016-07-14T08:20:02Z",
17 "description": "",
18 "playDomain": "demo.domain.com",
19 "publish": {
20 "pullUrl": "http://testpull.baidu.com",
21 "pushStream": "demo_stream",
22 "region": "bj"
23 },
24 "sessionId": "p-ggps1qiiin8b0a3z",
25 "statistics": {
26 "bandwidthInBps": 0,
27 "playCount": 0
28 },
29 "status": "ONGOING"
30 "streamingStatus": "STREAMING"
31 }, ...
32 ]
33}查询所有App
接口描述
查询特定Domain下所有App（不包括默认App）。
请求语法
Plain Text
1GET /v<version>/domain/<playDomain>/app HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1GET /v5/domain/demo.domain.com/app HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1{
2 "appList": [
3 "demo_app",
4 "live0",
5 "test_app"
6 ]
7 }查询特定Stream
接口描述
查询特定Domain下的特定Stream。
请求语法
Plain Text
1GET /v5/domain/<playDomain>/app/<app>/stream/<stream> HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1GET /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: 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 | 当前流的播放人数 |
响应示例
Plain Text
1{
2 "app": "demo_app",
3 "audit": "default",
4 "createTime": "2016-07-14T08:20:02Z",
5 "description": "",
6 "play": {
7 "flvUrl": "http://play.hello.com/test_app/test_stream.flv",
8 "rtmpUrl": "rtmp://play.hello.com/test_app/test_stream"
9 },
10 "playDomain": "demo.domain.com",
11 "preset": "live.rtmp_hls_forward_only",
12 "presets": {
13 "L0": "live.rtmp_hls_forward_only"
14 },
15 "publish": {
16 "pullUrl": "http://testpull.baidu.com",
17 "pushStream": "demo_stream",
18 "region": "bj"
19 },
20 "scene": "normal",
21 "securityPolicy": "default",
22 "sessionId": "p-ggps1qiiin8b0a3z",
23 "statistics": {
24 "bandwidthInBps": 0,
25 "playCount": 0
26 },
27 "status": "ONGOING"
28 "streamingStatus": "STREAMING"
29}查询活跃的Stream
接口描述
查询指定的播放domain下所有推流中的Stream（活跃Stream）。
请求语法
Http
1GET /v{version}/domain/{playDomain}/streaming HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求参数
| 参数 | 类型 | 是否必须 | 描述 | 可选值 | 默认值 |
|---|---|---|---|---|---|
| playDomain | String | 是 | 查询的域名 | - | - |
请求示例
Http
1GET /v5/domain/demo.domain.com/streaming HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: 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
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 8dbde9a9-34e8-4071-afa0-b6d4c4e974b2
4Cache-Control: no-cache
5Server: BWS
6Date: Thu, 28 Jan 2016 07:19:17 GMT
7Content-Type: application/json;charset=UTF-8
8
9{
10 "streams" : [
11 {
12 "app": "demo_app",
13 "playDomain": "demo.domain.com",
14 "stream": "demo_stream",
15 "sessionId": "f-23ps11iiin8b0a3z",
16 "userId": "aabbccddeeffhh112233445566778899"
17 }, ...
18 ]
19}封禁特定Stream
接口描述
封禁播放domain下特定播放stream时，将直接封禁该条直播流，无法推流和播放。
请求语法
Plain Text
1PUT /v5/domain/<playDomain>/app/<app>/stream/<stream>?pause HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?pause HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1HTTP/1.1 200 OK解禁特定Stream
接口描述
解禁特定Domain下的特定Stream。
请求语法
Plain Text
1PUT /v5/domain/<playDomain>/app/<app>/stream/<stream>?resume HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?resume HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1HTTP/1.1 200 OK删除特定Stream
请求语法
Plain Text
1DELETE /v5/domain/{playDomain}/app/{app}/stream/{stream} HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: lss.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1DELETE /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream HTTP/1.1
2content-length: 0
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.bj.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1HTTP/1.1 200 OK重置特定stream
中断当前直播流，并保证下次可以再次推流成功。
请求语法
Http
1PUT /v5/domain/{playDomain}/app/{app}/stream/{stream}?reset HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: lss.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Http
1PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?reset HTTP/1.1
2content-length: 0
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Http
1HTTP/1.1 200 OK更新Stream水印模版
接口描述
更新Stream水印模版的配置。
- 默认继承域名下配置的水印模板，也可以通过本接口，对某个Stream单独设置水印模板。
- 如果watermarks为空，则更新结果为null，继承域名下的水印模板配置。
请求语法
Plain Text
1POST /v5/domain/{playDomain}/app/{app}/stream/{stream}?watermark HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: lss.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
无特殊请求头域。
请求参数
| 参数 | 字段类型 | 是否必须 | 字段描述 |
|---|---|---|---|
| watermarks | Object | 是 | 更新的水印模版配置 |
| + image | Array | 否 | 图片水印模版名称列表 |
| + timestamp | Array | 否 | 时间戳水印模版名称列表 |
请求示例
Plain Text
1POST /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?watermark HTTP/1.1
2content-length: 0
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.bj.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
12
13"watermarks": {
14 "image":["demo_image_watermark1", "demo_image_watermark2"],
15 "timestamp": ["demo_timestamp_watermark"]
16}响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1HTTP/1.1 200 OK更新Stream录制模版
接口描述
更新Stream录制模版的配置。
- 默认继承域名下配置的录制模版，也可以通过本接口，对某个Stream单独设置录制模板。
- 如果本接口recording为空，则更新结果为null，继承域名下的录制模板配置。
请求语法
Plain Text
1PUT /v5/domain/{playDomain}/app/{app}/stream/{stream}?recording={recording} HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: lss.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
无特殊请求头域。
请求参数
| 参数 | 字段类型 | 是否必须 | 字段描述 |
|---|---|---|---|
| recording | String | 是 | 更新录制模板 |
请求示例
Plain Text
1PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?recording=recording_gz HTTP/1.1
2content-length: 0
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.bj.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1HTTP/1.1 200 OK更新stream转码模版
接口描述
更新stream转码模版的配置。
- 默认继承域名下配置的转码模版，也可以通过本接口，对某个Stream单独设置转码模板。
- 如果本接口presets为空，则更新结果为null，继承域名下的转码模板配置。
请求语法
Plain Text
1POST /v5/domain/{playDomain}/app/{app}/stream/{stream}?presets HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: lss.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
无特殊请求头域。
请求参数
| 参数 | 字段类型 | 是否必须 | 字段描述 |
|---|---|---|---|
| presets | Map | 是 | 更新的转码模版配置 |
| +L1 | String | 否 | L1线路下使用的转码模板名称 |
| +L2 | String | 否 | L2线路下使用的转码模板名称 |
| +L3 | String | 否 | L3线路下使用的转码模板名称 |
| +L4 | String | 否 | L4线路下使用的转码模板名称 |
注意：
- presets更新的合法keys仅限于L1，L2，L3，L4线路。
- L0为系统默认字段，不能自定义模版。
请求示例
Plain Text
1PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?presets HTTP/1.1
2content-length: 0
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.bj.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
12
13"presets": {
14 "L1": "preset_l1"
15}响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1HTTP/1.1 200 OK更新stream目标推流地址
接口描述
更新stream目标推流地址
请求语法
Plain Text
1PUT /v5/domain/{playDomain}/app/{app}/stream/{stream}?destinationPushUrl={destinationPushUrl} HTTP/1.1
2accept-encoding: gzip, deflate
3x-bce-date: {utc-date-string}
4host: lss.bj.baidubce.com
5accept: */*
6connection: keep-alive
7x-bce-request-id: {bce-request-id}
8content-type: application/json
9authorization: {bce-authorization-string}请求头域
无特殊请求头域。
请求参数
| 参数 | 字段类型 | 是否必须 | 字段描述 |
|---|---|---|---|
| destinationPushUrl | String | 是 | 更新目标推流地址 |
请求示例
Plain Text
1PUT /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?destinationPushUrl=rtmp://demo.baidu.com/destination.flv HTTP/1.1
2content-length: 0
3accept-encoding: gzip, deflate
4x-bce-date: 2015-07-03T09:28:13Z
5connection: keep-alive
6accept: */*
7user-agent: python-requests/2.4.0 CPython/2.7.9 Darwin/14.3.0
8host: lss.bj.baidubce.com
9x-bce-request-id: 8776558c-81d9-4f97-8e2c-f977a286095d
10content-type: application/json
11authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-bce-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应头域
无特殊响应头域。
响应参数
N/A
响应示例
Plain Text
1HTTP/1.1 200 OK实时直播源信息
接口描述
查询某条正在直播推流的直播源详细信息，本接口仅对streamingStatus=STREAMING的stream有效。
请求语法
Plain Text
1GET /v{version}/domain/{playDomain}/app/{app}/stream/{stream}?sourceInfo HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1GET /v5/domain/demo.domain.com/app/demo_app/stream/demo_stream?sourceInfo HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: 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 | 音频实时码率 |
响应示例
Plain Text
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: cde8bf42-8021-46de-8e9c-5cd088bfcee2
4Cache-Control: no-cache
5Server: BWS
6Date: Thu, 04 Feb 2016 03:00:58 GMT
7Content-Type: application/json;charset=UTF-8
8
9{
10 "sessionId" : "p-ga3pk3t3t9wc1h60",
11 "sourceIP" : "10.111.65.220",
12 "score" : 100,
13 "captureTime" : "2016-02-04T03:00:56Z",
14 "inputBitRateInBps" : 5980249,
15 "video" : {
16 "codec" : "H264",
17 "profile" : "High",
18 "level" : "3.1",
19 "widthInPixel" : 1280,
20 "heightInPixel" : 720,
21 "frameRate" : 29.1,
22 "bitRateInBps" : 5828568,
23 "realFPS" : 28.9269
24 },
25 "audio" : {
26 "codec" : "AAC",
27 "profile" : "Main",
28 "sampleRateInHz" : 44100,
29 "channels" : 2,
30 "bitRateInBps" : 151680
31 }
32}域名下实时直播源信息
接口描述
查询域名下所有正在直播推流过程的直播源详细信息，本接口仅对streamingStatus=STREAMING的stream有效。
请求语法
Plain Text
1GET /v{version}/domain/{playDomain}/sourceInfo HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1GET /v5/domain/demo.domain.com/sourceInfo HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: 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 | 音频实时码率 |
响应示例
Plain Text
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: cde8bf42-8021-46de-8e9c-5cd088bfcee2
4Cache-Control: no-cache
5Server: BWS
6Date: Thu, 04 Feb 2016 03:00:58 GMT
7Content-Type: application/json;charset=UTF-8
8
9[
10 {
11 “sessionId” : “p-ga3pk3t3t9wc1h60”,
12 “playDomain”: “play.demo.com”,
13 “app”: “demoapp”,
14 “stream”: “demostream”,
15 “sourceIP” : “10.111.65.220”,
16 “score” : 100,
17 “captureTime” : “2016-02-04T03:00:56Z”,
18 “inputBitRateInBps” : 5980249,
19 “video” : {
20 “codec” : “H264”,
21 “profile” : “High”,
22 “level” : “3.1”,
23 “widthInPixel” : 1280,
24 “heightInPixel” : 720,
25 “frameRate” : 29.1,
26 “bitRateInBps” : 5828568,
27 “realFPS” : 28.9269
28 },
29 “audio” : {
30 “codec” : “AAC”,
31 “profile” : “Main”,
32 “sampleRateInHz” : 44100,
33 “channels” : 2,
34 “bitRateInBps” : 151680
35 }
36 }, ...
37] 查看实时流推流url参数
接口描述
查询某条正在直播推流的推流url参数信息
请求语法
Plain Text
1GET /v{version}/domain/{pushDomain}/app/{app}/stream/{stream}/params HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
无特殊请求头域。
请求参数
N/A
请求示例
Plain Text
1GET /v5/domain/demo.domain.com/app/{app}/stream/{stream}/params HTTP/1.1
2host: lss.bj.baidubce.com
3content-type: application/json
4authorization: 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 | 参数名，值为参数值 |
响应示例
Plain Text
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: cde8bf42-8021-46de-8e9c-5cd088bfcee2
4Cache-Control: no-cache
5Server: BWS
6Date: Thu, 04 Feb 2016 03:00:58 GMT
7Content-Type: application/json;charset=UTF-8
8
9
10{
11 "params" : {
12 "param1": "paramValue1",
13 "param2": "paramValue2"
14 }
15}