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