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.
# Configuration de vos ressources Vidéo Amazon Rekognition et Amazon Kinesis
Les procédures suivantes décrivent les étapes à suivre pour approvisionner le flux vidéo Kinesis et les autres ressources utilisées pour reconnaître les visages dans une vidéo en streaming.
## Conditions préalables
Pour exécuter cette procédure, vous devez l'avoir AWS SDK pour Java installé. Pour de plus amples informations, veuillez consulter [Premiers pas avec Amazon Rekognition](getting-started.md). L'utilisateur Compte AWS que vous utilisez doit disposer d'autorisations d'accès à l'API Amazon Rekognition. Pour de plus amples informations, veuillez consulter [Actions définies par Amazon Rekognition](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonrekognition.html#amazonrekognition-actions-as-permissions) dans le *Guide de l’utilisateur IAM*.
**Pour reconnaître des visages dans un flux vidéo (AWS SDK)**
1. Si ce n’est pas déjà fait, créez une fonction du service IAM pour permettre à Vidéo Amazon Rekognition d’accéder à vos flux vidéo Kinesis et à vos flux de données Kinesis. Notez l’ARN. Pour de plus amples informations, veuillez consulter [Donner accès aux streams à l'aide de AmazonRekognitionServiceRole](api-streaming-video-roles.md#api-streaming-video-roles-all-stream).
1. [Créez une collection](create-collection-procedure.md) et notez l’identifiant de collection que vous avez utilisé.
1. [Indexez les visages](add-faces-to-collection-procedure.md) à rechercher dans la collection que vous avez créée lors de l’étape 2.
1. [Créez un flux vidéo stream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-createstream.html) et notez l’Amazon Resource Name (ARN) du flux.
1. [Créer un flux de données Kinesis](https://docs.aws.amazon.com/streams/latest/dev/learning-kinesis-module-one-create-stream.html). Ajoutez le nom du flux au début *AmazonRekognition*et notez l'ARN du flux.
Vous pouvez ensuite [créer le processeur de flux de recherche faciale](rekognition-video-stream-processor-search-faces.md#streaming-video-creating-stream-processor) et [démarrer le processeur de flux](rekognition-video-stream-processor-search-faces.md#streaming-video-starting-stream-processor) en utilisant le nom de processeur de flux que vous avez choisi.
**Note**
Vous ne devez démarrer le processeur de diffusion qu’après avoir vérifié que vous pouvez intégrer du contenu multimédia dans le flux vidéo Kinesis.
## Diffusion de vidéos sur Vidéo Amazon Rekognition
Pour diffuser une vidéo dans Vidéo Amazon Rekognition, vous devez utiliser le SDK Amazon Kinesis Video Streams pour créer et utiliser un flux vidéo Kinesis. L’opération `PutMedia` écrit des *fragments* de données vidéo dans un flux vidéo utilisé par Vidéo Amazon Rekognition. Chaque fragment de donnée vidéo dure environ 2–10 secondes et contient une trame d’images vidéo autonome. Vidéo Amazon Rekognition prend en charge les vidéos encodées en H.264, qui peuvent avoir trois types de trames (I, B et P). Pour en savoir plus, consultez [Inter Frame](https://en.wikipedia.org/wiki/Inter_frame). La première trame dans le fragment doit être une I-frame. Une I-frame peut être décodée indépendamment de n’importe quelle autre trame.
Au fur et à mesure que les données arrivent dans le flux vidéo Kinesis, Kinesis Video Streams attribue un numéro unique au fragment. Pour un exemple, voir [Exemple PutMedia d'API](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html).
+ Si vous diffusez à partir d'une source codée en Matroska (MKV), utilisez cette [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)opération pour diffuser la vidéo source dans le flux vidéo Kinesis que vous avez créé. Pour plus d'informations, consultez [PutMedia l'exemple d'API](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html).
+ Si vous diffusez à partir de la caméra d’un appareil, consultez [Streaming à l'aide d'un GStreamer plugin](streaming-using-gstreamer-plugin.md).
# Octroi à Vidéo Amazon Rekognition d’un accès à vos ressources
Vous utilisez un rôle de service Gestion des identités et des accès AWS (IAM) pour donner à Amazon Rekognition Video un accès en lecture aux flux vidéo Kinesis. Si vous utilisez un processeur de flux de recherche faciale, vous utilisez une fonction du service IAM pour autoriser Vidéo Amazon Rekognition à accéder en écriture aux flux de données Kinesis. Si vous utilisez un processeur de flux de surveillance de la sécurité, vous utilisez des rôles IAM pour permettre à Vidéo Amazon Rekognition d’accéder à votre compartiment Amazon S3 et à une rubrique Amazon SNS.
## Octroi d’un accès aux processeurs de flux de recherche faciale
Vous pouvez créer une politique d’autorisation qui autorise Vidéo Amazon Rekognition à accéder à des flux vidéo et à des flux de données Kinesis individuels.
**Pour autoriser Vidéo Amazon Rekognition d’accéder à un processeur de flux de recherche faciale**
1. [ Créez une nouvelle stratégie d’autorisations avec l’éditeur de stratégie IAM JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor), et utilisez la stratégie suivante. Remplacez `video-arn` par l’ARN du flux vidéo Kinesis souhaité. Si vous utilisez un processeur de flux de recherche faciale, remplacez `data-arn` par l’ARN du flux de données Kinesis souhaité.
1. [Créez une fonction du service IAM;](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html?icmpid=docs_iam_console), ou mettez à jour une fonction du service IAM existant. Utilisez les informations suivantes pour créer la fonction du service IAM :
1. Choisissez **Rekognition** pour le nom du service.
1. Choisissez **Rekognition** pour le cas d’utilisation de la fonction de service.
1. Attachez la stratégie d’autorisations que vous avez créée à l’étape 1.
1. Notez l’ARN de la fonction du service. Vous en aurez besoin pour démarrer les opérations d’analyse vidéo.
## Donner accès aux streams à l'aide de AmazonRekognitionServiceRole
Vous pouvez utiliser la politique d’autorisation `AmazonRekognitionServiceRole` comme option alternative pour configurer l’accès aux flux vidéo et aux flux de données Kinesis. IAM présente le cas d’utilisation de la fonction du service *Rekognition* qui, lorsqu’elle est utilisée avec la stratégie d’autorisations `AmazonRekognitionServiceRole`, peut écrire dans plusieurs flux de données Kinesis et lire à partir de tous vos flux de données Kinesis. Pour permettre à Amazon Rekognition Video d'accéder en écriture à plusieurs flux de données Kinesis, vous pouvez ajouter, par exemple, au début des noms des flux de données Kinesis. *AmazonRekognition*`AmazonRekognitionMyDataStreamName`
**Pour autoriser Vidéo Amazon Rekognition à accéder à votre flux vidéo Kinesis et à votre flux de données Kinesis**
1. [Créez une fonction du service IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html?icmpid=docs_iam_console). Utilisez les informations suivantes pour créer la fonction du service IAM :
1. Choisissez **Rekognition** pour le nom du service.
1. Choisissez **Rekognition** pour le cas d’utilisation de la fonction de service.
1. Choisissez la politique **AmazonRekognitionServiceRole**d'autorisation, qui donne à Amazon Rekognition Video un accès en écriture aux flux de données Kinesis préfixés *AmazonRekognition*et un accès en lecture à tous vos flux vidéo Kinesis.
1. Pour garantir votre Compte AWS sécurité, limitez l'étendue de l'accès de Rekognition aux seules ressources que vous utilisez. Pour ce faire, attachez une politique de confiance à votre fonction du service IAM. Pour plus d’informations sur la procédure à utiliser, consultez [Prévention du problème de l’adjoint confus entre services](cross-service-confused-deputy-prevention.md).
1. Notez l’Amazon Resource Name (ARN) de la fonction du service. Vous en aurez besoin pour démarrer les opérations d’analyse vidéo.