调用GetLiveChannelStat获取指定LiveChannel的推流状态

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 有效值：Disabled、Live、Idle
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 qn6q**************:77Dv****************

返回示例 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 qn6q**************:77Dv****************

返回示例 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