Tous les produits
Search
Centre de documentation

Object Storage Service:GetLiveChannelStat

Dernière mise à jour :Aug 18, 2026

Récupère le statut d'ingestion de flux d'un LiveChannel spécifié.

Syntaxe de la requête

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

En-têtes de requête

Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.

Éléments de réponse

Élément

Type

Description

LiveChannelStat

Conteneur

Conteneur stockant les résultats renvoyés par la requête GetLiveChannelStat.

Nœuds enfants : Status, ConnectedTime, Video et Audio

Nœud parent : aucun

Status

Chaîne énumérée

Statut actuel d'ingestion de flux du LiveChannel.

Nœuds enfants : aucun

Nœud parent : LiveChannelStat

Valeurs valides : Disabled, Live et Idle

ConnnectedTime

String

Si le statut est Live, cet élément indique l'heure à laquelle le client actuel a commencé à ingérer des flux. La valeur est au format ISO 8601.

Nœuds enfants : aucun

Nœud parent : LiveChannelStat

RemoteAddr

String

Si le statut est Live, cet élément indique l'adresse IP du client actuel qui ingère des flux.

Nœuds enfants : aucun

Nœud parent : LiveChannelStat

Video

Conteneur

Conteneur stockant les informations du flux vidéo si le statut est Live.

Remarque

Les conteneurs vidéo et audio ne sont renvoyés que si le statut est Live. Toutefois, leur présence n'est pas systématique même dans ce cas. Par exemple, si le client est connecté au LiveChannel mais n'envoie aucun flux audio ou vidéo, ces deux conteneurs ne sont pas renvoyés.

Nœuds enfants : Width, Height, FrameRate, Bandwidth et Codec

Nœud parent : LiveChannelStat

Width

String

Largeur du flux vidéo actuel.

Unité : pixels.

Nœuds enfants : aucun

Nœud parent : Video

Height

String

Hauteur du flux vidéo actuel.

Unité : pixels.

Nœuds enfants : aucun

Nœud parent : Video

FrameRate

String

Taux de trames du flux vidéo actuel.

Nœuds enfants : aucun

Nœud parent : Video

Bandwidth

String

Débit binaire du flux vidéo actuel.

Unité : bit/s.

Nœuds enfants : aucun

Nœud parent : Video

Codec

Chaîne énumérée

Format d'encodage du flux vidéo actuel.

Nœuds enfants : aucun

Nœud parent : Video

Audio

Conteneur

Conteneur stockant les informations du flux audio si le statut est Live.

Remarque

Les conteneurs vidéo et audio ne sont renvoyés que si le statut est Live. Toutefois, leur présence n'est pas systématique même dans ce cas. Par exemple, si le client est connecté au LiveChannel mais n'envoie aucun flux audio ou vidéo, ces deux conteneurs ne sont pas renvoyés.

Nœuds enfants : SampleRate, Bandwidth et Codec

Nœud parent : LiveChannelStat

SampleRate

String

Taux d'échantillonnage du flux audio actuel.

Nœuds enfants : aucun

Nœud parent : Audio

Bandwidth

String

Débit binaire du flux audio actuel.

Remarque

L'élément Bandwidth indique le débit binaire moyen du flux audio ou vidéo sur une période récente. Lorsque le LiveChannel passe à l'état Live, la valeur renvoyée pour Bandwidth peut être 0.

Unité : bit/s.

Nœuds enfants : aucun

Nœud parent : Audio

Codec

Chaîne énumérée

Format d'encodage du flux audio actuel.

Nœuds enfants : aucun

Nœud parent : Audio

Exemples

  • Exemple de requête 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****************

    Exemple de réponse 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>
  • Exemple de requête 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****************

    Exemple de réponse 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>