Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Affichage des vignettes d'entrée
MediaLive peut générer des miniatures pour la vidéo à partir des entrées de vos chaînes. La miniature permet de vérifier visuellement que le contenu contient une vidéo. Vous pouvez afficher les miniatures de chaque canal sur la MediaLive console. Vous pouvez également utiliser l'un des AWS APIs pour travailler avec des vignettes par programmation.
**Comment les vignettes sont générées**
Lorsque vous avez activé les vignettes dans un canal et que celui-ci est en cours d'exécution, MediaLive génère une miniature JPEG toutes les 2 secondes. La miniature n'existe que pendant 2 secondes, jusqu'à ce qu'elle soit remplacée par la miniature suivante. Chaque entrée possède sa propre miniature, ce qui signifie qu'elle MediaLive génère une miniature pour un canal à pipeline unique et deux miniatures pour un canal standard.
Dès que la miniature est générée, elle est affichée sur la console, MediaLive dans la page de détails de la chaîne. Cela rend également la miniature disponible sous forme de données binaires. Vous pouvez utiliser une AWS API pour travailler avec les données binaires par programmation.
**Chiffrement de la miniature**
MediaLive chiffre toujours chaque miniature au fur et à mesure de sa création.
**Topics**
+ [
# Activation des vignettes dans une chaîne
](thumbnails-enable.md)
+ [
# Affichage des miniatures sur la console
](thumbnails-view.md)
+ [
# Récupération de vignettes par programmation
](thumbnails-work-cli.md)
+ [
# Limite du nombre de vignettes dans MediaLive
](thumbnail-limits.md)
# Activation des vignettes dans une chaîne
Vous devez activer la fonction de vignettes dans chacune d'elles. MediaLivechannel
Vous pouvez activer ou désactiver les miniatures uniquement lorsque le canal est inactif (non actif).
**Topics**
+ [
## Fournir un accès IAM
](#thumbnails-enable-iam)
+ [
## Activation des vignettes sur la console
](#thumbnails-enable-console)
+ [
## Activation des vignettes par programmation
](#thumbnails-enable-progammatically)
## Fournir un accès IAM
Pour que la fonctionnalité de vignettes fonctionne, vous devez MediaLive accéder à Amazon S3 :
+ Si votre organisation utilise l'entité de MediaLiveAccessRole confiance, rendez-vous sur la page des **détails du canal et de saisie** de la configuration du canal, puis consultez la section **Informations générales**. Si le bouton **Mettre à jour le rôle** apparaît dans cette section, sélectionnez-le. Si le bouton n'apparaît pas, cela signifie que l'entité de confiance dispose déjà de l'accès dont elle a besoin
+ Si votre organisation utilise des rôles d'entité de confiance personnalisés, un administrateur IAM doit mettre à jour les rôles d'entité de confiance appropriés. Pour plus d'informations sur les opérations à ajouter, lisez[Exigences d'accès pour l'entité de confiance](trusted-entity-requirements.md). Recherchez **thumbnails** sur cette page. Pour plus d'informations sur la façon de mettre à jour le rôle, consultez[Création de l'entité de confiance - option complexe](setup-trusted-entity-complex.md).
## Activation des vignettes sur la console
**Note**
Cette section suppose que vous connaissez les procédures de création ou la modification d'un canal, comme décrit à la section [Création d'un canal de bout en bout](creating-channel-scratch.md).
1. Ouvrez la MediaLive console à l'adresse [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/).
1. Sur la page **Créer une chaîne** ou **Modifier une chaîne**, choisissez **Paramètres généraux**, puis ouvrez la section **Configuration des miniatures**.
1. Sélectionnez **Activer la configuration des vignettes**. Dans **État**, sélectionnez **AUTO** ou **DISABLED**.
## Activation des vignettes par programmation
Pour activer la fonctionnalité de vignettes, incluez le `ThumbnailConfiguration` groupe de paramètres dans le JSON du canal. Définissez le `State` paramètre sur `AUTO` (pour activer) ou`DISABLED`.
L'exemple suivant montre l'emplacement relatif des paramètres dans le JSON pour le canal.
```
{
"ChannelClass": "SINGLE_PIPELINE",
.
.
.
"EncoderSettings": {
.
.
.
"TimecodeConfig": {
"Source": "EMBEDDED"
},
"ThumbnailConfiguration": {
"State": "DISABLED"
},
.
.
.
```
# Affichage des miniatures sur la console
Lorsque les vignettes sont activées, MediaLive gé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.
1. Ouvrez la MediaLive console à l'adresse [https://console.aws.amazon.com/medialive/](https://console.aws.amazon.com/medialive/).
1. Choisissez **Channels** dans la barre de navigation. Dans la liste des chaînes, sélectionnez la chaîne par son nom. La page Détails apparaît.
La section **État** inclut un cadre miniature. Si le canal possède deux entrées, l'écran inclut un onglet pour chaque entrée.
Lorsque le canal est en cours d'exécution et que la page Détails s'affiche, la miniature est automatiquement mise à jour toutes les 2 secondes, pour le pipeline dans l'onglet actif. MediaLive ne génère aucune miniature si cette page n'est pas affichée.
Si la chaîne ne fonctionne pas, le cadre est noir.
Si la chaîne cesse de fonctionner, l'aperçu des miniatures cesse d'être mis à jour. Après quelques secondes, la miniature actuelle est remplacée par un message.
# Récupération de vignettes par programmation
Lorsque la fonctionnalité de vignettes est activée, elle MediaLive gé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 du AWS CLI. Pour plus d'informations sur les principes de base, consultez le manuel de [référence des AWS CLI commandes](https://docs.aws.amazon.com/cli/latest/reference/).
Utilisez la commande `DescribeThumbnails`. Cette commande est représentée différemment dans chaque interface :
+ Dans le 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 le AWS SDKs, la commande est représentée par des constructions adaptées à ce langage du SDK.
**Pour récupérer des miniatures à l'aide du AWS CLI**
1. Assurez-vous que vous avez [activé les vignettes dans le canal](thumbnails-enable.md) et assurez-vous que le canal fonctionne.
1. Entrez cette commande :
**aws medialive describe-thumbnails --channel-id *value* --pipeline-id *value* --thumbnail-type *value* **
Où :
`channel-id` est obligatoire.
`pipeline-id`vaut 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 n'a qu'une seule valeur.
1. 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 est la suivante :
```
{
"ThumbnailDetails": []
}
```
# Limite du nombre de vignettes dans MediaLive
Le nombre de documents MediaLivethumbnails que vous pouvez consulter ou récupérer est limité. La limite est la suivante :
`A number of API transactions per second, per account, in one Region`
La limite de transactions est partagée par toutes les miniatures : celles que vous affichez sur la console et celles que vous récupérez à l'aide d'une AWS API. Pour connaître la limite actuelle, consultez la MediaLive page de la console [Service Quotas](https://console.aws.amazon.com/servicequotas/home?region=us-east-1#!/services/medialive/quotas).
Sur la console, une miniature est générée pour un canal uniquement lorsque la page de détails du canal est affichée, et uniquement dans l'onglet actif (c'est-à-dire pour un seul pipeline du canal). Pour les pipelines concernés, MediaLive effectue un appel à l'API toutes les 2 secondes environ.