

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.

# Configuración de los recursos de Amazon Rekognition Video y Amazon Kinesis
<a name="setting-up-your-amazon-rekognition-streaming-video-resources"></a>

 Los siguientes procedimientos describen los pasos que debe seguir para aprovisionar la transmisión de vídeo de Kinesis y otros recursos que se utilizan para reconocer rostros en una transmisión de vídeo.

## Requisitos previos
<a name="streaming-video-prerequisites"></a>

Para ejecutar este procedimiento, debe tener el instalado. AWS SDK para Java Para obtener más información, consulte [Introducción a Amazon Rekognition](getting-started.md). El Cuenta de AWS que utilices debe tener permisos de acceso a la API Amazon Rekognition. Para obtener más información, consulte [Acciones definidas por Amazon Rekognition](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonrekognition.html#amazonrekognition-actions-as-permissions) en la *Guía del usuario de IAM*. 

**Para reconocer rostros en una transmisión de vídeo (AWS SDK)**

1. Si no lo ha hecho aún, cree un rol de servicio de IAM para otorgar a Amazon Rekognition Video acceso a sus transmisiones de vídeo de Kinesis y sus flujos de datos de Kinesis. Anote el ARN. Para obtener más información, consulte [Dar acceso a las transmisiones mediante AmazonRekognitionServiceRole](api-streaming-video-roles.md#api-streaming-video-roles-all-stream).

1. [Cree una colección](create-collection-procedure.md) y anote el identificador de la colección que haya utilizado.

1. [Indexe los rostros](add-faces-to-collection-procedure.md) que desee buscar en la colección que ha creado en el paso 2.

1. [Cree una transmisión de vídeo de Kinesis](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-createstream.html) y anote el Nombre de recurso de Amazon (ARN) de la transmisión.

1. [Cree de un flujo de datos de Kinesis](https://docs.aws.amazon.com/streams/latest/dev/learning-kinesis-module-one-create-stream.html). Añada el nombre de la transmisión *AmazonRekognition*y anote el ARN de la transmisión.

A continuación, puede [crear el procesador de transmisión por búsqueda de rostros](rekognition-video-stream-processor-search-faces.md#streaming-video-creating-stream-processor) e [iniciar el procesador de transmisión](rekognition-video-stream-processor-search-faces.md#streaming-video-starting-stream-processor) que haya elegido.

**nota**  
 Debe iniciar el procesador de transmisión solo después de comprobar que puede introducir contenido multimedia en la transmisión de vídeo de Kinesis. 

## Transmisión de vídeo a Amazon Rekognition Video
<a name="video-streaming-kinesisvideostreams-stream"></a>

Para transmitir vídeo a Amazon Rekognition Video, utilice el SDK de Amazon Kinesis Video Streams para crear y utilizar una transmisión de vídeo de Kinesis. La operación `PutMedia` escribe *fragmentos* de datos de vídeo de Kinesis en una transmisión de vídeo que Amazon Rekognition Video consume. Cada fragmento de datos de vídeo suele tener una longitud de 2 a 10 segundos y contiene una secuencia de fotogramas de vídeo autónoma. Amazon Rekognition Video admite vídeos cifrados en H.264, que pueden tener tres tipos de fotogramas (I, B y P). Para obtener más información, consulte [Inter Frame](https://en.wikipedia.org/wiki/Inter_frame). El primer fotograma del fragmento debe ser un I-frame. Un I-frame se puede decodificar de forma independientes de cualquier otro fotograma. 

A medida que los datos de vídeo llegan a transmisión de vídeo de Kinesis, Kinesis Video Streams asigna un número único al fragmento. [Para ver un ejemplo, consulta el ejemplo de APIPutMedia .](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html)
+  Si está transmitiendo desde una fuente codificada en Matroska (MKV), utilice la [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)operación para transmitir el vídeo de origen a la transmisión de vídeo de Kinesis que ha creado. [Para obtener más información, consulte el ejemplo de API. PutMedia ](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html) 
+  Si está transmitiendo desde la cámara de un dispositivo, consulte [Transmisión mediante un GStreamer complemento](streaming-using-gstreamer-plugin.md).

# Otorgar a Amazon Rekognition Video acceso a sus recursos
<a name="api-streaming-video-roles"></a>

Utiliza un rol de servicio AWS Identity and Access Management (IAM) para dar a Amazon Rekognition Video acceso de lectura a las transmisiones de vídeo de Kinesis. Si utiliza un procesador de secuencias de búsqueda facial, utilizará un rol de servicio de IAM para conceder a Amazon Rekognition Video acceso de escritura a los flujos de datos de Kinesis. Si utiliza un procesador de flujos de supervisión de seguridad, utiliza los roles de IAM para permitir que Amazon Rekognition Video acceda a su bucket de Amazon S3 y a un tema de Amazon SNS.

## Permitir el acceso a los procesadores de streaming mediante búsqueda facial
<a name="api-streaming-video-roles-single-stream"></a>

Puede crear una política de permisos que permita a Amazon Rekognition Video acceder a las transmisiones individuales de vídeo de Kinesis y a los flujos de datos de Kinesis.

**Para dar acceso a Amazon Rekognition Video a un procesador de secuencias de búsqueda facial**

1. [ Cree una nueva política de permisos con el editor de políticas de JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor) y utilice la política siguiente. Sustituya `video-arn` por el ARN de la transmisión de vídeo de Kinesis deseado. Si utiliza un procesador de secuencias de búsqueda facial, sustituya `data-arn` por el ARN del flujo de datos de Kinesis deseado.

1. [Cree un rol de servicio de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html?icmpid=docs_iam_console) o actualice un rol de servicio de IAM existente. Utilice la siguiente información para crear el rol de servicio de IAM:

   1. Elija **Rekognition** para el nombre del servicio.

   1. Elija **Rekognition** para el caso de uso del rol de servicio.

   1. Adjunte la política de permisos que ha creado en el paso 1.

1. Anote el ARN del rol de servicio. Lo necesita para comenzar las operaciones de análisis de vídeo.

## Dar acceso a las transmisiones mediante AmazonRekognitionServiceRole
<a name="api-streaming-video-roles-all-stream"></a>

 Como opción alternativa para configurar el acceso a las transmisiones de vídeo y flujos de datos de Kinesis, puede utilizar la política de permisos `AmazonRekognitionServiceRole`. IAM proporciona el caso de uso del rol de servicio *Rekognition* que, cuando se usa con la política de permisos `AmazonRekognitionServiceRole`, puede escribir en varios flujo de datos de Kinesis y leer desde todas transmisiones de vídeo de Kinesis. Para conceder a Amazon Rekognition Video acceso de escritura a varias transmisiones de datos de Kinesis, puede anteponer los nombres de las transmisiones de datos de Kinesis con, por ejemplo,. *AmazonRekognition*`AmazonRekognitionMyDataStreamName` 

**Para conceder a Amazon Rekognition Video acceso a su transmisión de vídeo de Kinesis y a los flujos de datos de Kinesis**

1. [Cree un rol de servicio de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html?icmpid=docs_iam_console). Utilice la siguiente información para crear el rol de servicio de IAM:

   1. Elija **Rekognition** para el nombre del servicio.

   1. Elija **Rekognition** para el caso de uso del rol de servicio.

   1. Elija la política de **AmazonRekognitionServiceRole**permisos, que otorga a Amazon Rekognition Video acceso de escritura a las transmisiones de datos de Kinesis que tienen el prefijo *AmazonRekognition*y acceso de lectura a todas sus transmisiones de vídeo de Kinesis.

1. Para garantizar su Cuenta de AWS seguridad, limite el alcance del acceso de Rekognition únicamente a los recursos que utilice. Para ello, puede adjuntar una política de confianza a su rol de servicio de IAM. Para obtener información sobre cómo hacerlo, consulte [Prevención de la sustitución confusa entre servicios](cross-service-confused-deputy-prevention.md).

1. Anote el nombre de recurso de Amazon (ARN) del rol de servicio. Lo necesita para comenzar las operaciones de análisis de vídeo.