Get started with ApsaraVideo Live - ApsaraVideo Live - Centre de documentation Alibaba Cloud

Concepts clés

Avant de commencer, familiarisez-vous avec les concepts clés d'ApsaraVideo Live :

Avant de commencer

Avant de débuter, créez un compte et approvisionnez-le selon les instructions fournies. Pour plus d'informations, consultez la rubrique Activation et achat d'ApsaraVideo Live.

Préparation du compte

Si vous ne disposez pas encore de compte Alibaba Cloud, suivez les instructions affichées sur la page d'inscription pour en créer un. Un compte Alibaba Cloud, qui sert d'entité facturante pour vos ressources cloud, est requis pour ce tutoriel.
Ce service prend en charge deux méthodes de facturation : paiement à l'utilisation et forfait de ressources.
- Pour un essai rapide, nous recommandons la méthode de facturation paiement à l'utilisation. Si votre trafic de test ne dépasse pas 10 Go, le coût estimé est d'environ 0,42 USD.
  
  Remarque
  Cette estimation n'inclut pas les frais liés à l'enregistrement de domaine, aux certificats SSL ou au dépôt ICP. Le coût final peut varier en fonction de facteurs tels que la région et la méthode de facturation. Les prix affichés dans la console et la facture finale font foi.
- Avant d'utiliser ce service, assurez-vous que votre compte dispose d'un solde suffisant .

Présentation du flux de travail

Ajout des domaines d'ingestion et de diffusion : ApsaraVideo Live est un service basé sur les domaines. À cette étape, préparez vos domaines et configurez-les dans la console ApsaraVideo Live.
Configuration d'un enregistrement CNAME pour activer l'accélération de la diffusion en direct : À cette étape, associez votre domaine personnalisé à un nom de domaine accéléré attribué par Alibaba Cloud afin de bénéficier d'un service ApsaraVideo Live rapide et stable.
Association des domaines d'ingestion et de diffusion : La diffusion en direct utilise généralement deux domaines distincts. À cette étape, associez votre domaine d'ingestion à votre domaine de diffusion.
Génération des URL d'ingestion et de diffusion : À cette étape, utilisez le générateur d'URL pour créer les URL d'ingestion et de diffusion à partir de vos domaines configurés.
Ingestion et lecture d'un flux : Cette étape vous montre comment ingérer un flux avec l'application de démonstration ApsaraVideo Live et le lire avec le lecteur multimédia VLC.

Étape 1 : Ajout des domaines d'ingestion et de diffusion

Avant de pouvoir utiliser ApsaraVideo Live, vous avez besoin d'au moins un nom de domaine. Le domaine d'ingestion et le domaine de diffusion ne peuvent pas être identiques, mais ils peuvent correspondre à deux sous-domaines différents du même domaine racine.

Par exemple, si votre domaine racine est test.com, vous pouvez configurer deux sous-domaines, a.test.com et b.test.com, pour les utiliser respectivement comme domaine d'ingestion et domaine de diffusion.

Préparez vos noms de domaine.
- Si vous ne possédez pas de nom de domaine, vous pouvez en enregistrer un sur la plateforme Alibaba Cloud Domains. Pour plus d'informations, consultez la rubrique Enregistrement d'un nom de domaine sur Alibaba Cloud.
- Après avoir enregistré un nom de domaine, vous devrez peut-être effectuer un dépôt ICP selon votre utilisation. Pour plus d'informations, consultez la rubrique Procédure de dépôt ICP.
  Remarque
  - Pour tester rapidement les fonctionnalités de base d'ApsaraVideo Live, sélectionnez une région de centre de diffusion en direct située en dehors de la Chine continentale et définissez la région d'accélération sur Outside Chinese Mainland. Dans ce cas, aucun dépôt ICP n'est requis pour votre nom de domaine.
  - Si le domaine d'ingestion et le domaine de diffusion sont deux sous-domaines du même domaine racine, il suffit d'obtenir un dépôt ICP pour le domaine racine.
Connectez-vous à la console ApsaraVideo Live.
Dans le volet de navigation de gauche, cliquez sur Domain Names. La page Domain Management s'affiche.
Cliquez sur Add Domain.

Remarque
Pour ajouter un sous-domaine, ajoutez un préfixe à votre nom de domaine enregistré. Un sous-domaine n'a pas besoin d'être enregistré séparément. Veillez à bien distinguer le domaine d'ingestion du domaine de diffusion.

Configurez les paramètres de domaine requis.

Important

Lorsque vous ajoutez un nom de domaine à ApsaraVideo Live pour la première fois, vous devez vérifier sa propriété. Pour plus d'informations, consultez la rubrique Vérification de la propriété du domaine.

Afficher les paramètres

Paramètre	Valeur	Description
Domain Type	Streaming Domain Ingest Domain	Le type d'accélération pour le nom de domaine. Un domaine d'ingestion accélère l'ingestion des flux, tandis qu'un domaine de diffusion accélère la distribution des flux. Vous ne pouvez pas modifier ce paramètre après sa configuration. Remarque Lorsque vous ajoutez un domaine d'ingestion, définissez Domain Type sur Ingest Domain. Lorsque vous ajoutez un domaine de diffusion, définissez Domain Type sur Streaming Domain. Vous ne pouvez pas utiliser le même nom de domaine à la fois comme domaine d'ingestion et comme domaine de diffusion.
Domain Name	N/A	Saisissez le nom de domaine à accélérer. Notez les points suivants : Utilisez un sous-domaine pour le nom de domaine accéléré, par exemple `demo.aliyundoc.com`. ApsaraVideo Live ne prend pas en charge les noms de domaine génériques (wildcard), tels que `.aliyundoc.com`. Un nom de domaine accéléré doit être unique. Si vous recevez le message The specified domain already exists, vérifiez que le nom de domaine n'est pas déjà utilisé dans un autre service Alibaba Cloud, tel qu'ApsaraVideo VOD. Après l'activation d'ApsaraVideo Live, vous pouvez ajouter jusqu'à 20 noms de domaine par compte. Si la bande passante quotidienne moyenne maximale de vos noms de domaine dépasse 50 Mbit/s et que votre activité est exempte de risques, vous pouvez soumettre un ticket pour demander une augmentation du quota. Pour plus d'informations, consultez la rubrique Contactez-nous. Tout le contenu accéléré doit être conforme aux exigences légales et aux normes commerciales. Pour plus de détails, consultez la rubrique Normes de révision des noms de domaine. Remarque* Le sous-domaine doit appartenir au même compte Alibaba Cloud. ApsaraVideo Live vérifie cette condition lors de l'ajout du nom de domaine. Si le sous-domaine appartient à un autre compte, le système signale une erreur.
Acceleration Region	Chinese Mainland	Sélectionnez Chinese Mainland pour le domaine d'ingestion si vos animateurs se trouvent en Chine continentale. Sélectionnez Chinese Mainland pour le domaine de diffusion si vos spectateurs se trouvent en Chine continentale. Le nom de domaine nécessite un dépôt ICP. Nous vous recommandons d'utiliser le système de dépôt ICP d'Alibaba Cloud pour effectuer votre demande.
	Global	Sélectionnez Global pour le domaine d'ingestion si vos animateurs se trouvent dans le monde entier, y compris en Chine continentale. Sélectionnez Global pour le domaine de diffusion si vos spectateurs se trouvent dans le monde entier, y compris en Chine continentale. Le nom de domaine nécessite un dépôt ICP. Nous vous recommandons d'utiliser le système de dépôt ICP d'Alibaba Cloud pour effectuer votre demande.
	Outside Chinese Mainland	Sélectionnez Outside Chinese Mainland pour le domaine d'ingestion si vos animateurs se trouvent en dehors de la Chine continentale. Sélectionnez Outside Chinese Mainland pour le domaine de diffusion si vos spectateurs se trouvent en dehors de la Chine continentale. Si vous sélectionnez Outside Chinese Mainland et que le centre de diffusion en direct se trouve également en dehors de la Chine continentale, aucun dépôt ICP n'est requis pour votre nom de domaine. Si vous sélectionnez Outside Chinese Mainland mais que le centre de diffusion en direct se trouve en Chine continentale, un dépôt ICP est requis pour votre nom de domaine. Nous vous recommandons d'utiliser le système de dépôt ICP d'Alibaba Cloud pour effectuer votre demande. Remarque Pour plus d'informations sur la sélection d'une région d'accélération, consultez la rubrique Comment sélectionner une région d'accélération pour un nom de domaine ?.
Live Center	N/A	Un centre de diffusion en direct fournit des services de traitement multimédia basés sur le cloud, tels que la capture d'instantanés, l'enregistrement, le transcodage et le studio de production. Le domaine d'ingestion et son domaine de diffusion associé doivent utiliser la même région de centre de diffusion en direct. Vous ne pouvez pas modifier ce paramètre après sa configuration. Pour plus d'informations sur la sélection d'un centre de diffusion en direct, consultez la rubrique Comment sélectionner un centre de diffusion en direct ?.

Notez la valeur de l'enregistrement CNAME générée pour l'étape suivante.

Après l'ajout du domaine, un tableau de configuration s'affiche. Ce tableau inclut le domaine de diffusion, le type d'enregistrement (CNAME), le nom d'hôte et la valeur de l'enregistrement CNAME. Vous devez ajouter cette valeur d'enregistrement CNAME chez votre fournisseur DNS pour activer l'accélération CDN. Vous pouvez également cliquer sur CNAME Configuration Guide pour terminer la configuration.

Étape 2 : Configuration d'un enregistrement CNAME

Pour activer l'accélération, pointez votre domaine vers l'adresse CNAME attribuée par ApsaraVideo Live. L'exemple suivant montre comment procéder avec Alibaba Cloud DNS.

Remarque

Alibaba Cloud CDN valide les enregistrements DNS à l'aide de serveurs déployés en Chine continentale. Si vous configurez une résolution DNS régionale pour votre domaine, par exemple en configurant l'adresse CNAME d'Alibaba Cloud CDN uniquement pour les régions situées en dehors de la Chine continentale (y compris Hong Kong, Macao, Taïwan et d'autres pays et régions), les serveurs de validation ne peuvent pas résoudre l'adresse CNAME. Dans ce cas, le statut CNAME du domaine dans la console CDN s'affiche comme Pending Configuration. Cela n'affecte pas le service d'accélération CDN.
Les noms de domaine CNAME pour Alibaba Cloud CDN, DCDN, ApsaraVideo Live et ApsaraVideo VOD peuvent être utilisés uniquement pour la planification et la résolution Alibaba Cloud CDN. Alibaba Cloud se réserve le droit de suspendre les noms de domaine et les comptes correspondants en cas d'utilisation malveillante des noms de domaine CNAME.

Connectez-vous à Alibaba Cloud DNS.
Dans le volet de navigation de gauche, choisissez Authoritative DNS Resolution pour accéder à la page de résolution des noms de domaine.
Localisez le nom de domaine cible et cliquez sur Settings dans la colonne Actions.

Cliquez sur Add Record et configurez les paramètres suivants :

Paramètre

Description

Type d'enregistrement

Sélectionnez CNAME Record pour pointer le nom de domaine vers un autre nom de domaine.

Nom d'hôte

Saisissez le préfixe du nom de domaine. Pour les préfixes courants et leurs exemples de noms de domaine correspondants, consultez le tableau suivant.

Source de requête

Conservez la valeur par défaut.

Valeur d'enregistrement

Saisissez la valeur CNAME de l'enregistrement.

TTL

Conservez la valeur par défaut.

Préfixe

Exemple de domaine

Description

demo

demo.aliyundoc.com

Résolution d'un sous-domaine.

@

aliyundoc.com

Résolution d'un domaine racine.

*

*.aliyundoc.com

Effectuer une résolution DNS générique (wildcard).

Cliquez sur OK pour terminer la configuration CNAME.

Vérification de l'enregistrement CNAME

Méthode 1 : Sur la page Add CNAME Record. Dans la section CNAME Verification, cliquez sur CNAME Configuration Guide pour vérifier si la configuration CNAME a pris effet.
Méthode 2 : Exécutez la commande nslookup -type=cname yourdomain.com. Si le résultat de résolution renvoyé correspond à la valeur CNAME du domaine dans la console ApsaraVideo Live, la configuration CNAME a pris effet.
```
C:\Users\xxx>nslookup -type=cname xxx
Server:  xxx
Address:  xxx
Non-authoritative answer:
xxx    canonical name = cxxx.cdngslb.com
C:\Users\xxx>
```

(Facultatif) Configuration d'un certificat SSL

En raison des exigences de sécurité des navigateurs natifs, si vous devez lire des flux en direct dans un navigateur, vous devez configurer un certificat SSL pour les domaines d'ingestion et de diffusion. Pour plus d'informations, consultez la rubrique Configuration de la diffusion sécurisée via HTTPS.

Étape 3 : Association des domaines d'ingestion et de diffusion

ApsaraVideo Live utilise l'ingestion en périphérie ; vous devez donc associer les domaines d'ingestion et de diffusion pour permettre l'ingestion et la lecture des flux.

Dans le volet de navigation de gauche, cliquez sur Verify. Localisez votre domaine de diffusion et cliquez sur Domain Names dans la colonne Domain Settings pour accéder à la page Actions > Streaming Management.
Cliquez sur l'onglet Basic Settings.
Cliquez sur Stream Ingest Information ou sur l'icône de modification à côté de Add Stream Ingest Information pour sélectionner le domaine d'ingestion que vous souhaitez associer. Dans la boîte de dialogue Ingest Domain qui s'affiche, sélectionnez un domaine d'ingestion existant dans la liste déroulante Ingest Domain et cliquez sur OK. Si vous devez ajouter un nouveau domaine d'ingestion, vous devez d'abord l'ajouter sur la page Domain Management.

Étape 4 : Génération des URL d'ingestion et de diffusion

Les URL d'ingestion et de diffusion sont des URL basées sur des domaines utilisées pour pousser et extraire un flux en direct. Suivez ces étapes pour les générer dans la console :

Connectez-vous à la console ApsaraVideo Live.
Dans le volet de navigation de gauche, choisissez Ingest Domain.
Sur l'onglet Live URL Generator pour obtenir les URL d'ingestion et de diffusion. Pour des exemples et des descriptions des URL, consultez la rubrique Génération d'URL de diffusion en direct.

Étape 5 : Ingestion et lecture d'un flux

Remarque

Si vous rencontrez des problèmes lors de l'ingestion ou de la lecture du flux, utilisez l'outil de dépannage en libre-service pour effectuer des diagnostics. Cet outil permet de diagnostiquer rapidement les problèmes courants de diffusion en direct et de proposer des solutions. Pour plus d'informations, consultez la rubrique Dépannage.

Ingestion d'un flux

L'ingestion de flux consiste à pousser l'audio et la vidéo encapsulés depuis l'étape de capture vers le centre ApsaraVideo Live. Cet exemple montre comment ingérer un flux à l'aide de l'application de démonstration ApsaraVideo Live.

Scannez le code QR sur votre appareil mobile pour installer l'application de démonstration ApsaraVideo Live.

Remarque
Si vous voyez un message « Untrusted Enterprise Developer » sur votre appareil iOS, accédez à Settings > General > VPN & Device Management, recherchez le profil Taobao et appuyez sur Trust.
Exécutez l'application de démonstration ApsaraVideo Live.
Choisissez Camera Pushing ou Screen Sharing. L'interface principale propose trois options : Camera Pushing, Screen Sharing et Live Playback. Camera Pushing et Screen Sharing sont les options d'ingestion.

Remarque
Lors de l'ingestion de vidéo locale depuis un appareil mobile, seul le format YUV original de l'image vidéo est pris en charge.
Scannez le code QR de l'URL d'ingestion signée obtenue à l'étape 4 pour remplir le champ URL, ou saisissez l'URL manuellement. Dans l'onglet Ingest Parameters, définissez la Resolution (par exemple, 540p), activez Adaptive Bitrate et Adaptive Resolution selon vos besoins, ou développez Advanced Settings pour plus d'options. Par exemple, l'URL pourrait être rtmp://demo.aliyundoc.com/app/stream?auth_key=**********-0-0-9c6e7c8190c10bdfb3c0************.
Cliquez sur Live URL Generator pour commencer l'ingestion depuis votre appareil mobile.
Accédez à Stream Management et consultez et gérez les flux audio et vidéo poussés dans l'onglet Streaming Domain.

Remarque

Pour d'autres méthodes d'ingestion, consultez la rubrique Ingestion de flux en direct.

Lecture d'un flux en direct

La lecture de flux en direct consiste à distribuer le contenu depuis le centre ApsaraVideo Live vers un lecteur. Cet exemple montre comment lire un flux avec le lecteur multimédia VLC.

Téléchargez et installez le lecteur multimédia VLC. Lien de téléchargement : lecteur multimédia VLC.
Exécutez le lecteur multimédia VLC.
Dans la barre de menus, choisissez Media > Open Network Stream...
Dans l'onglet Network, saisissez une URL de diffusion. Exemple : rtmp://example.aliyundoc.com/app/stream?auth_key=1543300311-0-0-d47ce016332bf280cf275********.
Cliquez sur Play.

Remarque

Le client d'ingestion doit maintenir le flux pendant la lecture en direct. Sinon, la lecture échouera.
Pour d'autres méthodes de lecture, consultez la rubrique Lecture de flux en direct.

Références

Pour en savoir plus sur les fonctionnalités d'ApsaraVideo Live, consultez la rubrique Présentation du guide du développeur.
Pour plus d'informations sur les autres fournisseurs DNS et leurs opérations, consultez la rubrique Configuration d'un enregistrement CNAME pour un nom de domaine.
Pour vérifier si un enregistrement CNAME a pris effet, utilisez l'outil de diagnostic de nom de domaine.
Pour découvrir d'autres façons de générer des URL de diffusion en direct, consultez la rubrique Génération d'URL de diffusion en direct.

FAQ

Pour les questions relatives à la configuration des noms de domaine, consultez la rubrique FAQ sur la gestion des noms de domaine.
Pour les questions concernant les centres de diffusion en direct et les interruptions de flux, consultez la rubrique FAQ sur les services de base de diffusion en direct.
Pour les questions relatives à la signature d'URL, consultez la rubrique FAQ sur la signature d'URL.
Pour obtenir des informations sur les protocoles de diffusion pris en charge par ApsaraVideo Live, consultez la rubrique Quels protocoles de diffusion ApsaraVideo Live prend-il en charge ?.
Pour les questions relatives à la facturation de la diffusion en direct, consultez la rubrique FAQ sur la facturation.