文档

GetLiveChannelStat

更新时间:

GetLiveChannelStat接口用于获取指定LiveChannel的推流状态信息。

请求语法

GET /ChannelName?live&comp=stat HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

响应元素

名称

类型

描述

LiveChannelStat

容器

保存GetLiveChannelStat返回结果的容器。

子节点:Status、ConnectedTime、Video、Audio

父节点:无

Status

枚举字符串

LiveChannel当前的推流状态描述。

子节点:无

父节点:LiveChannelStat

有效值:DisabledLiveIdle

ConnnectedTime

字符串

当Status为Live时,表示当前客户端开始推流的时间。此元素使用ISO8601格式表示。

子节点:无

父节点:LiveChannelStat

RemoteAddr

字符串

当Status为Live时,表示当前推流客户端的IP地址。

子节点:无

父节点:LiveChannelStat

Video

容器

当Status为Live时,保存视频流信息的容器。

说明

Video、Audio容器只有在Status为Live时才会返回,但Status为Live时不一定返回这两个容器。例如,客户端已经连接到LiveChannel,但尚未发送音视频数据,这种情况不会返回这两个容器。

子节点:Width、Height、FrameRate、Bandwidth、Codec

父节点:LiveChannelStat

Width

字符串

当前视频流的画面宽度。

单位:像素

子节点:无

父节点:Video

Height

字符串

当前视频流的画面高度。

单位:像素

子节点:无

父节点:Video

FrameRate

字符串

当前视频流的帧率。

子节点:无

父节点:Video

Bandwidth

字符串

当前视频流的码率。

单位:B/s

子节点:无

父节点:Video

Codec

枚举字符串

当前视频流的编码格式。

子节点:无

父节点:Video

Audio

容器

当Status为Live时,保存音频流信息的容器。

说明

Video、Audio容器只有在Status为Live时才会返回,但Status为Live时不一定返回这两个容器。例如,客户端已经连接到LiveChannel,但尚未发送音视频数据,这种情况不会返回这两个容器。

子节点:SampleRate、Bandwidth、Codec

父节点:LiveChannelStat

SampleRate

字符串

当前音频流的采样率。

子节点:无

父节点:Audio

Bandwidth

字符串

当前音频流的码率。

说明

Bandwidth为音频流/视频流最近一段时间内的平均码率。LiveChannel刚切换到Live状态时,返回的Bandwidth值可能为0。

单位:B/s

子节点:无

父节点:Audio

Codec

枚举字符串

当前音频流的编码格式。

子节点:无

父节点:Audio

示例

  • 请求示例 1

    GET /test-channel?live&comp=stat HTTP/1.1
    Date: Thu, 25 Aug 2016 06:22:01 GMT
    Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
    Authorization: OSS YJjHKOKWDWINLKXv:fOzwkAgVTVSO1VKLPIInQ0JY****

    返回示例 1

    HTTP/1.1 200
    content-length: 100
    server: AliyunOSS
    connection: close
    x-oss-request-id: 57BE8E89B92475920B002164
    date: Thu, 25 Aug 2016 06:22:01 GMT
    content-type: application/xml
    
    <?xml version="1.0" encoding="UTF-8"?>
    <LiveChannelStat>
      <Status>Idle</Status>
    </LiveChannelStat>
  • 请求示例 2

    GET /test-channel?live&comp=stat HTTP/1.1
    Date: Thu, 25 Aug 2016 06:25:26 GMT
    Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
    Authorization: OSS YJjHKOKWDWINLKXv:WeC5joEaRzfSSS8xK0tlo7WT****

    返回示例 2

    HTTP/1.1 200
    content-length: 469
    server: AliyunOSS
    connection: close
    x-oss-request-id: 57BE8F56B92475920B002187
    date: Thu, 25 Aug 2016 06:25:26 GMT
    content-type: application/xml
    
    <?xml version="1.0" encoding="UTF-8"?>
    <LiveChannelStat>
      <Status>Live</Status>
      <ConnectedTime>2016-08-25T06:25:15.000Z</ConnectedTime>
      <RemoteAddr>10.1.2.3:47745</RemoteAddr>
      <Video>
        <Width>1280</Width>
        <Height>536</Height>
        <FrameRate>24</FrameRate>
        <Bandwidth>0</Bandwidth>
        <Codec>H264</Codec>
      </Video>
      <Audio>
        <Bandwidth>0</Bandwidth>
        <SampleRate>44100</SampleRate>
        <Codec>ADPCM</Codec>
      </Audio>
    </LiveChannelStat>

SDK

Java

  • 本页导读 (1)
文档反馈