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.
# Trabajar con eventos de vídeo en streaming
Puede usar Amazon Rekognition Video para detectar y reconocer rostros o detectar objetos en vídeo en streaming. Amazon Rekognition Video utiliza Amazon Kinesis Video Streams para recibir y procesar una transmisión de vídeo. Usted crea un procesador de transmisión con parámetros que muestran lo que desea que el procesador de transmisión detecte en la transmisión de vídeo. Rekognition envía los resultados de detección de etiquetas de eventos de vídeo en streaming como notificaciones de Amazon SNS y Amazon S3. Rekognition envía los resultados de la búsqueda de rostros a un flujo de datos de Kinesis.
Los procesadores de transmisión de búsqueda de rostros utilizan `FaceSearchSettings` para buscar rostros de una colección. Para obtener más información sobre cómo implementar los procesadores de secuencias de búsqueda de rostros para analizar los rostros en la transmisión de vídeo, consulte [Búsqueda de rostros en una colección en streaming de vídeo](collections-streaming.md).
Los procesadores de flujo de detección de etiquetas utilizan `ConnectedHomeSettings` para buscar personas, paquetes y mascotas en eventos de transmisión de vídeo. Para obtener más información acerca de cómo implementar los procesadores de flujo de detección de etiquetas, consulte [Detección de etiquetas en eventos de vídeo en streaming](streaming-video-detect-labels.md).
## Descripción general de las operaciones del procesador de transmisión de Amazon Rekognition Video
El análisis de un vídeo en streaming comienza iniciando un procesador de streaming de Amazon Rekognition Video y transmitiendo vídeo a Amazon Rekognition Video. Un procesador de streaming de Amazon Rekognition Video le permite iniciar, detener y administrar procesadores de streaming. Crea un procesador de streaming llamando a [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html). Los parámetros de solicitud para crear un procesador de secuencias de búsqueda de rostros incluyen los nombres de recursos de Amazon (ARNs) para la transmisión de vídeo de Kinesis, la transmisión de datos de Kinesis y el identificador de la colección que se utiliza para reconocer los rostros en la transmisión de vídeo. Los parámetros de solicitud para crear un procesador de transmisiones de monitoreo de seguridad incluyen los nombres de los recursos de Amazon (ARNs) para la transmisión de vídeo de Kinesis y el tema Amazon SNS, los tipos de objetos que desea detectar en la transmisión de vídeo y la información de un bucket de Amazon S3 para los resultados de salida. También incluye el nombre que especifica para el procesador de streaming.
Comienza a procesar un vídeo llamando a la operación [StartStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartStreamProcessor.html). Para obtener la información de estado de un procesador de streaming, llame a [DescribeStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeStreamProcessor.html). Otras operaciones a las que puede recurrir son [TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource.html)etiquetar un procesador de transmisión y [DeleteStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteStreamProcessor.html)eliminar un procesador de transmisión. Si está utilizando un procesador de flujo con búsqueda facial, también puede usarlo [StopStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopStreamProcessor.html)para detener un procesador de flujo. Para obtener una lista de los procesadores de streaming en su cuenta, llame a [ListStreamProcessors](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListStreamProcessors.html).
Después de que el procesador de streaming comienza a ejecutarse, transmita el vídeo en Amazon Rekognition Video a través de la transmisión de vídeo de Kinesis que especificó en `CreateStreamProcessor`. Puede utilizar la operación del [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)SDK de Kinesis Video Streams para entregar vídeo a la transmisión de vídeo de Kinesis. Para ver un ejemplo, consulte Ejemplo de [PutMediaAPI](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html).
Para obtener información sobre cómo su aplicación puede consumir los resultados del análisis de Amazon Rekognition Video de un procesador de secuencias de búsqueda facial, consulte [Lectura de los resultados del análisis de vídeo en streaming](streaming-video-kinesis-output.md).
# Agregar etiquetas a un procesador de transmisión nuevo
Puede usar etiquetas para identificar, organizar, buscar y filtrar sus procesadores de transmisión de Amazon Rekognition mediante etiquetas. Cada etiqueta es una marca que consta de una clave y un valor definidos por el usuario.
Puede agregar etiquetas a un procesador de transmisión a medida que lo crea mediante la operación `CreateStreamProcessor`. Indique una o varias etiquetas en el parámetro de entrada de la matriz `Tags`. A continuación, se muestra un ejemplo de JSON para la solicitud `CreateStreamProcessor` con etiquetas.
```
{
"Name": "streamProcessorForCam",
"Input": {
"KinesisVideoStream": {
"Arn": "arn:aws:kinesisvideo:us-east-1:nnnnnnnnnnnn:stream/inputVideo"
}
},
"Output": {
"KinesisDataStream": {
"Arn": "arn:aws:kinesis:us-east-1:nnnnnnnnnnnn:stream/outputData"
}
},
"RoleArn": "arn:aws:iam::nnnnnnnnnnn:role/roleWithKinesisPermission",
"Settings": {
"FaceSearch": {
"CollectionId": "collection-with-100-faces",
"FaceMatchThreshold": 85.5
},
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
```
# Agregar etiquetas a un procesador de transmisión existente
Puede usar etiquetas para identificar, organizar, buscar y filtrar sus procesadores de transmisión de Amazon Rekognition mediante etiquetas. Cada etiqueta es una marca que consta de una clave y un valor definidos por el usuario.
Para agregar una o varias etiquetas a un procesador de transmisión, utilice la operación `TagResource`. Indique el nombre de recurso de Amazon (ARN) del procesador de transmisión (`ResourceArn`) y las etiquetas (`Tags`) que desea añadir. En el siguiente ejemplo se ve cómo añadir dos etiquetas.
```
aws rekognition tag-resource --resource-arn resource-arn \
--tags '{"key1":"value1","key2":"value2"}'
```
**nota**
Si no conoce el nombre del recurso de Amazon del procesador de transmisión, puede usar la operación `DescribeStreamProcessor`.
# Listar etiquetas en un procesador de flujo
Puede usar etiquetas para identificar, organizar, buscar y filtrar sus procesadores de transmisión de Amazon Rekognition mediante etiquetas. Cada etiqueta es una marca que consta de una clave y un valor definidos por el usuario.
Para enumerar las etiquetas adjuntas a un procesador de transmisión, utilice la operación `ListTagsForResource` y especifique el ARN del procesador de transmisión (`ResourceArn`). El resultado será la asignación de las claves y los valores de las etiquetas que se asocian al procesador de transmisión concreto.
```
aws rekognition list-tags-for-resource --resource-arn resource-arn
```
El resultado muestra una lista de etiquetas adjuntas al procesador de transmisión:
```
{
"Tags": {
"Dept": "Engineering",
"Name": "Ana Silva Carolina",
"Role": "Developer"
}
}
```
# Eliminar etiquetas de un procesador de transmisión
Puede usar etiquetas para identificar, organizar, buscar y filtrar sus procesadores de transmisión de Amazon Rekognition mediante etiquetas. Cada etiqueta es una marca que consta de una clave y un valor definidos por el usuario.
Para eliminar una o más etiquetas de un procesador de transmisión, utilice la operación `UntagResource`. Indique el ARN del modelo (`ResourceArn`) y las claves de etiqueta (`Tag-Keys`) que desee eliminar.
```
aws rekognition untag-resource --resource-arn resource-arn \
--tag-keys '["key1","key2"]'
```
Si lo prefiere, también puede indicar claves de etiqueta en este formato:
```
--tag-keys key1,key2
```