Obtains the stream pushing status of a specified LiveChannel.

Request syntax

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

Response element

Element Type Description
LiveChannelStat Container Specifies the container used to store the response to the GetLiveChannelStat request.

Sub-node: Status, ConnectedTime, Video, and Audio

Parent node: None
Status Enumerated string Indicates the current stream pushing status of the LiveChannel.

Sub-node: None

Parent node: LiveChannelStat

Valid value: Disabled, Live, and Idle
ConnnectedTime String If the value of Status is Live, this parameter indicates the time when the current client start to push streams. The value of this parameter is in the ISO8601 format.

Sub-node: None

Parent node: LiveChannelStat
RemoteAddr String If the value of Status is Live, this parameter indicates the IP address of the current client that pushes streams.

Sub-node: None

Parent node: LiveChannelStat
Video Container If the value of Status is Live, this parameter specifies the container that stores the infomration about the video stream.

Sub-node: Width, Heigth, FrameRate, Bandwidth, and Codec

Parent node: LiveChannelStat
Width String Indicates the width (in pixels) of the current video stream.

Sub-node: None

Parent node: Video
Height String Indicates the height (in pixels) of the current video stream

Sub-node: None

Parent node: Video
FrameRate String Indicates the frame rate of the current video stream.

Sub-node: None

Parent node: Video
Bandwidth String Indicates the bit rate (bit/s) of the current video stream.

Sub-node: None

Parent node: Video
Codec Enumerated string Indicates the codec of the current video stream.

Sub-node: None

Parent node: Video
Audio Container If the value of Status is Live, this parameter specifies the container that stores the information about the audio stream.

Sub-node: SampleRate, Bandwidth, and Codec

Parent node: LiveChannelStat
SampleRate String Indicates the sampling rate of the current audio stream.

Sub-node: None

Parent node: Audio
Bandwidth String Indicates the bit rate (bit/s) of the current audio stream.

Sub-node: None

Parent node: Audio
Codec Enumerated string Indicates the codec of the current audio stream.

Sub-node: None

Parent node: Audio

Detail analysis

  • The Video and Audio containers are only returned when the value of Status is Live. However, they may not be returned even if the value of Status is Live. For example, the Video and Audio containers are not returned when the client is connected to the LiveChannel but does not start to send video and audio data.
  • Bandwidth indicates the average bit rate of the video or audio stream in the recent period. The value of Bandwidth may be 0 immediately after the Status of the LiveChannel is switched to Live.

Examples

Request exampe 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:fOzwkAgVTVSO1VKLPIInQ0JYyOA=

Response exmample 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>

Request example 1

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:WeC5joEaRzfSSS8xK0tlo7WTK1I=

Response example 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>