

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Esempio: streaming da una fonte RTSP
<a name="examples-rtsp"></a>

[C\$1\$1](producer-sdk-cpp.md)Contiene una definizione per un contenitore [Docker](https://www.docker.com/) che si connette a una telecamera di rete RTSP (Real-Time Streaming Protocol). L'uso di Docker standardizza l'ambiente operativo per Kinesis Video Streams, semplificando la creazione e l'utilizzo dell'applicazione.

La procedura seguente illustra come configurare e utilizzare l'applicazione demo di RTSP.

**Topics**
+ [Tutorial video](#rtsp-video)
+ [Prerequisiti](#examples-rtsp-prerequisites)
+ [Crea l'immagine Docker](#examples-rtsp-build)
+ [Esegui l'applicazione di esempio RTSP](#examples-rtsp-procedure)

## Tutorial video
<a name="rtsp-video"></a>

Questo video mostra come configurare un Raspberry Pi per inviare feed RTSP al AWS cloud e ad Amazon Kinesis Video Streams. Questa è una end-to-end dimostrazione. 

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


Questo video dimostra come acquisire immagini da un feed per utilizzare la visione artificiale e Amazon Rekognition per elaborare le immagini e inviare avvisi.




## Prerequisiti
<a name="examples-rtsp-prerequisites"></a>

Per eseguire l'applicazione di esempio RTSP Kinesis Video Streams, è necessario disporre di quanto segue:
+ **Docker:** per informazioni sull'installazione e l'utilizzo di Docker, consulta i seguenti collegamenti:
  + [Istruzioni di download di Docker](https://docs.docker.com/desktop/)
  + [Nozioni di base su Docker](https://docs.docker.com/guides/getting-started/)
+ **Origine videocamera di rete RTSP:** per informazioni sulle videocamere consigliate consulta [Requisiti di sistema](system-requirements.md).

## Crea l'immagine Docker
<a name="examples-rtsp-build"></a>

Innanzitutto, crea l'immagine Docker all'interno della quale verrà eseguita l'applicazione demo.

1. Clona l'archivio demo di Amazon Kinesis Video Streams.

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

1. Passa alla directory contenente il Dockerfile. In questo caso, è la directory [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. Usa il seguente comando per creare l'immagine Docker. Questo comando crea l'immagine e la etichetta come rtspdockertest.

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

1. Esegui `docker images` e cerca l'ID dell'immagine contrassegnato con. `rtspdockertest`

   Ad esempio, nell'output di esempio riportato di seguito, `IMAGE ID` è`54f0d65f69b2`.

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

   Ne avrai bisogno in una fase successiva.

## Esegui l'applicazione di esempio RTSP
<a name="examples-rtsp-procedure"></a>

È possibile eseguire l'applicazione di esempio RTSP dall'interno o dall'esterno del contenitore Docker. Segui le istruzioni appropriate riportate di seguito.

**Topics**
+ [All'interno del contenitore Docker](#examples-rtsp-within)
+ [Fuori dal contenitore Docker](#examples-rtsp-outside)

### All'interno del contenitore Docker
<a name="examples-rtsp-within"></a>

**Esegui l'applicazione di esempio RTSP**

1. Avvia il contenitore Docker Amazon Kinesis Video Streams utilizzando il seguente comando:

   ```
   docker run -it YourImageId /bin/bash
   ```

1. Per avviare l'applicazione di esempio, fornisci AWS le tue credenziali, il nome del flusso video di Amazon Kinesis e l'URL della telecamera di rete RTSP.
**Importante**  
Se utilizzi credenziali temporanee, dovrai fornire anche le tue. `AWS_SESSION_TOKEN` Vedi il secondo esempio riportato di seguito. 

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

   **Credenziali temporanee:**

   ```
   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. Accedi Console di gestione AWS e apri la console [Kinesis Video Streams](https://console.aws.amazon.com//kinesisvideo/home/).

   Visualizza lo stream.

1. Per uscire dal contenitore Docker, chiudi la finestra del terminale o digita`exit`.



### Fuori dal contenitore Docker
<a name="examples-rtsp-outside"></a>

Dall'**esterno** del contenitore Docker, usa il seguente comando:

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