Tous les produits
Search
Centre de documentation

Object Storage Service:GetLiveChannelStat

Dernière mise à jour :Sep 07, 2026

Interroge l'état d'ingestion de flux d'un LiveChannel donné.

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

DescribeRegions utilise uniquement les en-têtes de requête courants. Pour plus d'informations, consultez En-têtes de requête courants.

É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œuds parents : aucun

Status

Chaîne énumérée

État actuel d'ingestion de flux du LiveChannel.

Nœuds enfants : aucun

Nœuds parents : LiveChannelStat

Valeurs valides : Disabled, Live et Idle

ConnnectedTime

Chaîne

Si Status présente la valeur Live, cet élément indique l'heure à laquelle le client actuel commence à ingérer des flux. La valeur suit le format ISO 8601.

Nœuds enfants : aucun

Nœuds parents : LiveChannelStat

RemoteAddr

Chaîne

Si Status présente la valeur Live, cet élément correspond à l'adresse IP du client qui ingère actuellement des flux.

Nœuds enfants : aucun

Nœuds parents : LiveChannelStat

Video

Conteneur

Ce conteneur stocke les informations du flux vidéo lorsque Status présente la valeur Live.

Remarque

Les conteneurs vidéo et audio ne sont renvoyés que si Status présente la valeur Live. Toutefois, leur retour n'est pas systématique dans ce cas. Par exemple, si le client s'est connecté au LiveChannel sans envoyer de flux audio ou vidéo, ces deux conteneurs ne sont pas renvoyés.

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

Nœuds parents : LiveChannelStat

Width

Chaîne

Largeur du flux vidéo actuel.

Unité : pixels.

Nœuds enfants : aucun

Nœuds parents : Video

Height

Chaîne

Hauteur du flux vidéo actuel.

Unité : pixels.

Nœuds enfants : aucun

Nœuds parents : Video

FrameRate

Chaîne

Fréquence d'images du flux vidéo actuel.

Nœuds enfants : aucun

Nœuds parents : Video

Bandwidth

Chaîne

Débit binaire du flux vidéo actuel.

Unité : bit/s.

Nœuds enfants : aucun

Nœuds parents : Video

Codec

Chaîne énumérée

Format d'encodage du flux vidéo actuel.

Nœuds enfants : aucun

Nœuds parents : Video

Audio

Conteneur

Ce conteneur stocke les informations du flux audio lorsque Status présente la valeur Live.

Remarque

Les conteneurs vidéo et audio ne sont renvoyés que si Status présente la valeur Live. Toutefois, leur retour n'est pas systématique dans ce cas. Par exemple, si le client s'est connecté au LiveChannel sans envoyer de flux audio ou vidéo, ces deux conteneurs ne sont pas renvoyés.

Nœuds enfants : SampleRate, Bandwidth et Codec

Nœuds parents : LiveChannelStat

SampleRate

Chaîne

Fréquence d'échantillonnage du flux audio actuel.

Nœuds enfants : aucun

Nœuds parents : Audio

Bandwidth

Chaîne

Débit binaire du flux audio actuel.

Remarque

Bandwidth représente le débit binaire moyen du flux audio ou vidéo sur la période récente. Lors du passage du LiveChannel à l'état Live, la valeur renvoyée pour Bandwidth peut être 0.

Unité : bit/s.

Nœuds enfants : aucun

Nœuds parents : Audio

Codec

Chaîne énumérée

Format d'encodage du flux audio actuel.

Nœuds enfants : aucun

Nœuds parents : 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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    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>