ApsaraVideo VOD:Modèles de capture d'images

Comparaison des méthodes de capture

Les méthodes de capture disponibles incluent Normal Snapshot, WebVTT et Image Sprite. Pour plus de détails, consultez la rubrique Captures vidéo.

Créer un modèle de capture

1. Connectez-vous à la console ApsaraVideo VOD.

2. Dans le volet de navigation de gauche, sélectionnez Configuration Management > Media Processing > Snapshot Templates.

3. Cliquez sur Create Snapshot Template. Sur la page d'ajout du modèle, configurez les paramètres requis.

   Important

   La méthode de capture (Normal Snapshot, WebVTT ou Sprite) ne peut pas être modifiée après la création du modèle. Confirmez votre choix avant d'enregistrer le modèle.

   Paramètres généraux

   Les paramètres suivants s'appliquent à toutes les méthodes de capture.

   Paramètre	Description
   Nom du modèle	Nom personnalisé du modèle, utilisé pour l'identification et la référence dans les workflows.
   Heure de début	Moment où le processus de capture commence (HH:MM:SS).
   Nombre de captures	Nombre de captures à générer.
   Intervalle de capture	Intervalle de temps entre les captures. Si vous définissez cette valeur sur 0 ou laissez le champ vide, les captures sont réparties uniformément sur toute la durée de la vidéo.
   Dimensions (Largeur × Hauteur)	Largeur et hauteur de la capture en pixels. Remarque Si vous ne définissez ni la largeur ni la hauteur, les dimensions de la capture correspondent à celles de la vidéo source. Si vous définissez uniquement la largeur ou la hauteur, l'autre dimension est ajustée proportionnellement au ratio d'aspect de la vidéo pour éviter toute distorsion.
   Type d'image	Type d'image à capturer. Les options incluent les images clés (keyframes) et les images ordinaires. Remarque Si vous sélectionnez les images clés, seules ces dernières sont capturées. En l'absence d'image clé à l'instant spécifié, la plus proche est retenue. La capture d'images clés est plus rapide que celle des images ordinaires.

   Paramètres spécifiques à WebVTT

   Paramètre	Description
   Générer une grande image	Indique si les vignettes requises pour WebVTT doivent être combinées en une seule grande image pour le stockage.

   Paramètres spécifiques au Sprite

   Paramètre	Description
   Disposition (Lignes × Colonnes)	Largeur et hauteur des vignettes individuelles au sein du sprite. Remarque Si non défini, les dimensions des vignettes correspondent à celles d'une capture normale. Si une seule dimension est spécifiée, l'autre est ajustée proportionnellement.
   Espacement des lignes	Espacement vertical entre les rangées de vignettes dans le sprite, exprimé en pixels.
   Espacement des colonnes	Espacement horizontal entre les colonnes de vignettes dans le sprite, exprimé en pixels.
   Couleur d'arrière-plan	Couleur d'arrière-plan du sprite.
   Conserver les images individuelles	Indique si les images individuelles composant le sprite doivent être conservées après la génération du sprite.

4. Une fois la configuration terminée, cliquez sur Save.

Utiliser un modèle de capture dans un workflow

Après avoir créé un modèle de capture, ajoutez-le à un workflow pour l'utiliser lors du chargement ou du traitement des médias.

1. Associez le modèle à un workflow.

   Connectez-vous à la console ApsaraVideo VOD. Dans le volet de navigation de gauche, sélectionnez Configuration Management > Media Processing > Workflows. Ajoutez ou modifiez un workflow. Insérez un nœud Snapshots dans le workflow. Dans le volet de configuration situé à droite, sélectionnez le modèle de capture que vous avez créé.

2. Déclenchez le workflow.

   Une fois le modèle associé, déclenchez le workflow selon l'une des méthodes suivantes.

   1. Déclenchement automatique : Lors du chargement d'un fichier audio ou vidéo, spécifiez ce workflow. Il s'exécute automatiquement après le téléchargement du fichier. Pour plus d'informations, consultez la rubrique Charger des fichiers dans la console ApsaraVideo VOD.

   2. Déclenchement manuel : Sur la page Media Files > Audio/Video, sélectionnez la ressource multimédia cible, cliquez sur Processing, choisissez Use Workflow, puis spécifiez ce workflow.

   3. Déclenchement via API : Appelez l'opération SubmitWorkflowJobs pour spécifier ce workflow.

3. Récupérez les résultats de la capture.

   Vous pouvez obtenir les résultats de la capture à partir d'une notification d'événement SnapshotComplete. Lorsqu'une capture est effectuée, le système envoie un rappel à l'URL configurée. Le corps du message contient une liste des données de capture.

Facturation

La fonctionnalité de capture d'ApsaraVideo VOD est gratuite.

FAQ

Que faire si je ne reçois pas de notification d'événement SnapshotComplete ?

Suivez les étapes ci-dessous pour résoudre le problème :

1. Vérifiez que le statut de la vidéo source est Normal et que le fichier vidéo n'est pas corrompu.

2. Assurez-vous que les paramètres du modèle de capture sont valides. Par exemple, l'heure de début ne doit pas dépasser la durée de la vidéo.

3. Confirmez que les rappels de notification d'événements sont correctement configurés. Pour plus d'informations, consultez la rubrique Notifications d'événements.

Comment utiliser directement un modèle de capture via une API ?

Appelez l'opération SubmitSnapshotJob pour lancer une tâche de capture de manière indépendante.