

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplo: transmisión desde una fuente RTSP
<a name="examples-rtsp"></a>

[C\+\+](producer-sdk-cpp.md)Contiene una definición para un contenedor [Docker](https://www.docker.com/) que se conecta a una cámara de red del Protocolo de transmisión en tiempo real (RTSP). El uso de Docker estandariza el entorno operativo de Kinesis Video Streams, lo que agiliza la creación y el uso de la aplicación.

El siguiente procedimiento demuestra cómo configurar y utilizar la aplicación de demostración RTSP.

**Topics**
+ [Tutoriales de vídeo](#rtsp-video)
+ [Requisitos previos](#examples-rtsp-prerequisites)
+ [Compilación de la imagen de Docker](#examples-rtsp-build)
+ [Ejecute la aplicación de ejemplo de RTSP](#examples-rtsp-procedure)

## Tutoriales de vídeo
<a name="rtsp-video"></a>

Este vídeo muestra cómo configurar una Raspberry Pi para enviar feeds RTSP a la AWS nube y a Amazon Kinesis Video Streams. Se trata de una demostración end-to-end. 

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


En este vídeo se muestra cómo capturar imágenes de un feed para utilizar la visión artificial y Amazon Rekognition para procesar las imágenes y enviar alertas.




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

Para ejecutar la aplicación de ejemplo RTSP de Kinesis Video Streams, debe disponer de lo siguiente:
+ **Docker:** para obtener información sobre cómo instalar y utilizar Docker, consulte los siguientes enlaces:
  + [Instrucciones de descarga de Docker](https://docs.docker.com/desktop/)
  + [Introducción a Docker](https://docs.docker.com/guides/getting-started/)
+ **Origen cámara de red RTSP:** para obtener más información acerca de las cámaras recomendadas, consulte [Requisitos del sistema](system-requirements.md).

## Compilación de la imagen de Docker
<a name="examples-rtsp-build"></a>

En primer lugar, cree la imagen de Docker en la que se ejecutará la aplicación de demostración.

1. Clone el repositorio de demostraciones de Amazon Kinesis Video Streams.

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

1. Cambie al directorio que contiene el Dockerfile. En este caso, es el directorio [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 el siguiente comando para crear la imagen de Docker. Este comando crea la imagen y la etiqueta como rtspdockertest.

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

1. Ejecute `docker images` y busque el ID de imagen con el que está etiquetado. `rtspdockertest`

   Por ejemplo, en el resultado de ejemplo que aparece a continuación, el `IMAGE ID` es`54f0d65f69b2`.

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

   Lo necesitará en un paso posterior.

## Ejecute la aplicación de ejemplo de RTSP
<a name="examples-rtsp-procedure"></a>

Puede ejecutar la aplicación de ejemplo de RTSP desde dentro o fuera del contenedor de Docker. Siga las instrucciones correspondientes que aparecen a continuación.

**Topics**
+ [Dentro del contenedor Docker](#examples-rtsp-within)
+ [Fuera del contenedor de Docker](#examples-rtsp-outside)

### Dentro del contenedor Docker
<a name="examples-rtsp-within"></a>

**Ejecute la aplicación de ejemplo de RTSP**

1. Inicie el contenedor Docker de Amazon Kinesis Video Streams mediante el siguiente comando:

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

1. Para iniciar la aplicación de muestra, proporcione sus AWS credenciales, el nombre de la transmisión de vídeo de Amazon Kinesis y la URL de la cámara de red RTSP.
**importante**  
Si utiliza credenciales temporales, también tendrá que proporcionar las suyas. `AWS_SESSION_TOKEN` Consulta el segundo ejemplo que aparece a continuación. 

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

   **Credenciales temporales:**

   ```
   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. Inicie sesión en la consola de [Kinesis Video Streams Consola de administración de AWS](https://console.aws.amazon.com//kinesisvideo/home/) y ábrala.

   Vea la transmisión.

1. Para salir del contenedor de Docker, cierra la ventana de la terminal o escribe`exit`.



### Fuera del contenedor de Docker
<a name="examples-rtsp-outside"></a>

Desde **fuera** del contenedor de Docker, usa el siguiente 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}}"
```