Récupération de vignettes par programmation

MediaLivegénère des miniatures pour l'entrée actuellement active dans un canal en cours d'exécution. Pour une chaîne standard, MediaLive génère deux vignettes. Pour un canal à pipeline unique, MediaLive génère une miniature.

Vous pouvez utiliser le AWS CLI pour travailler avec des vignettes par programmation. Les informations suivantes supposent que vous connaissez les bases de l'utilisation duAWS CLI. Pour plus d'informations sur les bases, consultez le manuel de référence des AWS CLI commandes.

Utilisez la commande DescribeThumbnails. Cette commande est représentée différemment dans chaque interface :

• Dans l'AWS CLI, la commande est describe-thumbnails.

• Dans l'API, la commande est représentée par un HTTP GET sur describe-thumbnails/kmsKeyId.

• Dans les AWS SDK, la commande est représentée par des constructions adaptées au langage du SDK en question.

Pour récupérer des miniatures à l'aide du AWS CLI

1. Assurez-vous que vous avez activé les miniatures dans la chaîne et assurez-vous que la chaîne est en cours d'exécution.

2. Entrez cette commande :

   aws medialive describe-thumbnails --channel-id value --pipeline-id value --thumbnail-type value

   Où :

   channel-id est obligatoire.

   pipeline-idest 0 ou 1. Si vous souhaitez obtenir des miniatures pour les deux pipelines, entrez la commande deux fois.

   thumbnail-type est toujours CURRENT_ACTIVE. Cette option est obligatoire, même si elle ne comporte qu'une seule valeur.

3. La réponse s'affiche à l'écran. Par exemple :

   {
       "ThumbnailDetails": [
           {
               "PipelineId": "0",
               "Thumbnails": [
                   {
                       "Body"base64 string of the JPEG image",
                       "ContentType": "image/jpeg",
                       "ThumbnailType": "CURRENT_ACTIVE",
                       "TimeStamp": "2023-07-15T21:01:11"
                   }
               ]
           }
       ]
   }

   Si les miniatures sont désactivées, la réponse se présente comme suit :

   {
       "ThumbnailDetails": []
   }