Partager via

Canal

  • Article

Dans Azure Media Services (AMS), l'entité Channel (canal) représente un pipeline pour le traitement de contenu de diffusion en continu. Un canal reçoit des flux d’entrée en direct de l’une des deux manières suivantes :

  • Un encodeur live local envoie plusieurs débits RTMP ou Smooth Streaming (MP4 fragmenté) au canal. Vous pouvez utiliser les encodeurs live suivants qui produisent un flux Smooth Streaming multidébit : MediaExcel, Imagine Communications, Ateme, Envivio, Cisco et Elemental. Les encodeurs live suivants produisent un flux au format RTMP : Adobe Flash Live Encoder, Haivision, Telestream Wirecast, Teradek et Tricaster. Les flux reçus transitent par les canaux sans traitement supplémentaire. Lorsqu’il y est invité, Media Services fournit le flux aux clients.

  • Un flux à débit binaire unique, dans l'un des formats RTP (MPEG-TS), RTMP ou Smooth Streaming (MP4 fragmenté), est envoyé au Channel activé pour effectuer un codage dynamique avec Media Services. Le Channel encode ensuite de façon dynamique le flux entrant à débit binaire unique en un flux vidéo à plusieurs débits (adaptatif). Lorsqu’il y est invité, Media Services fournit le flux aux clients.

À compter de la version de Media Services 2.10, lorsque vous créez un canal, vous pouvez spécifier la façon dont vous souhaitez qu’il reçoive le flux d’entrée. Vous pouvez également indiquer si vous souhaitez ou non que le canal effectue un encodage en temps réel de votre flux. Deux options s'offrent à vous :

  • None : spécifiez cette valeur si vous prévoyez d'utiliser un encodeur dynamique local qui génère un flux de sortie à plusieurs débits. Le cas échéant, le flux entrant est transmis à la sortie sans encodage. Il s’agit du comportement d’un canal avant la version 2.10. Pour plus d’informations sur l’utilisation de canaux de ce type, consultez Utilisation des canaux qui reçoivent un flux en direct à débit multiple à partir d’encodeurs locaux.

  • Standard – Si vous envisagez d’utiliser Media Services pour encoder votre flux en direct à débit binaire unique en flux à débit multiple, choisissez cette valeur.

    Remarque

    N'oubliez pas qu'il existe un impact sur la facturation pour le codage en direct et que laisser un canal d'encodage en temps réel dans l'état « Actif » occasionne des frais de facturation. Il est recommandé d'arrêter immédiatement vos canaux en cours d'exécution une fois votre événement de diffusion en continu en temps réel terminé pour éviter des frais horaires supplémentaires. Pour plus d’informations, consultez Utilisation de canaux activés pour effectuer un encodage en direct avec Azure Media Services.

Pour plus d’informations sur la diffusion en continu en direct et la gestion des canaux, consultez Diffusion en continu en direct avec Azure Media Services.

Important

Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Cette rubrique offre une vue d'ensemble de l'entité Channel, et montre comment exécuter diverses opérations avec l'API REST Media Services.

Entité Channel

L'entité Channel contient les propriétés suivantes.

Propriété Type Description
Id

Lecture seule. Défini par Media Services.		 Edm.String ID de canal, affecté lors de la création. Le format est le suivant :

nb:chid:UUID:<GUID>.
Name Edm.String Le nom du canal.

1. Doit être unique au sein de votre compte Media Services.
2. Longueur maximale = 32 caractères.
3. Ne peut pas contenir d’espaces.
4. Traits d’union et caractères alphanumériques uniquement.
5. Impossible de commencer ou de se terminer par un trait d’union.
Created

Lecture seule. Défini par Media Services.		 Edm.DateTime Valeur de date/heure UTC qui indique le moment de la création.
Description Edm.String Description fournie par l'utilisateur. La longueur maximale est de 256 caractères.
LastModified

Lecture seule. Défini par Media Services.		 Edm.DateTime La date et l'heure de la dernière mise à jour du canal.
State

Lecture seule. Défini par Media Services.		 Edm.String L'état actuel du canal. Les valeurs possibles incluent :

- Arrêté. C’est l’état initial du canal après sa création. Dans cet état, les propriétés du canal peuvent être mises à jour, mais le streaming n’est pas autorisé.
- Démarrage en cours. Le canal est en cours de démarrage. Aucune mise à jour ni aucun streaming ne sont autorisés durant cet état. Si une erreur se produit, le canal renvoie à l'état Arrêté.
- Exécution en cours. Le canal est capable de traiter des flux dynamiques.
- Arrêt en cours. le canal est en cours d'arrêt. Aucune mise à jour ni aucun streaming ne sont autorisés durant cet état.
- Suppression en cours. Le canal est en cours de suppression. Aucune mise à jour ni aucun streaming ne sont autorisés durant cet état.
Input Type complexe ChannelInput Paramètres d'entrée (ingestion) du canal.
Output Type complexe ChannelOutput Paramètres de sortie du canal.
Preview Type complexe ChannelPreview Paramètres d'aperçu du canal.
CrossSiteAccessPolicies CrossSiteAccessPolicies Stratégies d'accès entre sites.
Programs

Lecture seule. Défini par Media Services.		 Collection de Programs. Référence à la collection de programmes associés au canal.
EncodingType Edm.String Optional. Décrit la configuration du canal. Les valeurs autorisées sont les suivantes :

- None : il s’agit de la valeur par défaut. Lorsque vous sélectionnez cette valeur, le flux entrant est transmis à la sortie sans encodage (il s'agit du comportement d'un canal avant la version 2.10).
- Standard – Le flux entrant à débit unique est envoyé au canal et transcodé en flux à débit multiple à l’aide de présélections système
Encoding Encodage de ComplexType Paramètres de l'encodeur dynamique Azure.
Slate Tablette Ce paramètre est pris en charge uniquement lorsque le Encoding Type du canal est défini sur Standard.

L’encodeur dynamique dans le canal peut être informé de basculer vers une image d’ardoise. Il peut également être informé de mettre fin à une ardoise en cours.

L'encodeur dynamique peut être configuré pour basculer vers une image d'ardoise et masquer le signal vidéo entrant dans certaines situations, par exemple, pendant une pause publicitaire. Si une telle ardoise n’est pas configurée, la vidéo d’entrée n’est pas masquée pendant cette annonce publicitaire.

Type complexe ChannelInput

Nom Type Description
KeyFrameInterval Edm.Time Cette valeur est ignorée si EncoderType est défini sur Standard.

Lors de l’utilisation d’un encodeur live local pour générer un flux à débit multiple, l’intervalle de trame clé spécifie la durée goP (telle qu’utilisée par cet encodeur externe). Une fois ce flux entrant reçu par le canal, vous pouvez distribuer votre flux live aux applications de lecture clientes dans un des formats suivants : Smooth Streaming, DASH et HLS. Lors de la diffusion en continu, TLS est toujours empaquetée de façon dynamique. Par défaut, Media Services calcule automatiquement le coefficient d'empaquetage de segment (fragments par segment) HLS en fonction de l'intervalle entre les images clés, également appelé groupe d'images (GOP), reçu de l'encodeur dynamique.
StreamingProtocol

Lecture seule.		 Edm.String Après avoir défini le type d'encodeur, vous pouvez définir un protocole d'ingestion.

Si est Encoder Type défini sur None, les options valides sont les suivantes :

- MP4 fragmenté à débit multiple (smooth streaming)
- RTMP à débit binaire multiple

Lorsque votre Encoder Type est défini sur None, il est valide, mais non souhaitable, qu’un flux en direct RTMP ou Smooth Streaming à débit unique soit envoyé. Le canal n'appliquant aucun traitement au flux, celui-ci passe, mais les applications clientes reçoivent un flux à débit binaire unique.

Si est Encoder Type défini sur Standard, les options valides sont les suivantes :

1. Mp4 fragmenté à débit unique (Smooth Streaming)
2. RTMP à débit binaire unique
3. RTP (MPEG-TS) : flux de transport MPEG-2 sur RTP.
AccessControl Type complexe ChannelInputAccessControl Paramètres de contrôle d'accès d'entrée du canal.
Endpoints

Lecture seule.		 Type complexe ChannelEndpoint Points de terminaison d'entrée du canal.

Un canal fournit des points de terminaison d'entrée (URL d'ingestion) que vous utilisez pour ingérer votre flux dynamique. Le canal reçoit des flux d'entrée dynamiques, et rend les flux de sortie disponibles pour la diffusion en continu via un ou plusieurs points de terminaison de diffusion en continu.

Type complexe ChannelPreview

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
AccessControl Type complexe ChannelPreviewAccessControl Paramètres de contrôle d'accès d'aperçu du canal.
Endpoints

Lecture seule.		 Type complexe ChannelEndpoint Points de terminaison d'aperçu du canal.

Type complexe ChannelInputAccessControl

Nom Type Description
IP IPAccessControl Adresses IP autorisées à se connecter aux points de terminaison d'entrée du canal.
Les adresses IP doivent être dans l’un des formats suivants : Adresse IpV4 avec 4 numéros, plage d’adresses CIDR.

Type complexe ChannelPreviewAccessControl

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
IP IPAccessControl Adresses IP autorisées à se connecter aux points de terminaison d'entrée du canal.
Les adresses IP doivent être dans l’un des formats suivants : Adresse IpV4 avec 4 nombres, plage d’adresses CIDR

IPAccessControl

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
Autoriser Type complexe IPRange Adresses IP autorisées à se connecter aux points de terminaison d'entrée du canal. Note: La définition de cette valeur sur null permet à toutes les adresses IP sources de se connecter. En la définissant sur une chaîne vide (“”), vous interdisez toute connexion.

Type complexe IPRange

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
Name Edm.String Nom convivial pour cette plage d'adresses IP.
Address Edm.String Adresse IP de base pour la représentation du sous-réseau (par exemple :192.168.0.1).
SubnetPrefixLength Edm.Int32 Nombre de bits significatifs pour le masque de sous-réseau (par exemple, dans l'adresse IP 192.168.0.1/24, 24 représente le nombre de bits significatifs).

Type complexe ChannelEndpoint

Nom Type Description
Protocol Edm.String Le protocole de point de terminaison de diffusion en continu du canal.
Url Edm.String L'URL du point de terminaison de diffusion en continu du canal.

Type complexe ChannelOutput

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct

Nom Type Description
Hls Type complexe ChannelOutputHls Paramètres spécifiques à HLS.

Type complexe ChannelOutputHls

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
FragmentsPerSegment Edm.Int16 La quantité de fragments par segment HLS (HTTP Live Streaming).

ComplexType d’encodage

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
AdMarkerSource Edm.String Vous pouvez spécifier la source des signaux des marqueurs de publicité. La valeur par défaut est Api, ce qui indique que l’encodeur dynamique au sein du canal doit écouter un élément asynchrone Ad Marker API. L’autre option valide est Scte35 (autorisée uniquement si le protocole de streaming d’ingestion est défini sur RTP (MPEG-TS). Quand Scte35 est spécifié, l’encodeur analyse les SCTE-35 signaux du flux RTP d’entrée (MPEG-TS).
IgnoreCea708ClosedCaptions Edm.bool Optional. Indicateur facultatif qui spécifie à l’encodeur dynamique d’ignorer les données des sous-titres CEA-708 intégrées à la vidéo entrante. Lorsque l’indicateur est défini sur false (par défaut), l’encodeur détecte et réinsère les données CEA-708 dans les flux vidéo de sortie.
VideoStream VideoStream Optional. Décrit le flux vidéo d’entrée. Si ce champ n’est pas spécifié, la valeur par défaut est utilisée. Ce paramètre est autorisé uniquement si le protocole de diffusion en continu d’entrée est défini sur RTP (MPEG-TS).
AudioStreams AudioStreams Optional. Décrit les flux audio d’entrée. Si ce champ n’est pas spécifié, les valeurs par défaut spécifiées s’appliquent. Ce paramètre est autorisé uniquement si le protocole de diffusion en continu d’entrée est défini sur RTP (MPEG-TS).
SystemPreset Edm.String Spécifie l'encodeur prédéfini à utiliser pour ce canal. La seule valeur actuellement autorisée est Default720p (par défaut).

Pour plus d’informations, consultez SystemPreset

SystemPreset

Default720p spécifie d’encoder la vidéo dans les 6 couches suivantes.

Débit binaire Largeur Hauteur IPS max. Profil Nom du flux de sortie
3 500 1 280 720 30 Élevé Video_1280x720_3500kbps
2 200 960 540 30 Élevé Video_960x540_2200kbps
1 350 704 396 30 Élevé Video_704x396_1350kbps
850 512 288 30 Élevé Video_512x288_850kbps
550 384 216 30 Élevé Video_384x216_550kbps
200 340 192 30 Élevé Video_340x192_200kbps

Le flux audio est encodé au format stéréo AAC-LC à 64 Kbits/s, avec un taux d’échantillonnage de 44,1 kHz.

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

VideoStream

Décrit le flux vidéo d’entrée. Si ce champ n’est pas spécifié, la valeur par défaut est utilisée. Ce paramètre est autorisé uniquement si le protocole de diffusion en continu d’entrée est défini sur RTP (MPEG-TS).

Nom Type Description
Index Edm.Int1 Index de base zéro qui précise le flux vidéo d’entrée qui doit être traité par l’encodeur dynamique dans le canal. Ce paramètre s’applique uniquement si le protocole de diffusion en continu de réception est défini sur RTP (MPEG-TS).

La valeur par défaut est zéro. L’envoi dans un flux SPTS est recommandé. Si le flux d’entrée contient plusieurs programmes, l’encodeur dynamique analyse la table de mappage de programmes (PMT) dans l’entrée, identifie les entrées dont le nom de type de flux est Vidéo MPEG-2 ou H.264, puis les réorganise en suivant l’ordre spécifié dans la table PMT. L’index de base zéro permet ensuite de choisir la nième entrée dans cette disposition.
Name Edm.String Optional. Balise descriptive pour ce flux vidéo d’entrée.

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

AudioStreams

Décrit les flux audio d’entrée. Si ce champ n’est pas spécifié, les valeurs par défaut spécifiées s’appliquent. Ce paramètre est autorisé uniquement si le protocole de diffusion en continu d’entrée est défini sur RTP (MPEG-TS).

Nom Type Description
Index Edm.Int16 L’envoi dans un flux SPTS est recommandé. Si le flux d’entrée contient plusieurs programmes, l’encodeur dynamique au sein du canal analyse la table de mappage de programmes (PMT) dans l’entrée, identifie les entrées dont le nom de type de flux est Audio MPEG-2 AAC ADTS, AC-3 System-A, AC-3 System-B, MPEG-2 Private PES, MPEG-1 ou MPEG-2, puis les réorganise en suivant l’ordre spécifié dans la table PMT. L’index de base zéro permet ensuite de choisir la nième entrée dans cette disposition.
Name Edm.String Optional. Balise descriptive pour ce flux audio d’entrée.
Language Edm.String Optional. Identificateur de langue du flux audio, conformément à la norme ISO 639-2, par exemple ENG. En son absence, la valeur par défaut est UND (non définie).

Jusqu’à 8 jeux de flux audio peuvent être spécifiés si l’entrée du canal est définie sur MPEG-2 TS via RTP. Toutefois, deux entrées ne peuvent pas posséder la même valeur d’index.

Il peut y avoir jusqu'à 8 jeux {Index, Nom, Langue} spécifiés si l'entrée vers l'encodeur est MPEG-2 TS sur RTP. Toutefois, deux entrées ne peuvent pas posséder la même valeur d’index. Si l'entrée dans l'encodeur est de type RTMP ou HTTP (diffusion en continu lisse), il ne peut y avoir qu'un seul flux audio entrant.

Tablette

Ce paramètre est pris en charge uniquement lorsque le Encoding Type du canal est défini sur Standard.

L’encodeur dynamique dans le canal peut être informé de basculer vers une image d’ardoise. Il peut également être informé de mettre fin à une ardoise en cours.

L'encodeur dynamique peut être configuré pour basculer vers une image d'ardoise et masquer le signal vidéo entrant dans certaines situations, par exemple, pendant une pause publicitaire. Si une telle ardoise n’est pas configurée, la vidéo d’entrée n’est pas masquée pendant cette annonce publicitaire.

Nom Type Description
InsertSlateOnAdMarker Edm.Bool Lorsque sa valeur est définie sur True, ce paramètre configure l'encodeur dynamique pour insérer une image d'ardoise pendant une pause publicitaire. La valeur par défaut est true.
DefaultSlateAssetId Edm.String Optional. Spécifie l’ID de ressource de la ressource Media Services qui contient l’image d’ardoise. La valeur par défaut est Null.

Avant de créer le canal, l'image d'ardoise, d'une résolution maximale de 1920 x 1080 pixels au format JPEG, et d'une taille maximale de 3 Mo, doit être chargée en tant qu'élément multimédia dédié (aucun autre fichier ne doit figurer dans cet élément multimédia). Le nom de fichier doit avoir une extension *.jpg, et cet AssetFile doit être marqué comme fichier principal pour cet élément multimédia. Cette ressource ne peut pas être chiffrée par le stockage.

Si l’ID de ressource d’ardoise par défaut n’est pas spécifié et que l’insertion d’ardoise dans le marqueur publicitaire a la valeur true, une image Azure Media Services par défaut est utilisée pour masquer le flux d’entrée.

Pour plus d’informations sur ce type et ses propriétés, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Créer des canaux

Les canaux peuvent être créés à l'aide d'une requête HTTP POST et en spécifiant des valeurs de propriétés.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels> HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Le corps de la requête suivant montre comment créer un canal activé pour l’encodage en direct.

{  
   "Id":null,  
   "Name":"testchannel001",     
   "Description":"",  
   "EncoderType":"Standard",  
   "Created":"0001-01-01T00:00:00",  
   "LastModified":"0001-01-01T00:00:00",  
   "State":null,  
   "Input":  
   {  
      "StreamingProtocol":"RTPMPEG2TS",  
      "AccessControl":  
      {  
         "IP":  
         {  
         "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   },  
   "Encoding":  
   {  
      "SystemPreset":"Default720p",  
      "IgnoreCea708ClosedCaptions": false,  
      "AdMarkerSource": "Api",
      "VideoStream":  
      {  
         "Index":1,  
         "Name":"Video stream"  
      },  
      "AudioStreams":  
      [  
         {  
            "Index":0,  
            "Name":"English audio stream",  
            "Language":"ENG"  
         },  
         {  
            "Index":1,  
            "Name":"Spanish audio stream",  
            "Language":"SPA"  
         }  
      ]  
   },  
   "EncodingType": "Standard",  
   "Slate":  
   {  
      "InsertOnAdMarker":true,  
      "DefaultSlateAssetId": "nb:cid:UUID:01234567-0123-0123-0123-01234567"  
   },  
   "Preview":  
   {  
      "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   }  
}

Le corps de la requête suivant montre comment créer un canal dans le compte qui n’est pas activé pour l’encodage en direct.

{  
"Id":null,  
"Name":"testchannel001",  
"Description":"",  
"Created":"0001-01-01T00:00:00",  
"LastModified":"0001-01-01T00:00:00",  
"State":null,  
"Input":  
   {  
   "KeyFrameInterval":null,  
   "StreamingProtocol":"FragmentedMP4",  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
   "Endpoints":[]  
   },  
"Preview":  
   {  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
      "Endpoints":[]  
   },  
"Output":  
   {  
   "Hls":  
      {  
         "FragmentsPerSegment":1  
      }  
   },  
"CrossSiteAccessPolicies":  
   {  
      "ClientAccessPolicy":null,  
      "CrossDomainPolicy":null  
   }  
}

En cas de succès, un code d'état 202 Accepté est renvoyé avec une représentation de l'entité créée dans le corps de la réponse.

Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un canal. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.

Démarrer des canaux

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Start HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Start HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un canal. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.

Arrêter des canaux

Un canal peut être arrêté seulement quand il est dans l'état En cours d'exécution et que tous les programmes sur le canal ont été arrêtés.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Stop HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Stop HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un canal. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.

Répertorier les canaux

Les canaux peuvent être récupérés à l'aide d'une requête HTTP GET.

Méthode URI de demande Version HTTP
GET Obtenir tous les canaux :

<https:// accountname.restv2>.<location.media.azure.net/api/Channels>

Obtenir un canal spécifié.

<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')		 HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

GET https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Si elle réussit, cette opération renvoie un code de status 200 OK et une liste de tous les canaux créés dans votre compte Media Services.

Réinitialiser les canaux

Réinitialise l'état d'un canal d'exécution maintenu via le flux de diffusion d'une présentation dynamique et permet la réutilisation d'un canal dans le cas de réinitialisations de la présentation ou de la reconfiguration de l'encodeur. Arrêtez tous les programmes avant d'appeler la réinitialisation. La réinitialisation peut être appelée sur un canal qui est dans l'état En cours d'exécution.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/Reset HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Reset HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un canal. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations de Long-Running.

Mettre à jour les canaux

Met à jour des propriétés sur un canal existant. Le canal doit être dans l'état Arrêté.

Méthode URI de demande Version HTTP
PATCH/PUT/MERGE

Pour plus d’informations sur ces opérations, consultez PATCH/PUT/MERGE.		 <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid') HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

PATCH https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Corps de la requête :

"Encoding":{"IgnoreCea708ClosedCaptions": true}

Si la mise à jour s'effectue de manière synchrone, elle renvoie le code d'état 204 Pas de contenu. Autrement, elle renvoie le code d'état 202 Accepté. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un canal. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations de Long-Running.

Démarrer la publication

L’encodeur dynamique peut être signalé pour démarrer une publication ou une interruption commerciale à l’aide d’une requête HTTP POST et en spécifiant les valeurs de propriété de dans l’entité StartAdvertisement Entity dans le corps de la requête.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/StartAdvertisement HTTP/1.1

Pour plus d’informations, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Entité StartAdvertisement

Cette entité représente l'API de démarrage d'annonce : il s'agit d'un appel asynchrone à l'encodeur dynamique pour insérer une annonce ou une pause publicitaire dans le flux de sortie.

Pour plus d’informations, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
duration Edm.Duration Durée (en secondes) de la pause publicitaire. Pour que la pause publicitaire commence, ce doit être une valeur positive différente de zéro. Si une pause publicitaire est en cours et que la durée est définie sur zéro avec la propriété ID de file d’attente correspondant à la pause publicitaire en cours, alors cette pause est annulée.
cueId Edm.Int ID unique de la pause publicitaire que l'application en aval doit utiliser pour prendre les mesures nécessaires. Ce doit être un entier positif.
showSlate Edm.Bool Optional. Indique à l'encodeur dynamique à l'intérieur du canal qu'il doit basculer vers l'image d'ardoise par défaut pendant la pause publicitaire (et masquer le flux vidéo entrant). La valeur par défaut est false.

L’image utilisée est celle spécifiée via la propriété d’ID de ressource d’ardoise par défaut au moment de la création du canal.

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/StartAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Corps

{  
   "duration":"PT45S",  
   "cueId":"67520935",  
   "showSlate":"true"  
}

En cas de succès, un code d'état 202 Accepté est renvoyé.

Fin de la publication

L'encodeur dynamique peut recevoir un signal lui indiquant de mettre fin à une annonce ou à une pause publicitaire en cours via une requête HTTP POST.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/EndAdvertisement HTTP/1.1

Cet appel ne doit être effectué que si une annonce est en cours.

Pour plus d’informations, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/EndAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

En cas de succès, un code d'état 202 Accepté est renvoyé.

Afficher l’ardoise

Indique à l'encodeur dynamique à l'intérieur du canal qu'il doit basculer vers l'image d'ardoise par défaut pendant la pause publicitaire (et masquer le flux vidéo entrant). La valeur par défaut est false. L’image utilisée est celle spécifiée via la propriété d’ID de ressource d’ardoise par défaut au moment de la création du canal.

Utilisez les propriétés de ShowSlate Entity dans le corps de la requête HTTP.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channeled')/ShowSlate HTTP/1.1

Pour plus d’informations, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Entité ShowSlate

Pour plus d’informations, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Nom Type Description
duration Edm.Duration Durée d'affichage de l'ardoise, exprimée en secondes. Pour que l’affichage de l’ardoise commence, ce doit être une valeur positive différente de zéro. Si une ardoise est affichée alors qu'une durée égale à zéro est spécifiée, l'affichage de l'ardoise cesse.
assetId Edm.String Spécifie l’ID de ressource de la ressource Media Services qui contient l’image d’ardoise.

Avant de créer le canal, l'image d'ardoise, d'une résolution de 1920 x 1080 pixels au format JPEG, et d'une taille maximale de 3 Mo, doit être chargée en tant qu'élément multimédia dédié (aucun autre fichier ne doit figurer dans cet élément multimédia).

L'encodeur peut recevoir un signal lui indiquant de basculer vers une image d'ardoise arbitraire (pas uniquement celle spécifiée via la propriété DefaultSlateAssetId au moment de la création du canal).

Si la propriété DefaultSlateAssetId est spécifiée, et si AssetId n'est pas spécifié, l'image DefaultSlateAssetId est utilisée pour masquer le flux d'entrée. Pour plus d’informations, consultez Slate.

Exemple de demande

Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/ShowSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Corps

{  
   "duration":"PT45S",  
   "assetId":"nb:cid:UUID:01234567-ABCD-ABCD-EFEF-01234567"  
}

En cas de succès, un code d'état 202 Accepté est renvoyé.

Masquer l’ardoise

L'encodeur dynamique peut recevoir un signal lui indiquant de mettre fin à l'affichage d'une ardoise via une requête HTTP POST.

Méthode URI de demande Version HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/HideSlate HTTP/1.1

Cet appel ne doit être effectué que si une ardoise est en cours d'affichage.

Pour plus d’informations, consultez Vue d’ensemble des canaux activés pour l’encodage en direct.

Exemple de demande

Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/HideSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un canal. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.

Supprimer des canaux

Supprimer un canal.

Méthode URI de demande Version HTTP
Suppression <https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid') HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

DELETE https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

En cas de succès, un code d'état 202 Accepté est renvoyé. Le code d'état 202 Accepté indique une opération asynchrone, auquel cas la valeur d'en-tête de l'ID d'opération est également fournie pour être utilisée dans l'interrogation et le suivi de l'état des opérations de longue durée, comme le démarrage ou l'arrêt d'un canal. Transmettez la valeur de l'en-tête d'ID d'opération dans l'entité Operation pour récupérer l'état. Pour plus d’informations, consultez Interrogation manuelle des opérations Long-Running.

Voir aussi

Diffusion vidéo en flux continu avec Azure Media Services
Programme