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 de la vidéo source
AWS Elemental MediaConnect peut générer des vignettes au format JPEG de la vidéo qui se trouve dans la source dans n'importe quel type de flux, à l'exception des flux CDI. La miniature permet de vérifier visuellement que le contenu contient une vidéo. Vous pouvez afficher les miniatures sur la console ou les récupérer par programmation.
## Comment les vignettes sont générées
Lorsque vous avez activé les vignettes dans un flux et que le flux est actif, MediaConnect génère une miniature JPEG avec une résolution de 480 x 270.
Le taux de génération de la miniature est le suivant :
+ Le taux le plus rapide possible est d'une image par seconde.
+ Le débit peut être plus lent en fonction des caractéristiques de la source vidéo. Par exemple, une image toutes les 6 secondes.
## Mode d'affichage des vignettes
Dès que la miniature est générée, elle est MediaConnect affichée sur la page **Détails** du flux, dans la section **Aperçu**.
Cela rend également la miniature disponible sous forme de données binaires en base 64. Vous pouvez utiliser une AWS API pour travailler avec les données binaires par programmation. MediaConnect chiffre les vignettes lors de leur extraction dans la fenêtre d'aperçu de la console ou pendant leur transfert pour les réponses de l'API.
Le taux de récupération des vignettes est le suivant :
+ Le taux de rafraîchissement de la MediaConnect console est toutes les 2 secondes. Si le taux est supérieur au taux de génération, la même miniature est affichée plusieurs fois sur la console.
+ Le taux de récupération de l'API est limité par le [TPS maximal](quotas.md#limits-api). Cette contrainte n'est importante que si vous essayez de récupérer les miniatures de plusieurs flux.
Si vous ne récupérez des vignettes que pour un seul flux, cela ne sert à rien de récupérer les vignettes plus souvent que toutes les secondes (le taux de génération le plus rapide possible).
**Topics**
+ [
## Comment les vignettes sont générées
](#thumbnails-how-generated)
+ [
## Mode d'affichage des vignettes
](#thumbnails-how-displayed)
+ [
# Exigences relatives aux vignettes
](thumbnails-specifications.md)
+ [
## Limite du nombre de vignettes dans MediaConnect
](#thumbnails-api-limits)
+ [
# Activation et affichage des miniatures dans la console
](thumbnails-enable-view-console.md)
+ [
# Activation et récupération de vignettes par programmation
](thumbnails-enable-retrieve-programatically.md)
# Exigences relatives aux vignettes
## Exigences relatives à la source vidéo
MediaConnect Pour générer correctement des vignettes, assurez-vous que la source vidéo répond aux exigences suivantes.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/thumbnails-specifications.html)
## Exigences relatives au flux
Pour générer correctement des miniatures, assurez-vous que votre flux répond aux exigences suivantes.
| Caractéristique du flux | Exigence |
| --- | --- |
| Type de flux prenant en charge les vignettes | Tout type de flux à l'exception des flux CDI. |
| Nombre maximum de sorties pouvant être associées au flux | 10Si le flux dépasse cette limite, aucune miniature MediaConnect ne sera générée pour ce flux. |
| Débit maximal pour toutes les sorties associées au flux | 400 Mbits/sSi le flux dépasse cette limite, aucune miniature MediaConnect ne sera générée pour ce flux. |
## Limite du nombre de vignettes dans MediaConnect
Le nombre de vignettes que vous pouvez afficher ou récupérer est limité. Cette limite est le TPS (transactions par seconde). La fonction de vignettes partage les limites globales pour. MediaConnect Pour en savoir plus, consultez [Limites pour les demandes d'API](quotas.md#limits-api).
# Activation et affichage des miniatures dans la console
Vous activez les miniatures séparément dans chaque flux. Vous pouvez activer les miniatures lorsque vous créez le flux, ou vous pouvez les activer dans un flux existant.
Une fois que vous avez activé les vignettes, elles commencent MediaConnect automatiquement à les générer chaque fois que le flux est actif.
## Activation lors de la création d'un flux
**Dans le flux que vous créez, accédez à la section **Configuration du moniteur source** et déplacez le curseur d'**état des vignettes** sur Activé.**
Lorsque vous lancerez le nouveau flux, vous MediaConnect commencerez à générer des vignettes.
## Activation dans un flux existant
1. Dans la barre de navigation de gauche, choisissez **Flows**. Sélectionnez le flux par son nom.
1. Sur la page **Détails du** flux, choisissez l'onglet **Sources**. Dans la section **Configuration de la surveillance de la source**, choisissez **Modifier**.
1. **Déplacez le curseur d'**état des miniatures** sur **Activé, puis choisissez Mettre** à jour.**
Si le flux est actuellement actif, MediaConnect commence à générer des miniatures. Vous pouvez activer et désactiver les miniatures aussi souvent que vous le souhaitez, lorsque le flux est actif ou inactif.
## Affichage des vignettes
**Lorsque les miniatures sont activées dans un flux actif, il génère MediaConnect automatiquement des miniatures et les affiche sur la page **Détails** du flux, dans la section Aperçu.**
Si le flux devient inactif, l'aperçu des vignettes cesse de s'actualiser. Après quelques secondes, l'aperçu est remplacé par un message.
**Affichage des vignettes de plusieurs flux**
Vous pouvez ouvrir plusieurs instances de la MediaConnect console, une instance pour chaque flux actif. Vous pouvez le faire, mais si vous activez les miniatures dans toutes les instances, l'affichage des miniatures dans une ou plusieurs instances peut poser des problèmes.
Nous vous recommandons d'activer les miniatures sur un seul flux actif à la fois et de les désactiver sur les autres flux actifs.
## Désactiver les vignettes
Vous pouvez désactiver les miniatures sur un flux actif ou inactif. Si le flux est actif, il n'est pas nécessaire de l'arrêter au préalable.
**Accédez à la page **Détails** du flux, choisissez l'onglet **Sources** et déplacez le curseur d'**état des vignettes** sur Désactivé.** Choisissez ensuite **Update (Mettre à jour)**.
# Activation et récupération de vignettes par programmation
Vous pouvez utiliser le AWS CLI pour travailler avec des vignettes par programmation. Les informations suivantes supposent que vous connaissez les principes de base 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/).
Vous activez les miniatures séparément dans chaque flux. Vous pouvez activer les miniatures lorsque vous créez un flux pour la première fois ou vous pouvez les activer dans un flux existant.
Une fois que les vignettes sont actives, elles commencent MediaConnect automatiquement à être générées chaque fois que le flux est actif. Il génère une miniature au maximum une fois par seconde. (Pour plus d'informations sur le taux de génération, voir[Comment les vignettes sont générées](monitor-with-thumbnails.md#thumbnails-how-generated).) Vous pouvez récupérer la dernière miniature générée.
## Activation des vignettes
Utilisez la `UpdateFlow` commande `CreateFlow` ou. Cette commande est représentée différemment dans chaque interface :
+ Dans le AWS CLI, les commandes sont `create-flow` ou`update-flow`.
+ Dans l'API, la commande est `HTTP POST` activée `CreateFlow` ou `HTTP PUT` activée`UpdateFlow`.
+ Dans le AWS SDKs, la commande est représentée par des constructions adaptées à ce langage du SDK.
**Pour activer les miniatures à l'aide de la CLI AWS **
Entrez la `update-flow` commande `create-flow` ou. Cet exemple illustre la `update-flow` commande. Remplacez l'ARN par votre ARN.
```
aws mediaconnect update-flow
--flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow
--source-monitoring-config ThumbnailState=ENABLED
```
## Récupération de vignettes
Pour récupérer des miniatures à l'aide de l'AWS CLI, utilisez la `DescribeFlowSourceThumbnail` commande. Cette commande est représentée différemment dans chaque interface :
+ Dans le AWS CLI, la commande est`describe-flow-source-thumbnail`.
+ Dans l'API, la commande est `HTTP GET` activée`Source-thumbnail`.
+ Dans le AWS SDKs, la commande est représentée par des constructions adaptées à ce langage du SDK.
**Pour récupérer des vignettes à l'aide de la CLI AWS **
Entrez la commande `describe-flow-source-thumbnail`. Remplacez l'ARN par votre ARN.
```
aws mediaconnect describe-flow-source-thumbnail
--flow-arn arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow
```
**La réponse**
La demande donne lieu à un code d'état et à une réponse.
+ **Code d'état 200** : La demande a été traitée avec succès. Cela signifie généralement que la réponse inclut la miniature de la source du flux dans le codage base64.
Toutefois, dans certains cas, le code d'état 200 MediaConnect peut être renvoyé même si une miniature n'a pas pu être récupérée. Dans ces situations, la réponse inclut un message d'erreur expliquant pourquoi la miniature n'a pas pu être générée :
+ `ThumbnailDecodeError`: La source vidéo ne répond pas [aux exigences](thumbnails-specifications.md#thumbnails-source-video-requirements) ou il n'y a aucun trafic entrant sur le flux. Par conséquent, MediaConnect impossible de générer une miniature.
+ `ThumbnailGenerationInProgress`: La miniature est toujours en cours de génération. Patientez quelques secondes et réessayez.
+ `ThumbnailSuppressed`: Cette erreur se produit généralement parce que le processeur et la mémoire requis pour traiter le flux sont actuellement élevés. Si des vignettes MediaConnect sont générées maintenant, la gestion du flux ralentirait. Réessayez après quelques secondes. Si le problème persiste, consultez les informations contenues dans[Exigences relatives au flux](thumbnails-specifications.md#thumbnails-flow-requirements).
+ **Code d'état 202** : La demande est valide, mais le flux MediaConnect est toujours en cours de préparation. Par conséquent, il n'est pas encore possible de générer une miniature. Patientez quelques secondes et réessayez.
+ **Code de statut 4xx :** La demande n'est pas valide.
+ **Code de statut 5xx** : La demande est valide mais MediaConnect n'a pas pu être traitée.