全部產品
Search
文件中心

:GetLiveChannelStat

更新時間:Jun 19, 2024

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