Tous les produits
Search

Ce produit

    ApsaraVideo Live:Capture instantanée de flux en direct

    Centre de documentation

    ApsaraVideo Live:Capture instantanée de flux en direct

    Dernière mise à jour :Aug 19, 2026

    La fonctionnalité Snapshots vous permet de prendre des captures instantanées en temps réel pendant la lecture d'un flux en direct. Cette rubrique décrit en détail la fonctionnalité vidéo Snapshots.

    Prérequis

    La fonctionnalité Snapshots nécessite le stockage des fichiers de capture dans un bucket. Vous devez donc activer le service OSS et disposer d'au moins un bucket pour stocker ces fichiers. Pour plus d'informations, consultez les rubriques Activer le service OSS et Créer un bucket.

    Important

    Le bucket doit se trouver dans la même région que le centre de diffusion du domaine d'ingestion. Les captures inter-régions ne sont pas prises en charge.

    Règles de capture

    • La fonctionnalité Snapshots se configure pour l'ingestion de flux au niveau AppName. Vous pouvez définir des règles de capture pour toutes les ingestions de flux associées à une AppName spécifique.

      Remarque

      Si vous définissez AppName sur un astérisque (*), la règle de capture s'applique à toutes les ingestions de flux du domaine d'ingestion.

    • Lors de la configuration de la fonctionnalité Snapshots, vous pouvez définir deux types de captures : les captures avec écrasement et les captures en temps réel.

      • Une capture avec écrasement remplace le fichier de capture précédent à chaque génération d'une nouvelle capture.

      • Une capture en temps réel n'écrase pas les fichiers de capture précédents. Chaque nouvelle capture est stockée sous forme de fichier incrémentiel.

      • Actuellement, la fonctionnalité Snapshots ne génère des captures qu'au format JPG.

        Remarque

        Vous pouvez sélectionner les deux modes, mais vous devez en choisir au moins un.

    Configuration et gestion des captures

    Remarque

    Un modèle de capture nouvellement configuré ne s'applique pas aux flux en direct en cours. Vous devez redémarrer l'ingestion du flux pour que les modifications prennent effet.

    Configuration des captures

    Vous pouvez configurer la fonctionnalité vidéo Snapshots de deux manières :

    Configurer les captures dans la console

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Snapshots. Sur la page Snapshots, sélectionnez l'onglet Snapshot Settings.

    3. Sélectionnez le domaine d'ingestion à configurer.

    4. Cliquez sur Add.

    5. Configurez le modèle de capture.

      Le tableau suivant décrit les paramètres du modèle de capture.

      Paramètre

      Description

      Application Name

      Le nom de l'application. Ce paramètre prend effet uniquement si le Application Name saisi correspond au Application Name utilisé pour l'ingestion du flux en direct. Pour configurer les captures au niveau du domaine, saisissez un astérisque (*).

      Snapshot Interval

      L'intervalle entre les captures. Unité : secondes. Valeurs valides : 5 à 3600.

      Storage Location

      Sélectionnez l'emplacement dans OSS pour stocker les fichiers de capture.

      Le bucket OSS doit se trouver dans la même région que le centre de diffusion du domaine d'ingestion. Les captures inter-régions ne sont pas prises en charge.

      Storage Mode

      Deux modes de stockage sont disponibles. Vous pouvez en sélectionner un ou les deux.

      • Overwrite : Les captures sont effectuées à l'intervalle spécifié. Chaque nouvelle capture écrase la précédente.

      • New : Les captures sont effectuées à l'intervalle spécifié. Les nouvelles captures sont stockées séquentiellement dans un ordre N+1, où N ≥ 0.

      Remarque

      Si vous sélectionnez les deux modes, les captures sont générées et stockées selon les deux méthodes.
      Remarque

      Une fois la configuration terminée, des captures d'écran sont prises et stockées pour tous les Application Name configurés sous ce nom de domaine, conformément au modèle configuré.

      Les modifications apportées aux paramètres de capture prennent effet après la prochaine ingestion de flux.

    6. Cliquez sur OK.

    Configurer les captures via une API

    Appelez l'opération AddLiveAppSnapshotConfig pour configurer la fonctionnalité de capture.

    Gestion des fichiers de capture

    Affichage des captures

    Vous pouvez afficher les fichiers de capture de trois manières :

    Afficher les fichiers de capture dans la console

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management > Snapshots. Sur la page Snapshots, sélectionnez Snapshot Management.

    3. Sélectionnez le domaine et la plage de temps pour votre requête. Ensuite, saisissez ou sélectionnez AppName et StreamName.

    4. Cliquez sur Search pour afficher les captures dans la plage de temps sélectionnée. Si vous ne parvenez pas à afficher les captures, assurez-vous que les autorisations du bucket OSS sont définies sur public-read. Pour plus d'informations, consultez la rubrique Configurer les ACL des buckets OSS.

      Sur l'onglet Snapshot Management, vous pouvez filtrer les captures par date, AppName et StreamName.

    5. Survolez une image pour afficher une version agrandie ou copier l'URL de la capture.

    Afficher les fichiers de capture via une API

    Appelez l'opération DescribeLiveStreamSnapshotInfo pour afficher les fichiers de capture.

    Afficher les fichiers de capture dans OSS

    Lors de la configuration de la fonctionnalité de capture, vous avez spécifié le chemin de stockage dans OSS. Pour afficher les fichiers de capture dans OSS, consultez la rubrique Lister les objets.

    Suppression des captures

    ApsaraVideo Live stocke les métadonnées des fichiers de capture, telles que AppName, StreamName et le chemin de stockage OSS. Les fichiers réels sont stockés dans OSS. Pour supprimer les fichiers dans OSS lorsque vous supprimez leurs enregistrements de capture correspondants dans ApsaraVideo Live, vous devez créer le rôle de service AliyunMTSVideoLifecycleRole et lui accorder des autorisations à l'aide de la politique système AliyunMTSVideoLifecycleRolePolicy.

    Procédure d'autorisation

    Avant de pouvoir supprimer des captures ou des enregistrements dans la console ApsaraVideo Live, vous devez accorder les autorisations requises. Suivez ces étapes pour créer et autoriser un rôle Resource Access Management (RAM) dans la console RAM, puis revenez à la console ApsaraVideo Live pour supprimer les fichiers.

    Créer un rôle de service

    1. Connectez-vous à la console RAM en tant qu'administrateur RAM.

    2. Dans le volet de navigation de gauche, choisissez Identities > Roles.

    3. Sur la page Roles, cliquez sur Create Role.

    4. Sur la page Create Role, sélectionnez Alibaba Cloud Service pour Trusted Entity Type, puis cliquez sur OK.

      Remarque

      Dans la liste déroulante Trusted Service, sélectionnez Media Processing.

    5. Dans la boîte de dialogue Create Role, saisissez « AliyunMTSVideoLifecycleRole » pour Role Name et cliquez sur OK. Le nom du rôle peut comporter jusqu'à 64 caractères et contenir des lettres, des chiffres, des traits d'union (-) et des points (.).

    6. Une fois le rôle créé, sur la page Basic Information, cliquez sur l'onglet Permissions.

    7. Cliquez sur Input and Attach et configurez les paramètres suivants :

      • Type d'autorisation : Politique système

      • Nom de la politique : AliyunMTSVideoLifecycleRolePolicy

      Après avoir configuré les paramètres, cliquez sur OK.

    Supprimer les fichiers de capture dans la console

    1. Connectez-vous à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, sélectionnez Feature Management> Snapshots. Sur la page Snapshots, sélectionnez Snapshot Management.

    3. Sélectionnez le domaine et la plage de temps pour votre requête. Ensuite, saisissez ou sélectionnez AppName et StreamName.

    4. Survolez une image et cliquez sur l'icône de suppression pour supprimer une seule capture.

      Pour supprimer plusieurs captures, cochez leurs cases et cliquez sur Batch Delete. Vous pouvez supprimer jusqu'à 200 captures à la fois.

    Supprimer les fichiers de capture via une API

    Appelez l'opération DeleteSnapshotFiles pour supprimer les fichiers de capture. Cela supprime également les fichiers stockés dans OSS.

    Vous pouvez configurer un rappel d'événement pour envoyer des informations de capture, y compris les horodatages, à votre système métier. Cela vous permet de supprimer les fichiers correspondants selon une politique personnalisée, telle qu'un nettoyage périodique. Pour plus d'informations, consultez le guide de développement des rappels d'événements.

    Documents connexes

    Pour savoir comment utiliser le SDK Java, consultez le Guide d'utilisation du SDK Java.

    Pour obtenir la liste des API associées, consultez les API de capture instantanée de flux en direct.