

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.

# Transmisión mediante un complemento de GStreamer
<a name="streaming-using-gstreamer-plugin"></a>

**nota**  
La transmisión de vídeo y el análisis masivo de imágenes ya no están disponibles para los nuevos clientes. Para obtener más información, consulte [Cambios en la disponibilidad de las funciones de Amazon Rekognition](rekognition-availability-changes.md).  
**Este cambio no afecta a la disponibilidad de otras funciones de Amazon Rekognition.**

Amazon Rekognition Video puede analizar una transmisión de vídeo en directo desde la cámara de un dispositivo. Para acceder a la entrada multimedia desde la fuente de un dispositivo, debe instalar GStreamer. GStreamer es un software de marco multimedia de terceros que conecta las fuentes multimedia y las herramientas de procesamiento en los flujos de trabajo. También debe instalar el complemento [Amazon Kinesis Video Streams Producer](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) para Gstreamer. En este proceso se presupone que ha configurado correctamente los recursos de Amazon Rekognition Video y Amazon Kinesis. Para obtener más información, consulte [Configuración de los recursos de Amazon Rekognition Video y Amazon Kinesis](setting-up-your-amazon-rekognition-streaming-video-resources.md).

## Paso 1: Instale Gstreamer
<a name="step-1-install-gstreamer"></a>

 Descargue e instale Gstreamer, un software de plataforma multimedia de terceros. Puede usar un software de administración de paquetes como Homebrew ([Gstreamer en Homebrew](https://formulae.brew.sh/formula/gstreamer)) u obtenerlo directamente desde el [sitio web de Freedesktop](https://gstreamer.freedesktop.org/download/). 

 Compruebe que la instalación de Gstreamer se ha realizado correctamente iniciando una transmisión de vídeo con una fuente de prueba desde su terminal de línea de comandos. 

```
$ gst-launch-1.0 videotestsrc ! autovideosink
```

## Paso 2: Instale el complemento Kinesis Video Streams Producer
<a name="step-2-install-kinesis-video-plugin"></a>

 En esta sección, descargará la [biblioteca de Amazon Kinesis Video Streams Producer](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/) e instalará el complemento Kinesis Video Streams Gstreamer. 

 Cree un directorio y clone el código fuente del repositorio GitHub. Asegúrese de incluir el parámetro `--recursive`. 

```
$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp.git
```

Siga las [instrucciones de la biblioteca](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/README.md) para configurar y compilar el proyecto. Asegúrese de utilizar los comandos específicos de la plataforma para su sistema operativo. Utilice el parámetro `-DBUILD_GSTREAMER_PLUGIN=ON` cuando ejecute `cmake` para instalar el complemento Kinesis Video Streams Gstreamer. Este proyecto requiere los siguientes paquetes adicionales que se incluyen en la instalación: GCC o Clang, Curl, Openssl y Log4cplus. Si la compilación falla porque falta un paquete, compruebe que el paquete esté instalado y en su ruta. Si se produce el error «No se puede ejecutar el programa compilado en C» durante la compilación, vuelva a ejecutar el comando build. A veces, no se encuentra el compilador de C correcto. 

 Verifique la instalación del complemento Kinesis Video Streams mediante la ejecución del siguiente comando. 

```
$ gst-inspect-1.0 kvssink
```

 Debería aparecer la siguiente información, como los detalles de fábrica y del plugin: 

```
Factory Details:
  Rank                     primary + 10 (266)
  Long-name                KVS Sink
  Klass                    Sink/Video/Network
  Description              GStreamer AWS KVS plugin
  Author                   AWS KVS <kinesis-video-support@amazon.com>
                
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/
  
  ...
```

## Paso 3: Ejecute Gstreamer con el complemento Kinesis Video Streams
<a name="step-3-run-gstreamer-with-kinesis-video-plugin"></a>

 Antes de empezar a transmitir desde la cámara de un dispositivo a Kinesis Video Streams, puede que necesite convertir la fuente multimedia en un códec aceptable para Kinesis Video Streams. Para determinar las especificaciones y las capacidades de formato de los dispositivos actualmente conectados a su máquina, ejecute el siguiente comando.

```
$ gst-device-monitor-1.0
```

 Para iniciar la transmisión, inicie Gstreamer con el siguiente comando de ejemplo y añada sus credenciales y la información de Amazon Kinesis Video Streams. Debe usar las claves de acceso y la región del rol de servicio de IAM que creó al [conceder a Amazon Rekognition acceso a sus transmisiones de Kinesis.](https://docs.aws.amazon.com/rekognition/latest/dg/api-streaming-video-roles.html#api-streaming-video-roles-all-stream) Para obtener más información acerca de las claves de acceso, consulte [Administración de las claves de acceso de los usuarios de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) en la *Guía del usuario de IAM*. Además, puede ajustar los parámetros de los argumentos del formato de vídeo según lo requiera su uso y estén disponibles en su dispositivo. 

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

 Para ver más comandos de inicio, consulte [Ejemplos de comandos de lanzamiento de GStreamer](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-gstreamer-plugin.html#examples-gstreamer-plugin-launch). 

**nota**  
 Si el comando de lanzamiento termina con un error no relacionado con la negociación, compruebe el resultado del monitor de dispositivos y asegúrese de que los valores del parámetro `videoconvert` corresponden a las capacidades válidas de su dispositivo. 

 Verá una transmisión de vídeo de la cámara de su dispositivo en la transmisión de vídeo de Kinesis después de unos segundos. Para empezar a detectar y comparar rostros con Amazon Rekognition, inicie el procesador de transmisión Amazon Rekognition Video. Para obtener más información, consulte [Descripción general de las operaciones del procesador de transmisión de Amazon Rekognition Video](streaming-video.md#using-rekognition-video-stream-processor). 