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.
# Utilisation des vidéos streaming
Vous pouvez utiliser Vidéo Amazon Rekognition pour détecter et reconnaître des visages dans des vidéos diffusées en streaming. Vidéo Amazon Rekognition utilise Amazon Kinesis Video Streams pour recevoir et traiter un flux vidéo. Vous créez un processeur de flux avec des paramètres indiquant ce que le processeur de flux doit détecter dans le flux vidéo. Rekognition envoie les résultats de détection d’étiquettes issus d’événements vidéo diffusés en continu sous forme de notifications Amazon SNS et Amazon S3. Rekognition génère les résultats de recherche de visages dans un flux de données Kinesis.
Les processeurs de flux de recherche de visages utilisent `FaceSearchSettings` pour rechercher des visages dans une collection. Pour plus d’informations sur la mise en œuvre de processeurs de flux de recherche de visages pour analyser les visages dans le streaming vidéo, consultez [Recherche de visages dans une collection en vidéo streaming](collections-streaming.md).
Les processeurs de flux de détection d’étiquettes utilisent `ConnectedHomeSettings` pour rechercher des personnes, des packages et des animaux de compagnie dans des événements vidéo en streaming. Pour plus d’informations sur la mise en œuvre des processeurs de flux de détection d’étiquettes, consultez [Détection d’étiquettes dans des événements vidéo en streaming](streaming-video-detect-labels.md).
## Présentation des opérations du processeur de flux Vidéo Amazon Rekognition
Pour démarrer l’analyse d’une vidéo en streaming, lancez un processeur de flux Vidéo Amazon Rekognition et une vidéo en streaming dans Vidéo Amazon Rekognition. Un processeur de flux Vidéo Amazon Rekognition vous permet de démarrer, d’arrêter et de gérer des processeurs de flux. Vous créez un processeur de flux en appelant [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html). Les paramètres de demande pour créer un processeur de flux de recherche de visages incluent les Amazon Resource Names (ARNs) pour le flux vidéo Kinesis, le flux de données Kinesis et l'identifiant de la collection utilisée pour reconnaître les visages dans la vidéo en streaming. Les paramètres de demande pour créer un processeur de flux de surveillance de la sécurité incluent les Amazon Resource Names (ARNs) pour le flux vidéo Kinesis et le sujet Amazon SNS, les types d'objets que vous souhaitez détecter dans le flux vidéo et les informations relatives à un compartiment Amazon S3 pour les résultats de sortie. Ils comprennent également le nom que vous définissez pour le processeur de flux.
Vous commencez le traitement d'une vidéo en appelant l'opération [StartStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartStreamProcessor.html). Pour obtenir des informations sur l'état d'un processeur de flux, appelez [DescribeStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeStreamProcessor.html). Les autres opérations que vous pouvez effectuer consistent [TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource.html)à étiqueter un processeur de flux et [DeleteStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteStreamProcessor.html)à supprimer un processeur de flux. Si vous utilisez un processeur de flux de recherche faciale, vous pouvez également l'utiliser [StopStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopStreamProcessor.html)pour arrêter un processeur de flux. Pour obtenir une liste des processeurs de flux de votre compte, appelez [ListStreamProcessors](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListStreamProcessors.html).
Lorsque le processeur de flux commence à s’exécuter, vous diffusez la vidéo dans Vidéo Amazon Rekognition via le flux vidéo Kinesis que vous avez spécifié dans `CreateStreamProcessor`. Vous pouvez utiliser l'opération du [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)SDK Kinesis Video Streams pour diffuser de la vidéo dans le flux vidéo Kinesis. Pour un exemple, voir [Exemple PutMedia d'API](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html).
Pour plus d’informations sur la manière dont votre application peut utiliser les résultats d’analyse Vidéo Amazon Rekognition à partir d’un processeur de flux de recherche faciale, consultez [Lecture des résultats d’analyse de vidéo en streaming](streaming-video-kinesis-output.md).
# Ajouter des balises à un nouveau processeur de flux
Vous pouvez identifier, organiser, rechercher et filtrer les processeurs de flux Amazon Rekognition à l’aide de balises. Chaque balise est une étiquette composée d’une clé définie par l’utilisateur et d’une valeur.
Vous pouvez ajouter des balises à un processeur de flux lorsque vous le créez à l’aide de l’opération `CreateStreamProcessor`. Spécifiez une ou plusieurs balises dans le paramètre d’entrée du tableau `Tags`. L’exemple suivant est un exemple JSON de requête `CreateStreamProcessor` avec balises.
```
{
"Name": "streamProcessorForCam",
"Input": {
"KinesisVideoStream": {
"Arn": "arn:aws:kinesisvideo:us-east-1:nnnnnnnnnnnn:stream/inputVideo"
}
},
"Output": {
"KinesisDataStream": {
"Arn": "arn:aws:kinesis:us-east-1:nnnnnnnnnnnn:stream/outputData"
}
},
"RoleArn": "arn:aws:iam::nnnnnnnnnnn:role/roleWithKinesisPermission",
"Settings": {
"FaceSearch": {
"CollectionId": "collection-with-100-faces",
"FaceMatchThreshold": 85.5
},
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
```
# Ajouter des balises à un processeur de flux existant
Vous pouvez identifier, organiser, rechercher et filtrer les processeurs de flux Amazon Rekognition à l’aide de balises. Chaque balise est une étiquette composée d’une clé définie par l’utilisateur et d’une valeur.
Pour ajouter une ou plusieurs balises à un processeur de flux existant, utilisez l’opération `TagResource`. Spécifiez l’Amazon Resource Name (ARN) (`ResourceArn`) du processeur de flux et les balises (`Tags`) que vous voulez ajouter. L’exemple suivant vous montre comment ajouter deux balises.
```
aws rekognition tag-resource --resource-arn resource-arn \
--tags '{"key1":"value1","key2":"value2"}'
```
**Note**
Si vous ne connaissez pas le nom de ressource Amazon du processeur de flux, vous pouvez utiliser l’opération `DescribeStreamProcessor`.
# Répertorier les balises dans un processeur de flux
Vous pouvez identifier, organiser, rechercher et filtrer les processeurs de flux Amazon Rekognition à l’aide de balises. Chaque balise est une étiquette composée d’une clé définie par l’utilisateur et d’une valeur.
Pour répertorier les balises associées à un processeur de flux, utilisez l’opération `ListTagsForResource` et spécifiez l’ARN du processeur de flux (`ResourceArn`). La réponse est une carte des clés de balise et des valeurs attachées au processeur de flux spécifié.
```
aws rekognition list-tags-for-resource --resource-arn resource-arn
```
La sortie affiche une liste de balises attachées au processeur de flux :
```
{
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
```
# Supprimer des balises d’un processeur de flux
Vous pouvez identifier, organiser, rechercher et filtrer les processeurs de flux Amazon Rekognition à l’aide de balises. Chaque balise est une étiquette composée d’une clé définie par l’utilisateur et d’une valeur.
Pour supprimer une ou plusieurs balises d’un processeur de flux, utilisez l’opération `UntagResource`. Spécifiez l’ARN du modèle (`ResourceArn`) et les clés de balise (`Tag-Keys`) que vous souhaitez supprimer.
```
aws rekognition untag-resource --resource-arn resource-arn \
--tag-keys '["key1","key2"]'
```
Vous pouvez aussi spécifier les clés de balise dans ce format :
```
--tag-keys key1,key2
```