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.
# Streaming à l'aide d'un GStreamer plugin
Vidéo Amazon Rekognition peut analyser une vidéo diffusée en direct à partir de la caméra d’un appareil. Pour accéder à l'entrée multimédia à partir d'une source de périphérique, vous devez procéder à l'installation GStreamer. GStreamer est un logiciel de framework multimédia tiers qui connecte les sources multimédia et les outils de traitement dans des pipelines de flux de travail. Vous devez également installer le plugin [Amazon Kinesis Video Streams Producer](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) pour Gstreamer. Ce processus suppose que vous avez correctement configuré vos ressources Vidéo Amazon Rekognition et Amazon Kinesis. Pour de plus amples informations, veuillez consulter [Configuration de vos ressources Vidéo Amazon Rekognition et Amazon Kinesis](setting-up-your-amazon-rekognition-streaming-video-resources.md).
## Étape 1 : installer Gstreamer
Téléchargez et installez Gstreamer, un logiciel de plateforme multimédia tiers. Vous pouvez utiliser un logiciel de gestion de paquets tel que Homebrew ([Gstreamer sur Homebrew](https://formulae.brew.sh/formula/gstreamer)) ou vous le procurer directement depuis le [site Web de Freedesktop.](https://gstreamer.freedesktop.org/download/)
Vérifiez la réussite de l’installation de Gstreamer en lançant un flux vidéo avec une source de test depuis votre terminal de ligne de commande.
```
$ gst-launch-1.0 videotestsrc ! autovideosink
```
## Étape 2 : installation du plugin Kinesis Video Streams Producer
Dans cette section, vous allez télécharger la bibliothèque [Amazon Kinesis Video Streams Producer](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) et installer le plugin Kinesis Video Streams Gstreamer.
Créez un répertoire et clonez l’exemple de code source à partir du référentiel GitHub. Assurez-vous d’inclure le paramètre `--recursive`.
```
$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
```
Suivez les [instructions fournies par la bibliothèque](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md) pour configurer et créer le projet. Assurez-vous d’utiliser les commandes spécifiques à la plate-forme pour votre système d’exploitation. Utilisez le paramètre `-DBUILD_GSTREAMER_PLUGIN=ON` lorsque vous exécutez `cmake` pour installer le plug-in Kinesis Video Streams Gstreamer. Ce projet nécessite les packages supplémentaires suivants inclus dans l’installation : GCC ou Clang, Curl, Openssl et Log4CPlus. Si votre compilation échoue à cause d’un package manquant, vérifiez que le package est installé et qu’il figure dans votre PATH. Si vous rencontrez une erreur « Impossible d’exécuter le programme compilé en C » lors de la construction, réexécutez la commande de construction. Parfois, le compilateur C correct n’est pas trouvé.
Vérifiez l’installation du plug-in Kinesis Video Streams en exécutant la commande suivante.
```
$ gst-inspect-1.0 kvssink
```
Les informations suivantes, telles que les informations relatives à l’usine et au plug-in, doivent apparaître :
```
Factory Details:
Rank primary + 10 (266)
Long-name KVS Sink
Klass Sink/Video/Network
Description GStreamer AWS KVS plugin
Author AWS KVS
Plugin Details:
Name kvssink
Description GStreamer AWS KVS plugin
Filename /Users/YOUR_USER/amazon-kinesis-video-streams-producer-sdk-cpp/build/libgstkvssink.so
Version 1.0
License Proprietary
Source module kvssinkpackage
Binary package GStreamer
Origin URL http://gstreamer.net/
...
```
## Étape 3 : Exécuter Gstreamer avec le plug-in Kinesis Video Streams
Avant de commencer le streaming depuis la caméra d’un appareil vers Kinesis Video Streams, vous devrez peut-être convertir la source multimédia en un codec acceptable pour Kinesis Video Streams. Pour déterminer les spécifications et les capacités de formatage des appareils actuellement connectés à votre machine, exécutez la commande suivante.
```
$ gst-device-monitor-1.0
```
Pour commencer le streaming, lancez Gstreamer à l’aide de l’exemple de commande suivant, et ajoutez vos informations d’identification et les informations Amazon Kinesis Video Streams. Vous devez utiliser les clés d’accès et la région correspondant à la fonction du service IAM que vous avez créée lorsque vous autorisez [Amazon Rekognition à accéder à vos flux Kinesis.](https://docs.aws.amazon.com/rekognition/latest/dg/api-streaming-video-roles.html#api-streaming-video-roles-all-stream) Pour de plus amples informations sur les clés d’accès, veuillez consulter [Gestion des clés d’accès pour les utilisateurs IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) dans le *Guide de l’utilisateur IAM*. Vous pouvez également ajuster les paramètres des arguments du format vidéo en fonction de votre utilisation et de leur disponibilité sur votre appareil.
```
$ gst-launch-1.0 autovideosrc device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 !
x264enc bframes=0 key-int-max=45 bitrate=500 ! video/x-h264,stream-format=avc,alignment=au,profile=baseline !
kvssink stream-name="YOUR_STREAM_NAME" storage-size=512 access-key="YOUR_ACCESS_KEY" secret-key="YOUR_SECRET_ACCESS_KEY" aws-region="YOUR_AWS_REGION"
```
Pour plus de commandes de lancement, voir [Exemples de commandes de GStreamer lancement](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-gstreamer-plugin.html#examples-gstreamer-plugin-launch).
**Note**
Si votre commande de lancement se termine par une erreur non liée à la négociation, vérifiez le résultat du Device Monitor, et assurez-vous que les valeurs des paramètres `videoconvert`correspondent aux fonctionnalités valides de votre appareil.
Au bout de quelques secondes, un flux vidéo provenant de la caméra de votre appareil s’affiche sur votre flux vidéo Kinesis. Pour commencer à détecter et à associer des visages avec Amazon Rekognition, démarrez votre processeur de streaming Vidéo Amazon Rekognition. Pour de plus amples informations, veuillez consulter [Présentation des opérations du processeur de flux Vidéo Amazon Rekognition](streaming-video.md#using-rekognition-video-stream-processor).