Streaming à l’aide d’un plugin GStreamer

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 depuis une source de périphérique, vous devez installer GStreamer. GStreamer est un logiciel infrastructure 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 pour Gstreamer. Ce processus suppose que vous avez correctement configuré vos ressources Vidéo Amazon Rekognition et Amazon Kinesis. Pour plus d’informations, consultez Configuration de vos ressources Vidéo Amazon Rekognition et Amazon Kinesis.

É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) ou vous le procurer directement depuis le site Web de Freedesktop.

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 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 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 <[e-mail]>
                
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. 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 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 lancement de GStreamer.

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 videoconvertcorrespondent 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 plus d’informations, consultez Présentation du fonctionnement du processeur de flux vidéo Amazon Rekognition.