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

请求语法

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

响应元素

名称 类型 描述
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、Heigth、FrameRate、Bandwidth、Codec

父节点：LiveChannelStat
Width 字符串 当前视频流的画面宽度。

单位：像素

子节点：无

父节点：Video
Heigth 字符串 当前视频流的画面高度。

单位：像素

子节点：无

父节点：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
    1
    2
    3
    4
    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
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    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
    1
    2
    3
    4
    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
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    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