

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.

# Exemple : diffusion en continu depuis une source RTSP
<a name="examples-rtsp"></a>

[C\+\+](producer-sdk-cpp.md)Il contient la définition d'un conteneur [Docker](https://www.docker.com/) 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.

**Topics**
+ [Didacticiels vidéo](#rtsp-video)
+ [Conditions préalables](#examples-rtsp-prerequisites)
+ [Créez l'image Docker](#examples-rtsp-build)
+ [Exécutez l'exemple d'application RTSP](#examples-rtsp-procedure)

## Didacticiels vidéo
<a name="rtsp-video"></a>

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. 

[![AWS Videos](http://img.youtube.com/vi/YoOYTCD_v3Q?si=ajdNXZpRhNnpAOKk/0.jpg)](http://www.youtube.com/watch?v=YoOYTCD_v3Q?si=ajdNXZpRhNnpAOKk)


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.




## Conditions préalables
<a name="examples-rtsp-prerequisites"></a>

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](https://docs.docker.com/desktop/)
  + [Démarrez avec Docker](https://docs.docker.com/guides/getting-started/)
+ **Source de la caméra RTSP en réseau :** Pour plus d'informations sur les caméras recommandées, consultez [Configuration système requise](system-requirements.md).

## Créez l'image Docker
<a name="examples-rtsp-build"></a>

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
   ```

1. Accédez au répertoire contenant le Dockerfile. Dans ce cas, il s'agit du répertoire [docker-rtsp](https://github.com/aws-samples/amazon-kinesis-video-streams-demos/blob/master/producer-cpp/docker-rtsp/).

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

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

   ```
   docker build -t rtspdockertest .
   ```

1. Exécutez `docker images` et recherchez l'identifiant de l'image marqué avec`rtspdockertest`.

   Par exemple, dans l'exemple de sortie ci-dessous, le `IMAGE ID` est`54f0d65f69b2`.

   ```
   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
<a name="examples-rtsp-procedure"></a>

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.

**Topics**
+ [Dans le conteneur Docker](#examples-rtsp-within)
+ [À l'extérieur du conteneur Docker](#examples-rtsp-outside)

### Dans le conteneur Docker
<a name="examples-rtsp-within"></a>

**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
   ```

1. 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 votre`AWS_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}}
   ```

1. Connectez-vous à la console [Kinesis Video Streams AWS Management Console](https://console.aws.amazon.com//kinesisvideo/home/) et ouvrez-la.

   Visionnez le stream.

1. Pour quitter le conteneur Docker, fermez la fenêtre du terminal ou tapez`exit`.



### À l'extérieur du conteneur Docker
<a name="examples-rtsp-outside"></a>

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}}"
```