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>