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: complemento del GStreamer SDK para productores de Kinesis Video Streams: kvssink En este tema se describe cómo crear el SDK para productores de Amazon Kinesis Video Streams para usarlo como GStreamer complemento. **Topics** + [Descargue, cree y configure el GStreamer elemento](#examples-gstreamer-plugin-download) + [Ejecuta el elemento GStreamer](#examples-gstreamer-plugin-run) + [Ejemplos de comandos de lanzamiento GStreamer](#examples-gstreamer-plugin-launch) + [Ejecute el GStreamer elemento en un contenedor de Docker](#examples-gstreamer-plugin-docker) + [GStreamer referencia de parámetros de elementos](examples-gstreamer-plugin-parameters.md) [GStreamer](https://gstreamer.freedesktop.org/)es un marco multimedia popular que utilizan varias cámaras y fuentes de vídeo para crear canales multimedia personalizados mediante la combinación de complementos modulares. El complemento Kinesis Video GStreamer Streams agiliza la integración de su canal multimedia GStreamer existente con Kinesis Video Streams. Tras la integración GStreamer, puede transmitir vídeo desde una cámara web o una cámara del Protocolo de Transmisión en Tiempo Real (RTSP) a Kinesis Video Streams para reproducirlo, almacenarlo y analizarlo en tiempo real o posteriormente. El GStreamer complemento gestiona automáticamente la transferencia de su transmisión de vídeo a Kinesis Video Streams al encapsular la funcionalidad proporcionada por el SDK para productores de Kinesis Video Streams GStreamer en un elemento receptor,. `kvssink` El GStreamer marco proporciona un entorno gestionado estándar para crear el flujo de contenido multimedia desde un dispositivo, como una cámara u otra fuente de vídeo, para su posterior procesamiento, renderización o almacenamiento. La GStreamer canalización suele consistir en el enlace entre una fuente (cámara de vídeo) y el elemento receptor (ya sea un reproductor para renderizar el vídeo o un almacenamiento para recuperarlo sin conexión a Internet). En este ejemplo, se utiliza el elemento SDK Producer como *receptor* o destino multimedia, para su fuente de vídeo (cámara web o cámara IP). El elemento del complemento que encapsula el SDK envía entonces la transmisión de vídeo a Kinesis Video Streams. En este tema se describe cómo crear una canalización GStreamer multimedia capaz de transmitir vídeo desde una fuente de vídeo, como una cámara web o una transmisión RTSP, normalmente conectada a Kinesis Video Streams a través de etapas de codificación intermedias (mediante codificación H.264). Cuando la transmisión de vídeo esté disponible como transmisión de vídeo de Kinesis, podrá utilizarla [Vea la salida de las cámaras mediante la biblioteca de analizadores](parser-library.md) para seguir procesando, reproduciendo, almacenando o analizando la transmisión de vídeo. ![\[Vista funcional del canal GStreamer multimedia para la transmisión de vídeo desde una cámara al servicio.\]](http://docs.aws.amazon.com/es_es/kinesisvideostreams/latest/dg/images/gstreamer-pipeline.png) ## Descargue, cree y configure el GStreamer elemento El ejemplo del GStreamer complemento se incluye en el SDK para productores de Kinesis Video Streams C\$1\$1. Para obtener información acerca de los requisitos de SDK y de la descarga, consulte [Descargue y configure el código de la biblioteca del productor de C\$1\$1](producersdk-cpp-download.md). Puedes crear el receptor del SDK del GStreamer productor como una biblioteca dinámica en macOS, Ubuntu, Raspberry Pi o Windows. El GStreamer complemento se encuentra en tu `build` directorio. Para cargar este complemento, debe estar en su`GST_PLUGIN_PATH`. Use el siguiente comando: ``` export GST_PLUGIN_PATH=`pwd`/build ``` **nota** En macOS, solo puede transmitir vídeo desde una cámara de red cuando se ejecuta GStreamer en un contenedor Docker. No es compatible el streaming de vídeo desde una cámara USB en macOS en un contenedor de Docker. ## Ejecuta el elemento GStreamer Para ejecutar GStreamer con el elemento SDK del productor de Kinesis Video Streams como receptor, utilice `gst-launch-1.0` el comando. Utilice los elementos originales que sean adecuados para el GStreamer complemento que vaya a utilizar. Por ejemplo, [v4l2src](https://gstreamer.freedesktop.org/documentation/video4linux2/v4l2src.html?gi-language=c#v4l2src-page) para dispositivos v4l2 en sistemas Linux o [rtspsrc](https://gstreamer.freedesktop.org/documentation/rtsp/rtspsrc.html#rtspsrc-page) para dispositivos RTSP. Especifique `kvssink` como receptor (destino final de la canalización) para enviar vídeo al SDK Producer. Además de [proporcionar credenciales](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html#credentials-to-kvssink) y [proporcionar una región](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html#kvssink-region), el `kvssink` elemento tiene el siguiente parámetro obligatorio: + `stream-name`— El nombre del Kinesis Video Streams de destino. Para obtener información acerca de los parámetros opcionales `kvssink`, consulte [GStreamer referencia de parámetros de elementos](examples-gstreamer-plugin-parameters.md). Para obtener la información más reciente sobre los GStreamer complementos y los parámetros, consulte [GStreamer Complementos](https://gstreamer.freedesktop.org/documentation/plugins_doc.html?gi-language=c). También puedes usar el `gst-inspect-1.0` comando seguido del nombre de un GStreamer elemento o complemento para imprimir su información y comprobar que está disponible en tu dispositivo: ``` gst-inspect-1.0 kvssink ``` Si la compilación `kvssink` ha fallado o GST\$1PLUGIN\$1PATH no está configurado correctamente, el resultado tendrá un aspecto similar al siguiente: ``` No such element or plugin 'kvssink' ``` ## Ejemplos de comandos de lanzamiento GStreamer Los siguientes ejemplos muestran cómo usar el `kvssink` GStreamer complemento para transmitir vídeo desde diferentes tipos de dispositivos. ### Ejemplo 1: Transmitir vídeo desde una cámara RTSP en Ubuntu El siguiente comando crea una GStreamer canalización en Ubuntu que transmite desde una cámara RTSP de red mediante el complemento [ GStreamer rtspsrc](https://gstreamer.freedesktop.org/documentation/rtsp/rtspsrc.html?gi-language=c): ``` gst-launch-1.0 -v rtspsrc location="rtsp://YourCameraRtspUrl" short-header=TRUE ! rtph264depay ! h264parse ! kvssink stream-name="YourStreamName" storage-size=128 ``` ### Ejemplo 2: Codifique y transmita vídeo desde una cámara USB en Ubuntu El siguiente comando crea una GStreamer canalización en Ubuntu que codifica la transmisión desde una cámara USB en formato H.264 y la transmite a Kinesis Video Streams. [En este ejemplo se utiliza el complemento v4l2src.](https://gstreamer.freedesktop.org/documentation/video4linux2/v4l2src.html?gi-language=c#v4l2src-page) GStreamer ``` gst-launch-1.0 v4l2src do-timestamp=TRUE 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="YourStreamName" storage-size=512 access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion" ``` ### Ejemplo 3: Transmite vídeo precodificado desde una cámara USB en Ubuntu El siguiente comando crea una GStreamer canalización en Ubuntu que transmite vídeo que la cámara ya ha codificado en formato H.264 a Kinesis Video Streams. En este ejemplo se utiliza el complemento [ GStreamer v4l2src](https://gstreamer.freedesktop.org/documentation/video4linux2/v4l2src.html?gi-language=c#v4l2src-page). ``` gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! h264parse ! video/x-h264,stream-format=avc,alignment=au ! kvssink stream-name="plugin" storage-size=512 access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion" ``` ### Ejemplo 4: Transmitir vídeo desde una cámara de red en macOS El siguiente comando crea una GStreamer canalización en macOS que transmite vídeo a Kinesis Video Streams desde una cámara de red. En este ejemplo se utiliza el complemento [rtspsrc](https://gstreamer.freedesktop.org/documentation/rtsp/rtspsrc.html#rtspsrc-page) GStreamer . ``` gst-launch-1.0 rtspsrc location="rtsp://YourCameraRtspUrl" short-header=TRUE ! rtph264depay ! h264parse ! video/x-h264, format=avc,alignment=au ! kvssink stream-name="YourStreamName" storage-size=512 access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion" ``` ### Ejemplo 5: Transmita vídeo desde una cámara de red en Windows El siguiente comando crea una GStreamer canalización en Windows que transmite vídeo a Kinesis Video Streams desde una cámara de red. En este ejemplo se utiliza el complemento [rtspsrc](https://gstreamer.freedesktop.org/documentation/rtsp/rtspsrc.html#rtspsrc-page) GStreamer . ``` gst-launch-1.0 rtspsrc location="rtsp://YourCameraRtspUrl" short-header=TRUE ! rtph264depay ! video/x-h264, format=avc,alignment=au ! kvssink stream-name="YourStreamName" storage-size=512 access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion" ``` ### Ejemplo 6: Transmite vídeo desde una cámara de Raspberry Pi El siguiente comando crea una GStreamer canalización en Raspberry Pi que transmite vídeo a Kinesis Video Streams. En este ejemplo se utiliza el complemento [ GStreamer v4l2src](https://gstreamer.freedesktop.org/documentation/video4linux2/v4l2src.html?gi-language=c#v4l2src-page). ``` gst-launch-1.0 v4l2src do-timestamp=TRUE device=/dev/video0 ! videoconvert ! video/x-raw,format=I420,width=640,height=480,framerate=30/1 ! omxh264enc control-rate=1 target-bitrate=5120000 periodicity-idr=45 inline-header=FALSE ! h264parse ! video/x-h264,stream-format=avc,alignment=au,width=640,height=480,framerate=30/1,profile=baseline ! kvssink stream-name="YourStreamName" access-key="YourAccessKey" secret-key="YourSecretKey" aws-region="YourAWSRegion" ``` ### Ejemplo 7: Transmite audio y vídeo en Raspberry Pi y Ubuntu Descubra cómo [ejecutar el comando gst-launch-1.0 para comenzar el streaming de audio y vídeo en Raspberry-PI y Ubuntu](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/docs/linux.md#running-the-gst-launch-10-command-to-start-streaming-both-audio-and-video-in-raspberry-pi-and-ubuntu). ### Ejemplo 8: Transmite audio y vídeo desde las fuentes del dispositivo en macOS Descubra cómo [ejecutar el comando gst-launch-1.0 para comenzar el streaming de audio y vídeo en MacOS](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/docs/macos.md#running-the-gst-launch-10-command-to-start-streaming-both-audio-and-raw-video-in-mac-os). ### Ejemplo 9: Cargue un archivo MKV que contenga audio y vídeo Descubra cómo [ejecutar el comando gst-launch-1.0 para cargar un archivo MKV que contenga audio y vídeo](https://github.com/awslabs/amazon-kinesis-video-streams-producer-sdk-cpp/blob/master/docs/windows.md#running-the-gst-launch-10-command-to-upload-mkv-file-that-contains-both-audio-and-video). Necesitará un archivo de prueba MKV con contenido multimedia codificado en H.264 y AAC. ## Ejecute el GStreamer elemento en un contenedor de Docker Docker es una plataforma para desarrollar, implementar y ejecutar aplicaciones utilizando contenedores. El uso de Docker para crear la GStreamer canalización estandariza el entorno operativo de Kinesis Video Streams, lo que agiliza la creación y el uso de la aplicación. Para instalar y configurar Docker, consulte lo siguiente: + [Instrucciones de descarga de Docker](https://docs.docker.com/engine/install/) + [Introducción a Docker](https://docs.docker.com/guides/getting-started/) Tras instalar Docker, puede descargar el SDK ( GStreamer y el complemento) para C\$1\$1 Producer de Kinesis Video Streams desde Amazon Elastic Container Registry mediante uno de los comandos que se proporcionan a continuación`docker pull`. Para ejecutar GStreamer el elemento del SDK del productor de Kinesis Video Streams como sumidero en un contenedor de Docker, haga lo siguiente: **Topics** + [Autentique su cliente de Docker](#examples-gstreamer-plugin-docker-authenticate) + [Descargue la imagen de Docker para Ubuntu, macOS, Windows o Raspberry Pi](#examples-gstreamer-plugin-docker-download) + [Ejecute la imagen de Docker](#examples-gstreamer-plugin-docker-run) ### Autentique su cliente de Docker Autentique su cliente de Docker en el registro de Amazon ECR del que va a extraer la imagen. Debe obtener los tokens de autenticación para cada registro utilizado. Los tokens son válidos durante 12 horas. Para obtener más información, consulte [Autenticación de registros](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth) en la *Guía del usuario de Amazon Elastic Container Registry*. **Example : autenticación con Amazon ECR** Para autenticarse con Amazon ECR, copie y pegue el siguiente comando como se muestra. ``` sudo aws ecr get-login-password --region us-west-2 | docker login -u AWS --password-stdin https://546150905175.dkr.ecr.us-west-2.amazonaws.com ``` Si la acción se realiza correctamente, se muestra el texto `Login Succeeded` (Inicio de sesión correcto). ### Descargue la imagen de Docker para Ubuntu, macOS, Windows o Raspberry Pi Descargue la imagen de Docker en su entorno de Docker con uno de los siguientes comandos, en función de su sistema operativo: #### Descargue la imagen de Docker para Ubuntu ``` sudo docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux:latest ``` #### Descargue la imagen de Docker para macOS ``` docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux:latest ``` #### Descargue la imagen de Docker para Windows ``` docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-windows:latest ``` #### Descargue la imagen de Docker para Raspberry Pi ``` sudo docker pull 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-raspberry-pi:latest ``` Para comprobar que la imagen se ha agregado correctamente, utilice el comando siguiente: ``` docker images ``` ### Ejecute la imagen de Docker Utilice uno de los comandos siguientes para ejecutar la imagen de Docker, en función de su sistema operativo: #### Ejecute la imagen de Docker en Ubuntu ``` sudo docker run -it --network="host" --device=/dev/video0 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux /bin/bash ``` #### Ejecuta la imagen de Docker en macOS ``` sudo docker run -it --network="host" 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-amazon-linux /bin/bash ``` #### Ejecute la imagen de Docker en Windows ``` docker run -it 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-windows AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY RTSP_URL STREAM_NAME ``` #### Ejecute la imagen de Docker en Raspberry Pi ``` sudo docker run -it --device=/dev/video0 --device=/dev/vchiq -v /opt/vc:/opt/vc 546150905175.dkr.ecr.us-west-2.amazonaws.com/kinesis-video-producer-sdk-cpp-raspberry-pi /bin/bash ``` Docker lanza el contenedor y le presenta una línea de comandos para usar los comandos dentro del contenedor. En el contenedor, establezca las variables de entorno utilizando el siguiente comando: ``` export LD_LIBRARY_PATH=/opt/awssdk/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$LD_LIBRARY_PATH export PATH=/opt/awssdk/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/bin:$PATH export GST_PLUGIN_PATH=/opt/awssdk/amazon-kinesis-video-streams-producer-sdk-cpp/kinesis-video-native-build/downloads/local/lib:$GST_PLUGIN_PATH ``` Comience a transmitir y `kvssink` utilice el `gst-launch-1.0` para ejecutar una canalización adecuada para su dispositivo y fuente de vídeo. Para ver, por ejemplo, canalizaciones, consulte[Ejemplos de comandos de lanzamiento GStreamer](#examples-gstreamer-plugin-launch). # GStreamer referencia de parámetros de elementos *Para enviar un vídeo al SDK de C\$1\$1 para productores de Amazon Kinesis Video Streams, debe `kvssink` especificarlo como destino final o destino final de la canalización.* Esta referencia proporciona información sobre parámetros `kvssink` obligatorios y opcionales. Para obtener más información, consulte [Ejemplo: complemento del GStreamer SDK para productores de Kinesis Video Streams: kvssink](examples-gstreamer-plugin.md). **Temas** + [Proporcione las credenciales a `kvssink`](#credentials-to-kvssink) + [Proporcione una región a `kvssink`](#kvssink-region) + [`kvssink`parámetros opcionales](#kvssink-optional-parameters) ## Proporcione las credenciales a `kvssink` Para permitir que el `kvssink` GStreamer elemento realice solicitudes AWS, proporcione AWS las credenciales que utilizará cuando llame al servicio Amazon Kinesis Video Streams. La cadena de proveedores de credenciales busca las credenciales en el siguiente orden: ### 1. AWS IoT credenciales Para configurar AWS IoT las credenciales, consulte[Control del acceso a los recursos de Kinesis Video Streams mediante AWS IoT](how-iot.md). El valor del `iot-credentials` parámetro debe empezar por `iot-certificate,` e ir seguido de una lista separada por comas de los siguientes pares *key* =*value*. **** | Key | Obligatorio | Descripción | | --- | --- | --- | | ca-path | Sí | Ruta del archivo al certificado de CA utilizado para establecer la confianza con el servicio de backend a través de TLS. **Example** **Ejemplo**: ` /file/path/to/certificate.pem` | | cert-path | Sí | Ruta del archivo al certificado X.509. **Example** **Ejemplo**: `/file/path/to/certificateID-certificate.pem.crt` | | endpoint | Sí | El punto de conexión del proveedor de AWS IoT Core credenciales de su cuenta. AWS Consulte la [guía AWS IoT para desarrolladores](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html). **Example** **Ejemplo**: `credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com` | | key-path | Sí | Ruta del archivo a la clave privada utilizada en el public/private key pair. **Example** **Ejemplo**: `/file/path/to/certificateID-private.pem.key` | | role-aliases | Sí | El nombre del alias del rol que apunta al rol de AWS IAM que se va a usar al conectarse AWS IoT Core. **Example** **Ejemplo**: `KvsCameraIoTRoleAlias` | | iot-thing-name | No | La `iot-thing-name` es opcional. Si no `iot-thing-name` se proporciona, se utiliza el valor del `stream-name` parámetro. **Example** **Ejemplo**: `kvs_example_camera` | **Example** **Ejemplo:** ``` gst-launch-1.0 -v ... ! kvssink stream-name="YourStream" aws-region="YourRegion" iot-certificate="iot-certificate,endpoint=credential-account-specific-prefix.credentials.iot.aws-region.amazonaws.com,cert-path=certificateID-certificate.pem.crt,key-path=certificateID-private.pem.key,ca-path=certificate.pem,role-aliases=YourRoleAlias,iot-thing-name=YourThingName" ``` ### 2. Variables de entorno Para poder `kvssink` utilizar las credenciales del entorno, defina las siguientes variables de entorno: **** | Nombre de la variable de entorno | Obligatorio | Descripción | | --- | --- | --- | | AWS\$1ACCESS\$1KEY\$1ID | Sí | La clave de AWS acceso que se utiliza para acceder a Amazon Kinesis Video Streams. | | AWS\$1SECRET\$1ACCESS\$1KEY | Sí | La clave AWS secreta asociada a la clave de acceso. | | AWS\$1SESSION\$1TOKEN | No | Especifica el valor del token de sesión necesario si utiliza credenciales de seguridad temporales directamente de AWS STS las operaciones. | La configuración de la variable de entorno cambia el valor usado hasta el final de su sesión del intérprete de comandos o hasta que otorgue a la variable un valor diferente. Para que las variables sean persistentes en futuras sesiones, configúrelas en el script de inicio de su shell. ### 3. `access-key`, `secret-key` parámetros Para especificar las credenciales directamente como `kvssink` parámetro, defina los siguientes parámetros: **** | `kvssink`Nombre del parámetro | Obligatorio | Descripción | | --- | --- | --- | | access-key | Sí | La clave de AWS acceso que se utiliza para acceder a Amazon Kinesis Video Streams. | | secret-key | Sí | La clave AWS secreta asociada a la clave de acceso. | | session-token | No | Especifica el valor del token de sesión necesario si utiliza credenciales de seguridad temporales directamente de AWS STS las operaciones. | **Example** **Uso de credenciales estáticas:** ``` gst-launch-1.0 -v ... ! kvssink stream-name="YourStream" aws-region="YourRegion" access-key="AKIDEXAMPLE" secret-key="SKEXAMPLE" ``` **Example** **Uso de credenciales temporales:** ``` gst-launch-1.0 -v ... ! kvssink stream-name="YourStream" aws-region="YourRegion" access-key="AKIDEXAMPLE" secret-key="SKEXAMPLE" session-token="STEXAMPLE" ``` ### 4. Archivo de credenciales **importante** Si ha seleccionado uno de los métodos anteriores, no podrá usar el `credential-path` `kvssink` parámetro. **** | `kvssink`Nombre del parámetro | Obligatorio | Descripción | | --- | --- | --- | | credential-path | Sí | Ruta al archivo de texto que contiene las credenciales en un formato específico. | El archivo de texto debe contener credenciales en uno de los siguientes formatos: + CREDENCIALES *YourAccessKey* *YourSecretKey* + CREDENCIALES *YourAccessKey* *Expiration* *YourSecretKey* *SessionToken* **Example** **Ejemplo:** el `credentials.txt` archivo se encuentra en `/home/ubuntu` y contiene lo siguiente: `CREDENTIALS AKIDEXAMPLE 2023-08-10T22:43:00Z SKEXAMPLE STEXAMPLE` Para usarlo en`kvssink`, escriba: ``` gst-launch-1.0 -v ... ! kvssink stream-name="YourStream" aws-region="YourRegion" credential-path="/home/ubuntu/credentials.txt" ``` El tiempo de caducidad debería ser de al menos 5 \$1 30 \$1 3 = **38** segundos en el futuro. El período de gracia se define como la `IOT_CREDENTIAL_FETCH_GRACE_PERIOD` variable en [https://github.com/awslabs/amazon-kinesis-video-streams-producer-c/blob/master/src/source/Common/IotCredentialProvider.h](https://github.com/awslabs/amazon-kinesis-video-streams-producer-c/blob/master/src/source/Common/IotCredentialProvider.h). Si las credenciales están muy cerca de caducar al empezar`kvssink`, recibirá el código de error`0x52000049 - STATUS_INVALID_TOKEN_EXPIRATION`. `kvssink`no modifica el archivo de credenciales. Si utiliza credenciales temporales, una fuente externa debe actualizar el archivo de credenciales antes de la fecha de caducidad menos el período de gracia. ## Proporcione una región a `kvssink` El orden de búsqueda de las regiones es el siguiente: 1. `AWS_DEFAULT_REGION`la variable de entorno se revisa primero. Si está establecida, esa región se usa para configurar el cliente. 1. `aws-region`El parámetro se revisa a continuación. Si está establecido, esa región se usa para configurar el cliente. 1. Si no se ha utilizado ninguno de los métodos anteriores, el `kvssink` valor predeterminado es. `us-west-2` ## `kvssink`parámetros opcionales El elemento `kvssink` tiene los siguientes parámetros opcionales. Para obtener más información sobre estos parámetros, consulte [Estructuras de transmisión de vídeo de Kinesis](producer-reference-structures-stream.md). **** | Parámetro | Description (Descripción) | Unidad/tipo | Predeterminado | | --- | --- | --- | --- | | stream-name | El nombre de la transmisión de vídeo de Amazon Kinesis de destino. Si no se especifica ningún nombre de transmisión, se utilizará el nombre de transmisión predeterminado: «DEFAULT\$1STREAM». Si aún no existe una transmisión con ese nombre predeterminado, se creará. | | | | absolute-fragment-times | Si se utilizan tiempos de fragmentos absolutos. | Booleano | true | | access-key | La clave de AWS acceso que se utiliza para acceder a Kinesis Video Streams. Debe tener AWS configuradas las credenciales o proporcionar este parámetro. Para proporcionar esta información, escriba lo siguiente: 
export AWS_ACCESS_KEY_ID=
| | | | avg-bandwidth-bps | El ancho de banda medio previsto para la secuencia. | Bits por segundo | 4194304 | | aws-region | El que Región de AWS se va a usar. También puede proporcionar la variable de `AWS_DEFAULT_REGION` entorno a la región. Las variables de entorno tienen prioridad si se establecen los parámetros de la variable de entorno y kvssink. La región se establecerá de forma predeterminada `us-west-2` si no se especifica lo contrario. | Cadena | "us-west-2" | | buffer-duration | La duración del búfer de la secuencia. | Segundos | 120 | | codec-id | El ID del códec de la secuencia. | Cadena | "V\$1MPEG4/ISO/AVC" | | connection-staleness | El tiempo transcurrido, al que se denomina devolución de señal por inactividad de la transmisión. | Segundos | 60 | | content-type | El tipo de contenido de la secuencia. | Cadena | "video/h264" | | fragment-acks | Si se debe usar el fragmento. ACKs | Booleano | true | | fragment-duration | La duración del fragmento que desea. | Milisegundos | 2000 | | framerate | La velocidad de fotogramas prevista. | Fotogramas por segundo | 25 | | frame-timecodes | Si se utilizan códigos de tiempo de fotograma o se generan marcas de tiempo utilizando la devolución de llamada de tiempo actual. | Booleano | true | | key-frame-fragmentation | Si se producen fragmentos en un fotograma clave. | Booleano | true | | log-config | La ruta de configuración de registro. | Cadena | "../kvs\$1log\$1configuration" | | max-latency | La latencia máxima de la secuencia. | Segundos | 60 | | recalculate-metrics | Si se vuelven a calcular las métricas. | Booleano | true | | replay-duration | La duración para restaurar el lector actual para reproducir durante un error si está habilitada la reactivación. | Segundos | 40 | | restart-on-error | Si se reinicia cuando se produce un error. | Booleano | true | | retention-period | El periodo de tiempo que se mantiene la secuencia. | Horas | 2 | | rotation-period | El período de rotación de claves. Para obtener más información, consulte [AWS KMS Teclas giratorias](https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html). | Segundos | 3600 | | secret-key | La clave AWS secreta que se usa para acceder a Kinesis Video Streams. Debe tener AWS configuradas las credenciales o proporcionar este parámetro. 
export AWS_SECRET_ACCESS_KEY=
| | | | session-token | Especifica el valor del token de sesión necesario si utiliza credenciales de seguridad temporales directamente de AWS STS las operaciones. | | | | storage-size | El tamaño de almacenamiento del dispositivo en mebibyte (MiB). Para obtener información acerca de la configuración del almacenamiento de dispositivo, consulte [StorageInfo](producer-reference-structures-producer.md#producer-reference-structures-producer-storageinfo). | Mebibyte (MiB) | 128 | | streaming-type | El tipo de streaming. Los valores válidos son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | Enum GstKvsSinkStreamingType | 0: tiempo real | | timecode-scale | La escala de código de tiempo de MKV. | Milisegundos | 1 | | track-name | El nombre de la pista MKV. | Cadena | "kinesis\$1video" | | iot-certificate | AWS IoT credenciales que se utilizarán en el `kvssink` elemento. `iot-certificate`acepta las siguientes claves y valores: El `iot-thing-name` es **opcional**. Si no `iot-thing-name` se proporciona, se utiliza el valor del `stream-name` parámetro. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/kinesisvideostreams/latest/dg/examples-gstreamer-plugin-parameters.html) | Cadena | Ninguno |