Exemple : Streaming depuis une source RTSP

C++Il contient la définition d'un conteneur Docker qui se connecte à une caméra réseau RTSP (Real-Time Streaming Protocol). L'utilisation de Docker normalise l'environnement d'exploitation de Kinesis Video Streams, ce qui rationalise la création et l'utilisation de l'application.

La procédure suivante illustre comment configurer et utiliser l'application de démonstration RTSP.

Didacticiels vidéo

Cette vidéo explique comment configurer un Raspberry Pi pour envoyer des flux RTSP vers le AWS cloud et Amazon Kinesis Video Streams. Il s'agit d'une end-to-end démonstration.

Cette vidéo montre comment capturer des images à partir d'un flux pour utiliser la vision par ordinateur et Amazon Rekognition pour traiter les images et envoyer des alertes.

Prérequis

Pour exécuter l'exemple d'application Kinesis Video Streams RTSP, vous devez disposer des éléments suivants :

• Docker : Pour plus d'informations sur l'installation et l'utilisation de Docker, consultez les liens suivants :

  • Instructions pour télécharger Docker

  • Démarrez avec Docker

• Source de la caméra RTSP en réseau : Pour plus d'informations sur les caméras recommandées, consultez Configuration système requise.

Créez l'image Docker

Créez d'abord l'image Docker dans laquelle l'application de démonstration sera exécutée.

1. Clonez le référentiel de démos d'Amazon Kinesis Video Streams.

   git clone https://github.com/aws-samples/amazon-kinesis-video-streams-demos.git

2. Accédez au répertoire contenant le Dockerfile. Dans ce cas, il s'agit du répertoire docker-rtsp.

   cd amazon-kinesis-video-streams-demos/producer-cpp/docker-rtsp/

3. Utilisez la commande suivante pour créer l'image Docker. Cette commande crée l'image et la balise rtspdockertest.

   docker build -t rtspdockertest .

4. Exécutez docker images et recherchez l'identifiant de l'image marqué avecrtspdockertest.

   Par exemple, dans l'exemple de sortie ci-dessous, le IMAGE ID est54f0d65f69b2.

   REPOSITORY        TAG       IMAGE ID        CREATED           PLATFORM       SIZE         BLOB SIZE
   rtspdockertest    latest    54f0d65f69b2    10 minutes ago    linux/arm64    653.1 MiB    292.4 MiB

   Vous en aurez besoin ultérieurement.

Exécutez l'exemple d'application RTSP

Vous pouvez exécuter l'exemple d'application RTSP à l'intérieur ou à l'extérieur du conteneur Docker. Suivez les instructions appropriées ci-dessous.

Rubriques

• Dans le conteneur Docker

• À l'extérieur du conteneur Docker

Dans le conteneur Docker

Exécutez l'exemple d'application RTSP

1. Démarrez le conteneur Docker Amazon Kinesis Video Streams à l'aide de la commande suivante :

   docker run -it YourImageId /bin/bash

2. Pour démarrer l'exemple d'application, entrez vos informations AWS d'identification, le nom du flux vidéo Amazon Kinesis et l'URL de la caméra réseau RTSP.

   Important

   Si vous utilisez des informations d'identification temporaires, vous devrez également fournir votreAWS_SESSION_TOKEN. Voir le deuxième exemple ci-dessous.

   export AWS_ACCESS_KEY_ID=YourAccessKeyId
   export AWS_SECRET_ACCESS_KEY=YourSecretKeyId
   export AWS_DEFAULT_REGION=YourAWSRegion
   ./kvs_gstreamer_sample YourStreamName YourRtspUrl

   Informations d'identification temporaires :

   export AWS_ACCESS_KEY_ID=YourAccessKeyId
   export AWS_SECRET_ACCESS_KEY=YourSecretKeyId
   export AWS_SESSION_TOKEN=YourSessionToken
   export AWS_DEFAULT_REGION=YourAWSRegion
   ./kvs_gstreamer_sample YourStreamName YourRtspUrl

3. Connectez-vous à la console Kinesis Video Streams AWS Management Console et ouvrez-la.

   Visionnez le stream.

4. Pour quitter le conteneur Docker, fermez la fenêtre du terminal ou tapezexit.

À l'extérieur du conteneur Docker

Depuis l'extérieur du conteneur Docker, utilisez la commande suivante :

docker run -it YourImageId /bin/bash -c "export AWS_ACCESS_KEY_ID=YourAccessKeyId; export AWS_SECRET_ACCESS_KEY=YourSecretKeyId; export AWS_SESSION_TOKEN=YourSessionToken; export AWS_DEFAULT_REGION=Your AWS Region; ./kvs_gstreamer_sample YourStreamName YourRtspUrl"