ApsaraVideo Live:Enregistrement

Fonctionnement

Pendant l'enregistrement, le système traite le flux en direct ingéré en le segmentant en fichiers Transport Stream (TS) et en les encapsulant dans le format cible, tel que FLV, MP4 ou M3U8. Les fichiers finaux sont sauvegardés dans votre espace de stockage spécifié.

L'enregistrement de flux en direct modifie uniquement le format conteneur de l'audio et de la vidéo. Il n'altère pas le contenu au niveau de la couche d'encodage. Si le flux source présente des problèmes tels que des artefacts vidéo ou une désynchronisation audio-vidéo, le fichier enregistré conservera ces défauts.

Formats d'encodage audio et vidéo

Étant donné que l'enregistrement de flux en direct commence par segmenter le flux en direct en fichiers TS, le format d'encodage du flux doit être compatible avec le conteneur TS. ApsaraVideo Live prend en charge uniquement les formats d'encodage suivants :

• Codecs vidéo : H.264 (AVC), H.265 (HEVC), MPEG-4

• Codecs audio : AAC, MP3

Si le flux en direct contient de l'audio ou de la vidéo encodés dans d'autres formats, vous pouvez rencontrer des problèmes tels qu'un échec de l'enregistrement, un écran noir dans l'enregistrement ou l'absence d'audio.

Comparaison des méthodes de stockage

L'enregistrement de flux en direct offre deux options de stockage : ApsaraVideo VOD et OSS. Vous ne pouvez pas configurer les deux options de stockage pour un même flux en direct. Veuillez en choisir une en fonction de vos besoins métier.

Enregistrement automatique

ApsaraVideo Live utilise des modèles d'enregistrement pour gérer les configurations d'enregistrement. Le système fait correspondre un modèle d'enregistrement automatique en fonction du DomainName, de l'AppName et du StreamName présents dans votre URL d'ingestion.

Logique de correspondance

• Correspondance exacte : Dans le modèle d'enregistrement, spécifiez un AppName et un StreamName spécifiques. Cela applique le modèle uniquement à ce flux en direct précis.

• Correspondance générique : Dans le modèle d'enregistrement, définissez l'AppName sur * pour appliquer le modèle à toutes les applications sous le domaine. Définissez le StreamName sur * pour appliquer le modèle à tous les flux en direct au sein de l'application.

• Limite du modèle générique : Lorsque l'AppName et le StreamName sont tous deux définis sur *, un seul modèle d'enregistrement générique de ce type est autorisé par domaine. Si votre soumission échoue dans la console, vérifiez si un modèle générique existe déjà pour le domaine. Pour modifier la configuration, modifiez le modèle générique existant au lieu d'en créer un nouveau.

Confirmation par callback

Utilisez l'enregistrement à la demande pour décider dynamiquement s'il faut enregistrer un flux en direct en fonction de vos règles métier.

Flux de travail :

1. Lorsqu'un flux en direct démarre, si le modèle d'enregistrement correspondant est défini sur « Enregistrement à la demande », le service de streaming en direct envoie une requête HTTP à votre URL de callback à la demande préconfigurée pour déterminer s'il faut enregistrer le flux.

2. Votre application reçoit la requête et renvoie une commande d'enregistrement (autoriser ou refuser) en fonction de sa logique métier actuelle.

3. Le service de streaming en direct lance la tâche d'enregistrement en fonction de votre réponse.

Vous devez d'abord spécifier l'URL de callback à la demande pour l'enregistrement de flux en direct dans les paramètres de callback d'événement. Pour plus de détails sur la configuration, les paramètres de requête et le format de réponse, reportez-vous à Callbacks d'enregistrement de flux en direct et à Callbacks d'enregistrement à la demande.

Remarque :

Le service d'enregistrement traite votre réponse de callback pour remplacer les configurations du modèle :

• Interval : La valeur Interval fournie remplacera le cycle d'enregistrement configuré dans le modèle d'enregistrement.

• Format : Le service calcule l'intersection entre le Format demandé et les formats préconfigurés dans le modèle d'enregistrement. S'il n'y a aucun format commun, le flux ne sera pas enregistré.

• Fréquence de callback : Pour un seul flux en direct, le callback d'enregistrement à la demande envoie la requête HTTP de confirmation une seule fois, au début de la diffusion du flux. Cette requête n'est pas envoyée à nouveau, même si le format de stockage est M3U8 ou si le flux se déconnecte et se reconnecte pendant la diffusion.

Déclencheur par paramètre d'ingestion

Lorsque la méthode de déclenchement est définie sur « Paramètres d'ingestion », vous pouvez contrôler l'activation ou non de l'enregistrement pour le flux actuel en utilisant le paramètre record_config dans l'URL d'ingestion.

• Format du paramètre : record_config={"NeedRecord": <true/false>}

• Description du paramètre : true : Active l'enregistrement. false : Désactive l'enregistrement.

• Remarque : Le paramètre doit être encodé en URL lors de la construction de l'URL.

• Limites : Ce mode de déclenchement permet uniquement de contrôler l'enregistrement du flux brut. Les flux transcodés ne peuvent pas être enregistrés à l'aide de ce mode de déclenchement. Pour enregistrer des flux transcodés, sélectionnez un autre mode de déclenchement, tel que Automatic, Callback Confirmation ou Manual.

Supposons que l'URL d'ingestion du flux soit : rtmp://push.example.com/live/stream1

Si vous devez activer l'enregistrement à l'aide de paramètres, vous pouvez construire l'URL comme suit : rtmp://push.example.com/live/stream1?record_config=%7B%22NeedRecord%22%3Atrue%7D&auth_key=xxx

Enregistrement manuel

Pour un contrôle total du processus d'enregistrement basé sur votre logique métier, utilisez l'enregistrement manuel.

À ce stade, vous pouvez appeler l'API RealTimeRecordCommand pour démarrer manuellement l'enregistrement d'un flux en direct spécifique.

Cette API permet également d'arrêter un enregistrement. Vous pouvez appeler cette interface pour arrêter de force la tâche d'enregistrement en cours, qu'elle ait été démarrée automatiquement, à la demande ou manuellement.

Reportez-vous à la documentation de l'API RealTimeRecordCommand, et utilisez le paramètre command pour effectuer l'opération start ou stop.

Prérequis

Activez le service ApsaraVideo VOD et configurez un bucket de stockage. Le bucket doit se trouver dans la même région que le centre en direct du domaine que vous souhaitez configurer.

Configuration

ApsaraVideo Live utilise des modèles d'enregistrement pour gérer les configurations d'enregistrement. Vous pouvez créer un modèle d'enregistrement pour stocker les enregistrements dans ApsaraVideo VOD à l'aide de la console ou d'une API.

// Parameter settings for API request
AddLiveRecordVodConfigRequest.RecordFormat recordFormat0 = AddLiveRecordVodConfigRequest.RecordFormat.builder()
        .format("m3u8")
        .sliceDuration(30)
        .autoCompose("ON")
        .videoProcess("origin,compose")
        .processMethod("transcode")
        .processTemplateId("e2d796d3bb5fd8049d32bff62f94****")
        .tags("sports")
        .build();

AddLiveRecordVodConfigRequest addLiveRecordVodConfigRequest = AddLiveRecordVodConfigRequest.builder()
        .regionId("<Your RegionID>")
        .domainName("<Your DomainName>")
        .appName("live")
        .streamName("stream1")
        .cycleDuration(3600)
        .spaceId("app-1000000")
        .storageLocation("<Your StorageLocation>")
        .onDemand(0)
        .recordContent("raw,transcode")
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

Gérer les enregistrements

Vous pouvez consulter les enregistrements stockés dans ApsaraVideo VOD depuis la console ApsaraVideo Live et les gérer à l'aide du service ApsaraVideo VOD.

1. Connectez-vous à la console ApsaraVideo Live.

2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Recording. Cliquez sur l'onglet Recording Management.

3. Sélectionnez le domaine de streaming configuré.

4. Cliquez sur l'onglet VOD.

   Vous pouvez filtrer les enregistrements par plage de dates, AppName et StreamName.

5. Pour afficher et gérer des fichiers d'enregistrement spécifiques, vous pouvez cliquer sur Manage in the VOD Console dans la colonne Actions, ou vous connecter à la console ApsaraVideo VOD et sélectionner Media Library > Audio/Video.

Prérequis

1. Activez le service OSS et créez un bucket de stockage. Le bucket OSS doit se trouver dans la même région que le centre en direct du domaine que vous souhaitez configurer.

2. Configurez les autorisations permettant à ApsaraVideo Live d'écrire dans OSS. Cela est généralement autorisé automatiquement lorsque vous activez le service. Si vous supprimez accidentellement l'autorisation, vous pouvez cliquer sur Autoriser l'accès aux ressources cloud pour l'accorder à nouveau.

Configuration

ApsaraVideo Live utilise des modèles d'enregistrement pour gérer les configurations d'enregistrement. Vous pouvez créer un modèle d'enregistrement pour stocker les enregistrements dans OSS à l'aide de la console ou d'une API.

Après avoir configuré le modèle, vous devez redémarrer le flux d'ingestion pour que les modifications prennent effet. Pour garantir qu'un flux soit enregistré dès le début, créez le modèle avant le démarrage du flux.

// Parameter settings for API request
AddLiveAppRecordConfigRequest.TranscodeRecordFormat transcodeRecordFormat0 = AddLiveAppRecordConfigRequest.TranscodeRecordFormat.builder()
        .sliceDuration(30)
        .sliceOssObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{EscapedStartTime}_{EscapedEndTime}")
        .cycleDuration(900)
        .format("m3u8")
        .build();

AddLiveAppRecordConfigRequest.RecordFormat recordFormat0 = AddLiveAppRecordConfigRequest.RecordFormat.builder()
        .sliceDuration(30)
        .format("m3u8")
        .cycleDuration(900)
        .sliceOssObjectPrefix("record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("record/{AppName}/{StreamName}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}")
        .build();

AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest = AddLiveAppRecordConfigRequest.builder()
        .domainName("<Your DomainName>")
        .appName("live")
        .ossEndpoint("<Your OssEndpoint>")
        .ossBucket("<Your OssBucket>")
        .streamName("stream1")
        .onDemand(0)
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeRecordFormat(java.util.Arrays.asList(transcodeRecordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

Gérer les enregistrements

Configurer un domaine CDN

Pour accélérer la distribution de vos vidéos enregistrées, configurez un domaine CDN. Le CDN distribue les vidéos vers divers nœuds, permettant aux utilisateurs d'accéder au contenu depuis le nœud le plus proche plutôt que depuis l'origine OSS. Cela améliore la vitesse d'accès et réduit les coûts réseau. Pour les opérations spécifiques, consultez Accélérer l'accès à OSS en utilisant Alibaba Cloud CDN.

Génération et disponibilité des enregistrements

Mécanisme de génération

Le fichier d'enregistrement n'est pas généré immédiatement après la déconnexion d'un flux. Le système attend la durée de collage pour les flux interrompus (180 secondes par défaut). Si le flux reprend dans cette période, l'enregistrement est ajouté au fichier existant. S'il ne reprend pas, le système considère que le flux est terminé et génère le fichier d'enregistrement.

Vous pouvez ajuster cette durée selon vos besoins, mais nous vous recommandons de conserver le paramètre par défaut. Une durée plus courte peut entraîner la création de nombreux petits fichiers en raison des fluctuations du réseau, tandis qu'une durée plus longue signifie une attente plus importante pour le fichier après la fin du flux.

Génération immédiate

Pour générer le fichier d'enregistrement immédiatement après la fin d'un flux, sans délai de collage, configurez un callback d'événement pour le flux d'ingestion (voir Callbacks d'événement). Lorsque vous recevez la notification de déconnexion du flux, appelez l'API RealTimeRecordCommand pour annuler le délai de collage.

realTimeRecordCommandRequest.setCommand("cancel_delay");

Affichage des enregistrements en cours

Si la durée d'un flux n'a pas dépassé le cycle d'enregistrement, le fichier est généralement généré après la fin du flux. Pour accéder au fichier d'enregistrement actuel avant la fin du flux, appelez l'API RealTimeRecordCommand pour actualiser l'enregistrement. Cette commande termine de force le processus d'enregistrement en cours, génère le fichier immédiatement, puis démarre automatiquement un nouvel enregistrement.

realTimeRecordCommandRequest.setCommand("restart");

Si l'enregistrement de votre flux est configuré avec plusieurs formats de stockage, cette opération actualisera tous les formats.

Impact des anomalies de flux sur l'enregistrement

Le système gère les anomalies de flux différemment selon leur gravité :

• Flux standard (respecte les exigences d'encodage avec un débit d'images et une horodatage stables) : Les enregistrements sont générés avec succès à 100 %.

• Flux avec des problèmes mineurs (fluctuations occasionnelles du débit d'images ou sauts d'horodatage) : Le système gère automatiquement ces problèmes pour assurer la compatibilité.

• Flux avec des problèmes graves (absence prolongée d'images vidéo, horodatages désordonnés ou images clés manquantes) : La réussite de l'enregistrement ne peut pas être garantie.

Dépannage des problèmes de fichiers d'enregistrement

Si les fichiers d'enregistrement ne sont pas générés ou contiennent un contenu inattendu, vérifiez les points suivants :

• La configuration d'enregistrement ne prend pas effet — Les modèles d'enregistrement s'appliquent uniquement aux nouveaux flux poussés après la finalisation de la configuration. Si un flux était déjà en cours de diffusion lors de la création du modèle, vous devez déconnecter et repousser le flux pour que le modèle prenne effet.

• Le flux transcodé n'est pas enregistré — Vérifiez que la méthode de déclenchement du transcodage est définie sur « push-triggered ». Si la méthode de déclenchement est définie sur « pull-triggered », le flux transcodé n'est généré que lorsqu'un spectateur extrait activement le flux. Sans extraction active, le flux transcodé n'existe pas et ne peut donc pas être enregistré.

• Segments dupliqués lors de la lecture — Cela se produit généralement lorsqu'un flux se déconnecte et se reconnecte dans la durée de collage. Les segments chevauchants sont tous deux inclus dans l'enregistrement. Un montage en post-production est nécessaire pour supprimer les parties dupliquées.

• Écran noir avec audio à haute résolution — Vérifiez les éléments suivants côté diffusion : si la source de partage d'écran est capturée correctement, si les paramètres de l'encodeur correspondent à la résolution cible et si le lecteur prend en charge le format d'encodage. Ce problème est généralement dû à la configuration côté diffusion plutôt qu'au service d'enregistrement.

• Aucun enregistrement de callback OSS — Vérifiez que la destination de stockage est définie sur OSS. ApsaraVideo VOD utilise des événements de callback différents de ceux d'OSS. Si l'enregistrement est stocké dans ApsaraVideo VOD, vérifiez les événements de callback d'ApsaraVideo VOD à la place.

• Le nom du fichier d'enregistrement ne correspond pas aux attentes — Lors du stockage des enregistrements dans ApsaraVideo VOD, le nom du fichier d'enregistrement correspond par défaut au StreamName et ne prend pas en charge la personnalisation. Si vous avez besoin de noms de fichiers personnalisés, utilisez le stockage OSS et configurez la convention de nommage dans le modèle d'enregistrement.

Comment obtenir le VideoId d'un fichier d'enregistrement stocké dans ApsaraVideo VOD, et quelles sont les limitations d'authentification des callbacks ?

• Obtention du VideoId : Le callback d'enregistrement de flux en direct n'inclut pas le VideoId. Pour obtenir le VideoId, configurez une notification de callback d'événement côté ApsaraVideo VOD. Le callback VOD inclut des informations complètes sur les actifs multimédias, y compris le VideoId. Si vous avez déjà configuré un callback d'événement VOD, vous n'avez pas besoin de configurer également un callback d'enregistrement de flux en direct.

• Limitation d'authentification des callbacks : L'authentification du callback de fin d'enregistrement (qui repose sur les paramètres ALI-LIVE-TIMESTAMP et ALI-LIVE-SIGNATURE) n'est actuellement pas prise en charge lorsque l'enregistrement est stocké dans ApsaraVideo VOD. Si la console indique que le commutateur d'authentification est indisponible ou ne parvient pas à l'enregistrer, il s'agit d'une limitation connue ou d'un problème d'affichage, et le callback côté VOD doit être considéré comme faisant autorité.