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