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. # Conector periférico para Kinesis Video Streams El conector periférico para el componente Kinesis Video Streams (`aws.iot.EdgeConnectorForKVS`) lee las transmisiones de video de las cámaras locales y las publica en Kinesis Video Streams. Puede configurar este componente para leer las transmisiones de video de las cámaras de protocolo de Internet (IP) mediante el protocolo de transmisión en tiempo real (RTSP). A continuación, puede configurar paneles en los servidores de [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) o Grafana locales para supervisar los flujos de video e interactuar con ellos. Puede integrar este componente AWS IoT TwinMaker para mostrar y controlar las transmisiones de vídeo en los paneles de Grafana. AWS IoT TwinMaker es un AWS servicio que le permite crear gemelos digitales operativos de sistemas físicos. Puede utilizarlo AWS IoT TwinMaker para visualizar los datos de los sensores, las cámaras y las aplicaciones empresariales con el fin de realizar un seguimiento de sus fábricas, edificios o plantas industriales físicas. También puede utilizar estos datos para supervisar las operaciones, diagnosticar errores y repararlos. Para obtener más información, consulte [¿Qué es AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) en la *Guía AWS IoT TwinMaker del usuario*. Este componente almacena su configuración en AWS IoT SiteWise, que es un AWS servicio que modela y almacena datos industriales. En AWS IoT SiteWise, *los activos* representan objetos como dispositivos, equipos o grupos de otros objetos. Para configurar y usar este componente, debe crear un AWS IoT SiteWise activo para cada dispositivo principal de Greengrass y para cada cámara IP conectada a cada dispositivo principal. Cada activo tiene propiedades que se configuran para controlar características, como la transmisión en directo, la carga bajo demanda y el almacenamiento en caché local. Para especificar la URL de cada cámara, debe crear una entrada secreta en AWS Secrets Manager que contenga la URL de la cámara. Si la cámara requiere autenticación, también debe especificar un nombre de usuario y una contraseña en la URL. A continuación, especifique ese secreto en una propiedad de activo de la cámara de IP. Este componente carga la transmisión de video de cada cámara a una transmisión de video de Kinesis. Debe especificar el nombre de la transmisión de vídeo de Kinesis de destino en la configuración de AWS IoT SiteWise activos de cada cámara. Si la transmisión de video de Kinesis no existe, este componente la crea por usted. AWS IoT TwinMaker proporciona un script que puede ejecutar para crear estos AWS IoT SiteWise activos y los secretos de Secrets Manager. Para obtener más información sobre cómo crear estos recursos y cómo instalar, configurar y usar este componente, consulte la [integración de AWS IoT TwinMaker vídeo](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) en la *Guía del AWS IoT TwinMaker usuario*. **nota** El conector periférico para Kinesis Video Streams solo está disponible en las siguientes Regiones de AWS: Este de EE. UU. (Norte de Virginia) Oeste de EE. UU. (Oregón) Europa (Fráncfort) Europa (Irlanda) Asia-Pacífico (Singapur) Asia-Pacífico (Tokio) Asia-Pacífico (Seúl) Asia-Pacífico (Sídney) Asia-Pacífico (Mumbai) China (Pekín) **Topics** + [Versiones](#kvs-edge-connector-component-versions) + [Tipo](#kvs-edge-connector-component-type) + [Sistema operativo](#kvs-edge-connector-component-os-support) + [Requisitos](#kvs-edge-connector-component-requirements) + [Dependencias](#kvs-edge-connector-component-dependencies) + [Configuración](#kvs-edge-connector-component-configuration) + [Licencias](#kvs-edge-connector-component-licenses) + [De uso](#kvs-edge-connector-component-usage) + [Archivo de registro local](#kvs-edge-connector-component-log-file) + [Registros de cambios](#kvs-edge-connector-component-changelog) + [Véase también](#kvs-edge-connector-component-see-also) ## Versiones Este componente tiene las siguientes versiones: + 1.0.x ## Tipo Este componente es un componente genérico (`aws.greengrass.generic`). El [núcleo de Greengrass](greengrass-nucleus-component.md) ejecuta los scripts del ciclo de vida del componente. Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types). ## Sistema operativo Este componente solo se puede instalar en los dispositivos principales de Linux. ## Requisitos Este componente tiene los siguientes requisitos: + Puede implementar este componente solo en dispositivos de un núcleo principal, ya que la configuración del componente debe ser única para cada dispositivo principal. No puede implementar este componente en grupos de dispositivos principales. + [GStreamer](https://gstreamer.freedesktop.org)1.18.4 o una versión posterior instalada en el dispositivo principal. [Para obtener más información, consulte Instalación. GStreamer](https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c) En un dispositivo con`apt`, puede ejecutar los siguientes comandos para realizar la instalación GStreamer. ``` sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps sudo apt install -y gstreamer1.0-libav sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools ``` + Un AWS IoT SiteWise activo para cada dispositivo principal. Este AWS IoT SiteWise activo representa el dispositivo principal. Para obtener más información sobre cómo crear este recurso, consulte la [integración de AWS IoT TwinMaker vídeo](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) en la *Guía del AWS IoT TwinMaker usuario*. + Un AWS IoT SiteWise recurso para cada cámara IP que se conecte a cada dispositivo principal. Estos activos AWS IoT SiteWise representan las cámaras que transmiten video a cada dispositivo principal. El activo de cada cámara debe estar asociado al activo del dispositivo principal que se conecta a la cámara. Los activos de cámara tienen propiedades que puede configurar para especificar un flujo de video de Kinesis, un secreto de autenticación y parámetros de transmisión de video. Para obtener más información sobre cómo crear y configurar los activos de la cámara, consulte la [integración de AWS IoT TwinMaker vídeo](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) en la *Guía del AWS IoT TwinMaker usuario*. + Un AWS Secrets Manager secreto para cada cámara IP. Este secreto debe definir un par clave-valor, donde la clave es `RTSPStreamUrl` y el valor es la URL de la cámara. Si la cámara requiere autenticación, incluya el nombre de usuario y la contraseña en esta URL. Puede usar una cadena para crear un secreto cuando cree los recursos que requiere este componente. Para obtener más información, consulte la [integración de AWS IoT TwinMaker vídeo](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) en la *Guía del AWS IoT TwinMaker usuario*. También puede utilizar la consola del administrador de secretos y la API para crear secretos adicionales. Para obtener más información, consulte [Cómo crear un secreto](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) en la *Guía del usuario de AWS Secrets Manager *. + La [función de intercambio de tokens de Greengrass](device-service-role.md) debe permitir las siguientes acciones y las de Kinesis Video Streams AWS Secrets Manager AWS IoT SiteWise, como se muestra en el siguiente ejemplo de política de IAM. **nota** Este ejemplo de política permite al dispositivo obtener el valor de los secretos con nombres **IPCamera1Url** y **IPCamera2Url**. Cuando configura cada cámara de IP, se especifica un secreto que contiene la URL de esa cámara. Si la cámara requiere autenticación, también debe especificar un nombre de usuario y una contraseña en la URL. El rol de intercambio de token del dispositivo principal debe permitir el acceso al secreto de cada cámara de IP a la que se conecte. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera1Url", "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera2Url" ] }, { "Action": [ "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "kinesisvideo:CreateStream", "kinesisvideo:DescribeStream", "kinesisvideo:GetDataEndpoint", "kinesisvideo:PutMedia", "kinesisvideo:TagStream" ], "Effect": "Allow", "Resource": [ "*" ] } ] } ``` ------ **nota** Si utiliza una AWS Key Management Service clave gestionada por el cliente para cifrar los secretos, la función de dispositivo también debe permitir la acción. `kms:Decrypt` ### Puntos de conexión y puertos Este componente debe poder realizar solicitudes salientes a los siguientes puntos de conexión y puertos, además de a los puntos de conexión y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte [Cómo permitir el tráfico del dispositivo a través de un proxy o firewall](allow-device-traffic.md). | punto de enlace | Puerto | Obligatorio | Description (Descripción) | | --- | --- | --- | --- | | `kinesisvideo.region.amazonaws.com` | 443 | Sí | Cargue datos a Kinesis Video Streams. | | `data.iotsitewise.region.amazonaws.com` | 443 | Sí | Publique los metadatos del flujo de video en AWS IoT SiteWise. | | `secretsmanager.region.amazonaws.com` | 443 | Sí | Descargue los secretos de la URL de la cámara al dispositivo principal. | ## Dependencias Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#kvs-edge-connector-component-changelog) de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la [consola de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**. En la siguiente tabla, se muestran las dependencias de las versiones 1.0.0 a 1.0.5 de este componente. | Dependencia | Versiones compatibles | Tipo de dependencia | | --- | --- | --- | | [Servicio de intercambio de token](token-exchange-service-component.md) | >=2.0.3 | Rígido | | [Administrador de flujos](stream-manager-component.md) | >=2.0.9 | Rígido | Para obtener más información sobre las dependencias del componente, consulte la [referencia de receta de componentes](component-recipe-reference.md#recipe-reference-component-dependencies). ## Configuración Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente. `SiteWiseAssetIdForHub` El ID del AWS IoT SiteWise activo que representa este dispositivo principal. Para obtener más información sobre cómo crear este recurso y usarlo para interactuar con este componente, consulte la [integración de AWS IoT TwinMaker vídeo](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) en la *Guía del AWS IoT TwinMaker usuario*. **Example Ejemplo: actualización de la combinación de configuraciones** ``` { "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` ## Licencias Este componente incluye las siguientes licencias o software de terceros: + [Quartz Job Scheduler](http://www.quartz-scheduler.org/)/Apache License 2.0 + [Vinculaciones de Java para la GStreamer licencia pública general reducida 1.x/GNU](https://github.com/gstreamer-java/gst1-java-core) v3.0 ## De uso Para configurar este componente e interactuar con él, puede configurar las propiedades de AWS IoT SiteWise los activos que representan el dispositivo principal y las cámaras IP a las que se conecta. También puede visualizar e interactuar con las transmisiones de vídeo en los paneles de Grafana a través de. AWS IoT TwinMaker Para obtener más información, consulte la [integración de AWS IoT TwinMaker vídeo](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) en la Guía del *AWS IoT TwinMaker usuario*. ## Archivo de registro local Este componente usa el siguiente archivo de registro. ``` /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` **Visualización de los registros de este componente** + Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. `/greengrass/v2`Sustitúyala por la ruta a la carpeta AWS IoT Greengrass raíz. ``` sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` ## Registros de cambios En la siguiente tabla, se describen los cambios en cada versión del componente. | **Versión** | **Cambios** | | --- | --- | | 1.0.5 | Corrección de errores y mejoras generales. | | 1.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/kvs-edge-connector-component.html) | | 1.0.3 | Corrección de errores y mejoras generales. | | 1.0.1 | Corrección de errores y mejoras generales. | | 1.0.0 | Versión inicial. | ## Véase también + [¿Qué es AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) en la *Guía AWS IoT TwinMaker del usuario* + [AWS IoT TwinMaker integración de vídeo](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) en la *Guía AWS IoT TwinMaker del usuario* + [¿Qué es AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) en la *Guía AWS IoT SiteWise del usuario* + [Actualización de los valores de los atributos](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html) en la *Guía del usuario de AWS IoT SiteWise * + ¿[Qué es AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) en la * Guía del usuario de AWS Secrets Manager * + [Creación y administración de secretos](https://docs.aws.amazon.com/secretsmanager/latest/userguide/managing-secrets.html) en la *Guía del usuario de AWS Secrets Manager *