Intelligent Media Services:Live packaging

Fonctionnement

MediaPackage organise les ressources de Live packaging sur trois niveaux :

• Channel group – Conteneur de niveau supérieur pour les canaux et les endpoints. Chaque channel group reçoit un Origin Domain Name qui sert d'URL de base pour toutes les demandes de lecture au sein du groupe.

• Channel – Point d'entrée d'un flux en direct. Un encodeur amont pousse le contenu vers les URL d'entrée d'un canal. Chaque canal fournit deux URL d'entrée pour une ingestion redondante. Si l'une des entrées cesse d'envoyer du contenu, MediaPackage bascule automatiquement vers l'autre, garantissant ainsi une diffusion continue.

• Endpoint – Configuration de sortie d'un canal. Chaque endpoint définit le format de streaming, les paramètres d'empaquetage et les contrôles d'accès pour le flux de sortie. Un seul canal peut comporter plusieurs endpoints, chacun générant une URL de lecture unique.

Le contenu circule à travers ces ressources comme suit :

1. Un encodeur amont pousse un flux en direct vers les URL d'entrée d'un canal.

2. Un appareil aval (lecteur ou CDN) demande du contenu via l'URL de lecture d'un endpoint.

3. MediaPackage empaquette dynamiquement le flux selon le format défini par cet endpoint.

4. MediaPackage diffuse le flux empaqueté à l'appareil demandeur.

Entrées et sorties prises en charge

Facturation

• Le Live packaging facture l'ingestion des flux, l'empaquetage et la diffusion des sorties. Pour plus de détails, consultez la rubrique Facturation du Live packaging.

• L'archivage du contenu en direct vers OSS via Live-to-VOD entraîne des frais de stockage OSS. Consultez la rubrique Frais de stockage d'OSS.

Créer un channel group

1. Connectez-vous à la console Intelligent Media Services.

2. Dans le coin supérieur gauche, sélectionnez une région.

3. Dans le volet de navigation de gauche, choisissez MediaPackage > Live Package.

4. Cliquez sur Create Channel Group.

5. Saisissez un nom unique et une description facultative pour le channel group.

   

6. Cliquez sur OK.

Créer un canal

Un canal reçoit un flux en direct depuis un encodeur amont. Chaque canal fournit deux URL d'entrée pour la redondance : si l'une des entrées cesse d'envoyer du contenu, MediaPackage bascule automatiquement vers l'autre.

1. Sur la page Live Package, cliquez sur le nom du channel group.

2. Cliquez sur Create Channel.

3. Configurez les paramètres suivants :

   Paramètre	Description
   Channel Name	Nom unique du canal.
   Protocol	Protocole d'entrée. Valeurs valides : HLS, HLS_CMAF.
   Segment Duration	Durée de chaque segment en secondes. Des segments plus longs augmentent la latence ; des segments plus courts augmentent la surcharge des requêtes. Valeur recommandée : 6 secondes.
   Segments	Nombre de segments dans le manifeste de sortie. Un nombre plus élevé étend la timeline du lecteur et augmente le trafic. Valeur recommandée : 3.

   

4. Cliquez sur OK.

Créer un endpoint

Un endpoint définit le format de sortie et les contrôles d'accès d'un canal. Chaque endpoint génère une URL de lecture unique.

1. Cliquez sur le nom du canal pour ouvrir la page des détails du canal.

2. Cliquez sur l'onglet Endpoints, puis cliquez sur Create Endpoint.

3. Configurez les informations de base :

   Paramètre	Description
   Endpoint Name	Nom unique de l'endpoint.
   Protocol	Format de sortie. Valeurs valides : HLS, HLS_CMAF, DASH.
   Manifest Name	Nom du fichier du manifeste. Par défaut : manifest. Par exemple, définir cette valeur sur index avec le protocole HLS produit une URL de lecture se terminant par index.m3u8.
   Authorization Code	Code d'autorisation que les lecteurs ou les CDN doivent inclure dans l'en-tête HTTP Authorization lors de la demande de contenu depuis cet endpoint.
   IP Address Whitelist	Adresses IPv4/IPv6 ou blocs CIDR autorisés à accéder à cet endpoint.
   IP Address Blacklist	Adresses IPv4/IPv6 ou blocs CIDR dont l'accès à cet endpoint est refusé.
   Time-shifted Days	Nombre de jours de conservation du contenu en direct pour la visualisation décalée dans le temps. Définissez cette valeur sur 0 pour désactiver le décalage temporel. Ce paramètre est une condition préalable à la création de tâches de collecte Live-to-VOD. Pour plus de détails sur la lecture décalée dans le temps, consultez la section Visualisation décalée dans le temps.

   

4. Configurez les Segment Settings en fonction du protocole sélectionné :

   HLS

   

   Paramètre	Description
   Segment Duration	Durée de chaque segment de sortie en secondes. Valeurs valides : 1 à 30.
   Audio Separation	Lorsque cette option est activée, les pistes audio sont empaquetées dans des segments séparés de la vidéo.

   HLS_CMAF & DASH

   

   Paramètre	Description
   Segment Duration	Durée de chaque segment de sortie en secondes. Valeurs valides : 1 à 30.
   DRM Encryption	Active le chiffrement DRM. Disponible uniquement pour les protocoles HLS_CMAF et DASH.
   Encryption Method	Méthode de chiffrement. Par défaut : SAMPLE_AES.
   Constant Initialization Vector	Valeur hexadécimale de 16 octets (chaîne de 32 caractères). Si ce champ est laissé vide, MediaPackage en génère une automatiquement.
   DRM System ID	Systèmes DRM à utiliser. Sélectionnez jusqu'à 3 systèmes pour HLS_CMAF ou jusqu'à 2 pour DASH. Systèmes pris en charge : HLS_CMAF : Apple FairPlay, Google Widevine, Microsoft PlayReady. DASH : Google Widevine, Microsoft PlayReady.
   DRM Provider URL	URL du proxy pour la communication avec le serveur de clés. Longueur maximale : 512 caractères.
   Content ID	Identifiant unique de l'endpoint. Si ce champ est laissé vide, MediaPackage en génère un automatiquement.

5. Configurez les paramètres du manifeste :

   HLS & HLS_CMAF

   

   Paramètre	Description
   Segments	Nombre de segments dans la liste de lecture M3U8 de sortie. Valeurs valides : 2 à 100.
   Program Date/Time Interval	Intervalle en secondes pour l'insertion des balises EXT-X-PROGRAM-DATE-TIME. Par défaut, aucune balise n'est insérée.
   Stream Order	Ordre des flux dans le manifeste. Valeurs valides : Original : Trie les flux de sortie dans le même ordre que celui utilisé par la source. Ascending by Bitrate : Trie les flux de sortie en commençant par le débit le plus faible. Descending by Bitrate : Trie les flux de sortie en commençant par le débit le plus élevé.
   Min Video Bitrate	Exclut du manifeste de sortie les flux dont le débit est inférieur à cette valeur.
   Max Video Bitrate	Exclut du manifeste de sortie les flux dont le débit est supérieur à cette valeur.

   DASH

   

   Paramètre	Description
   Min Buffer Time	Temps de tampon minimal en secondes que le lecteur doit maintenir. Par défaut : 2 x durée du segment. Valeurs valides : 1 à 30.
   Min Update Period	Intervalle minimal en secondes avant que le lecteur ne demande des mises à jour du manifeste. Par défaut : 2 x durée du segment. Valeurs valides : 1 à 3600.
   Suggested Presentation Delay	Délai en secondes entre le point en direct et le début de la lecture. Par exemple, un délai de 35 secondes signifie que les requêtes effectuées à 17 h 30 reçoivent le contenu de 17 h 29 min 25 s.
   Manifest Window	Durée en secondes du contenu disponible pour la relecture pendant la diffusion en direct. Valeurs valides : 1 à 3600.
   Stream Order	Ordre des flux dans le manifeste. Valeurs valides : Original : Trie les flux de sortie dans le même ordre que celui utilisé par la source. Ascending by Bitrate : Trie les flux de sortie en commençant par le débit le plus faible. Descending by Bitrate : Trie les flux de sortie en commençant par le débit le plus élevé.
   Min Video Bitrate	Exclut du manifeste de sortie les flux dont le débit est inférieur à cette valeur.
   Max Video Bitrate	Exclut du manifeste de sortie les flux dont le débit est supérieur à cette valeur.

6. Cliquez sur OK.

Une fois l'endpoint créé, l'URL de lecture apparaît dans la colonne URL de l'onglet Endpoints.

Ingestion de flux

Après avoir créé un canal, deux URL d'entrée sont générées pour une ingestion redondante.

Lecture de flux

Utilisez l'URL de lecture de l'endpoint pour lire le flux empaqueté.

Pour le débogage :

• Ajoutez votre adresse IP à la liste d'autorisation d'adresses IP de l'endpoint, ou

• Incluez le code d'autorisation de l'endpoint dans l'en-tête Authorization

Pour la production :

Configurez votre CDN pour inclure l'en-tête Authorization dans les requêtes vers l'origine. Si vous utilisez Alibaba Cloud CDN, consultez la rubrique Configurer les en-têtes de requête sortants.

Visualisation décalée dans le temps

Lorsque la visualisation décalée dans le temps est activée sur un endpoint, MediaPackage conserve le contenu en direct pendant le nombre de jours spécifié. Les lecteurs peuvent revoir le contenu passé en ajoutant des paramètres de temps à l'URL de lecture.

Exemple :

https://xxxxx-1.packagepush-9eji12.ap-southeast-1.ice.aliyundoc.com/v1/group01/ch01/endpoint01/index.m3u8?start=2024-11-06T00:00:00Z&vodend=2024-11-06T02:00:00Z

Cet exemple permet de revoir le contenu en direct du 2024-11-06T00:00:00Z au 2024-11-06T02:00:00Z. Une requête de visualisation décalée dans le temps correspond à l'URL du manifeste M3U8 ordinaire de l'endpoint, à laquelle sont ajoutés deux paramètres de requête : start définit l'heure de début du décalage temporel et vodend définit l'heure de fin du décalage temporel.

Live-to-VOD

MediaPackage peut archiver les segments d'un flux en direct vers OSS pour une lecture à la demande en utilisant des tâches de collecte.

FAQ