Stream接口
所有文档

          音视频直播 LSS

          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
          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”,
              “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
              }
            }, ...
          ]	

          查看实时流推流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"
            }
          }	
          上一篇
          公共头域
          下一篇
          模板接口