Todos os produtos
Search
Central de documentação

Object Storage Service:GetLiveChannelStat

Última atualização: Sep 07, 2026

Consulta o status de ingestão de streams de um LiveChannel especificado.

Sintaxe da requisição

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

Cabeçalhos da requisição

O DescribeRegions utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Common request headers.

Elementos da resposta

Elemento

Tipo

Descrição

LiveChannelStat

Container

Container que armazena os resultados da requisição GetLiveChannelStat.

Nós filhos: Status, ConnectedTime, Video e Audio

Nós pais: nenhum

Status

String enumerada

Status atual de ingestão de streams do LiveChannel.

Nós filhos: nenhum

Nós pais: LiveChannelStat

Valores válidos: Disabled, Live e Idle

ConnnectedTime

String

Se o Status for Live, este elemento indica o horário em que o cliente atual iniciou a ingestão de streams. O valor segue o formato ISO 8601.

Nós filhos: nenhum

Nós pais: LiveChannelStat

RemoteAddr

String

Se o Status for Live, este elemento indica o endereço IP do cliente que ingere streams.

Nós filhos: nenhum

Nós pais: LiveChannelStat

Video

Container

Container com informações do stream de vídeo quando o Status é Live.

Nota

Os containers de vídeo e áudio são retornados apenas se o Status for Live. Contudo, mesmo nesse estado, eles podem não ser retornados. Por exemplo, se o cliente estiver conectado ao LiveChannel sem enviar streams de áudio ou vídeo, esses containers não aparecerão na resposta.

Nós filhos: Width, Height, FrameRate, Bandwidth e Codec

Nós pais: LiveChannelStat

Width

String

Largura do stream de vídeo atual.

Unidade: pixels.

Nós filhos: nenhum

Nós pais: Video

Height

String

Altura do stream de vídeo atual.

Unidade: pixels.

Nós filhos: nenhum

Nós pais: Video

FrameRate

String

Taxa de quadros do stream de vídeo atual.

Nós filhos: nenhum

Nós pais: Video

Bandwidth

String

Bitrate do stream de vídeo atual.

Unidade: bit/s.

Nós filhos: nenhum

Nós pais: Video

Codec

String enumerada

Formato de codificação do stream de vídeo atual.

Nós filhos: nenhum

Nós pais: Video

Audio

Container

Container com informações do stream de áudio quando o Status é Live.

Nota

Os containers de vídeo e áudio são retornados apenas se o Status for Live. Contudo, mesmo nesse estado, eles podem não ser retornados. Por exemplo, se o cliente estiver conectado ao LiveChannel sem enviar streams de áudio ou vídeo, esses containers não aparecerão na resposta.

Nós filhos: SampleRate, Bandwidth e Codec

Nós pais: LiveChannelStat

SampleRate

String

Taxa de amostragem do stream de áudio atual.

Nós filhos: nenhum

Nós pais: Audio

Bandwidth

String

Bitrate do stream de áudio atual.

Nota

Bandwidth representa o bitrate médio do stream de áudio ou vídeo no período recente. Quando o LiveChannel muda para o estado Live, o valor retornado para Bandwidth pode ser 0.

Unidade: bit/s.

Nós filhos: nenhum

Nós pais: Audio

Codec

String enumerada

Formato de codificação do stream de áudio atual.

Nós filhos: nenhum

Nós pais: Audio

Exemplos

  • Exemplo de requisição 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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Exemplo de resposta 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>
  • Exemplo de requisição 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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Exemplo de resposta 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>