音视频直播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
        }
      }, ...
    ]	
    上一篇
    公共头域
    下一篇
    模板接口