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 del streaming de medios en directo del audio del cliente en Amazon Connect
En Amazon Connect, puede capturar el audio del cliente durante una interacción con su centro de contacto mediante el envío del audio a un flujo de vídeo de Kinesis. Según su configuración, se puede capturar el audio de toda la interacción (hasta que finalice la interacción con el agente) o solo en una dirección:
+ Lo que escucha el cliente, incluido lo que dice el agente y los mensajes del sistema.
+ Lo que el cliente dice, incluso cuando está en espera.
Los flujos de audio del cliente también incluyen interacciones con un bot de Amazon Lex si está usando uno en el flujo.
**Topics**
+ [Planificar streaming de contenido multimedia en directo](plan-live-media-streams.md)
+ [Habilitar streaming de contenido multimedia en directo](enable-live-media-streams.md)
+ [Acceso a los datos de Kinesis Video Streams](access-media-stream-data.md)
+ [Probar streaming de contenido multimedia en directo](use-media-streams-blocks.md)
+ [Atributos de contacto para el streaming de contenido multimedia en directo](media-streaming-attributes.md)
# Planificación del streaming de contenido multimedia en directo desde Amazon Connect a Kinesis Video Streams
**importante**
Si desea utilizar la característica de streaming de audio, debe retener las secuencias que ha creado mediante Amazon Connect. No las elimine, a menos que vaya a dejar de usar esta característica.
Puede enviar todo el audio al cliente y desde el cliente a Kinesis Video Streams. El streaming de contenido multimedia aprovecha el soporte multipista de Kinesis Video Streams para que lo que dice el cliente esté en una pista separada de lo que escucha.
El audio que se envía a Kinesis utiliza una velocidad de muestreo de 8 Khz.
## ¿Es necesario aumentar las cuotas de servicio?
Cuando se habilita el streaming de medios en Amazon Connect, se usa un flujo de vídeo de Kinesis por llamada activa. Creamos nuevas transmisiones KVS según sea necesario para gestionar las solicitudes de transmisión simultáneas. Creamos automáticamente transmisiones adicionales según sea necesario para seguir el ritmo de las llamadas activas, a no ser que su cuenta alcance la [cuota de servicio de Kinesis Video Streams](https://docs.aws.amazon.com/streams/latest/dev/service-sizes-and-limits.html).
Póngase en contacto Soporte para solicitar un aumento en **el número de transmisiones**.
Para solicitar un aumento de su cuota de servicio, en el AWS Support Center, elija **Create Case** y, a continuación, elija **Service Quota Increase**.
**sugerencia**
Nos aseguramos de que **PutMedia**las solicitudes se mantengan siempre dentro de la cuota de 5 TPS. No tiene que solicitar un aumento.
## ¿Cuánto tiempo necesita almacenar audio?
El audio del cliente se almacena en Kinesis durante el tiempo definido por su configuración de retención en una instancia de Amazon Connect. Para obtener instrucciones sobre cómo establecer este valor, consulte [Activación del streaming de contenido multimedia en directo en su instancia de Amazon Connect](enable-live-media-streams.md).
## ¿Necesita cambiar las secuencias de audio?
Le recomendamos que se abstenga de modificar las secuencias, ya que se podrían producir comportamientos inesperados.
## ¿Quién requiere permisos de IAM para recuperar datos?
Si su empresa utiliza permisos de IAM, su AWS administrador tendrá que conceder permisos a las funciones de IAM que necesiten recuperar datos de Kinesis Video Streams. Tendrán que concederles permisos de acceso total para Kinesis Video Streams y AWS Key Management Service.
# Activación del streaming de contenido multimedia en directo en su instancia de Amazon Connect
El streaming de medios en directo (secuencias de audio del cliente) no está habilitado de forma predeterminada. Puede habilitar las secuencias de audio del cliente desde la página de configuración de su instancia.
**Para habilitar el streaming de medios en directo**
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
1. En el panel de navegación, elija **Almacenamiento de datos**.
1. En **Streaming de medios en directo**, elija **Editar**. Seleccione **Habilitar streaming de medios en directo**.
1. Escriba un prefijo para Kinesis Video Streams que se ha creado para su audio de cliente. Este prefijo le facilita la identificación de la transmisión con los datos.
1. Los datos se cifran antes de escribirlos en la capa de almacenamiento del flujo de Kinesis Video Streams y se descifran después de recuperarlos del almacenamiento. Como resultado, los datos siempre se cifran en reposo en el servicio de Kinesis Video Streams. Elija la clave KMS utilizada para cifrar los datos en Kinesis Video Streams como se muestra en la siguiente imagen.
![\[La sección de cifrado, en la que se elige la clave KMS\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/streaming-encryption.png)
Si decide introducir su propia clave, tenga en cuenta las siguientes restricciones:
1. La clave de KMS debe existir en la misma región que la instancia.
1. La clave KMS debe ser una de las siguientes:
+ Una clave administrada por el cliente.
OR
+ La clave AWS gestionada para Kinesis Video Streams (aws/kinesisvideo).
No debe ser ninguna de las claves AWS administradas que se crean automáticamente para otros servicios (por ejemplo,). aws/connect, aws/lambda, aws/kinesis
1. La concesión concedida para la clave por Amazon Connect no debe revocarse. Estas subvenciones tendrían `GranteePrincipal` en el siguiente formato:
```
arn:aws:iam::customer-account-id:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hash_suffix
```
1. Especifique un número y una unidad para el **Periodo de retención de datos**.
**importante**
Si selecciona **Sin retención de datos**, los datos no se retendrán y estarán disponibles para su consumo durante solo cinco minutos. Este es el tiempo mínimo predeterminado que Kinesis retiene los datos.
Como Amazon Connect utiliza Kinesis para el streaming, se aplican las [cuotas de Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).
1. Elija **Guardar** en **Streaming de medios en directo** y, a continuación, seleccione **Guardar** al final de la página.
Después de habilitar el streaming de contenido multimedia en directo, añada bloques **Inicio de streaming de contenido multimedia** y **Detención de streaming de contenido multimedia** al flujo. Configure esos bloques para especificar qué audio desea capturar. Para obtener instrucciones y un ejemplo, consulte [Flujo de ejemplo para probar el streaming de contenido multimedia en directo en Amazon Connect](use-media-streams-blocks.md).
# Desarrollo del streaming de contenido multimedia en directo en Amazon Connect
Para ayudarle a empezar con el desarrollo mediante la transmisión multimedia en directo, Amazon Connect incluye el siguiente repositorio de Kinesis Video Streams, que contiene un ejemplo básico de cómo consumir datos de audio de sus transmisiones de Kinesis Video Streams: [https://github.com/amazon-connect/connect-kvs-consumer-demo](https://github.com/amazon-connect/connect-kvs-consumer-demo)
Esta demostración se basa en las abstracciones de alto nivel que ofrece la biblioteca de analizadores de Kinesis Video Streams para leer las pistas `AUDIO_TO_CUSTOMER` y `AUDIO_FROM_CUSTOMER` pistas publicadas por Amazon Connect. Almacena estos datos como un archivo PCM sin procesar. Este archivo se puede transformar, transcodificar o reproducir.
# Flujo de ejemplo para probar el streaming de contenido multimedia en directo en Amazon Connect
A continuación, se explica cómo configurar un flujo para probar el streaming de medios en directo:
1. Añada un bloque **Inicio de streaming de medios** en el punto en el que quiera habilitar el streaming de audio del cliente.
1. Conecte la ramificación **Correcto** al resto del flujo.
1. Añada **Detención de streaming de medios** donde desee detener el streaming.
1. Configure ambos bloques para especificar lo que quiere transmitir: **Del cliente and/or **al** cliente**.
![\[Un bloque de streaming de medios de inicio.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/start-media-streaming.png)
El audio del cliente se captura hasta que se invoca un bloque **Detener streaming de contenido multimedia**, incluso si el contacto se pasa a otro flujo.
Utilice los atributos de contacto para streaming de medios de su flujo de modo que el registro de contacto incluya los atributos. A continuación, puede ver el registro de contacto para determinar los datos de streaming de medios asociados con un contacto específico. También puede pasar los atributos a una AWS Lambda función.
El siguiente flujo de ejemplo muestra cómo puede utilizar el streaming de medios con atributos con fines de prueba. Este flujo incluye un bloque **Iniciar streaming de contenido multimedia**, pero le falta el bloque **Detener streaming de contenido multimedia**.
![\[Un flujo de muestra con un bloque de inicio de streaming de medios.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/media-streaming-flow.png)
Una vez que el audio se haya transmitido correctamente a Kinesis Video Streams, los atributos de contacto se rellenan desde el bloque de funciones **Invoke AWS Lambda**. Puede utilizar los atributos para identificar la ubicación de la secuencia donde se inicia el audio del cliente. Para obtener instrucciones, consulte [Atributos de contacto para el streaming de contenido multimedia en directo en Kinesis Video Streams](media-streaming-attributes.md).
# Atributos de contacto para el streaming de contenido multimedia en directo en Kinesis Video Streams
Los atributos se muestran al seleccionar **Emisiones multimedia** como **Tipo** en un bloque de flujo que admite atributos como, por ejemplo, el bloque **Iniciar streaming de contenido multimedia**. Incluyen lo siguiente:
ARN de la secuencia de audio del cliente
El ARN del flujo de vídeo de Kinesis que incluye los datos de cliente a los que hacer referencia.
**JSONPath formato: \$1.** MediaStreams.customer.audio.StreamArn
Marca de tiempo de comienzo de audio del cliente
Hora a la que se inició la secuencia de audio del cliente.
**JSONPath formato: \$1.** MediaStreams.Cliente. Audio. StartTimestamp
Marca temporal de detención del audio del cliente
Hora a la que se detuvo la secuencia de audio del cliente.
**JSONPath formato:** \$1. MediaStreams.Cliente. Audio. StopTimestamp
Número de fragmento de inicio de audio del cliente
Número que identifica el fragmento de secuencias de vídeo de Kinesis en el que se inició la secuencia de audio del cliente.
**JSONPath formato:** \$1. MediaStreams.Cliente. Audio. StartFragmentNumber
Para obtener más información sobre los fragmentos de Amazon Kinesis Video Streams, consulte [Fragmento](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_Fragment.html) en la *Guía para desarrolladores Amazon Kinesis Video Streams*.