

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.

# Creación de canalizaciones de transmisión multimedia de Amazon Chime SDK
<a name="create-stream-pipeline"></a>

La canalización de transmisión multimedia de Chime debe pertenecer a la misma AWS cuenta que la reunión del SDK de Amazon Chime. Para crear la canalización de transmisión multimedia de Amazon Chime SDK, debe llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html) y especificar una fuente y un receptor.

En el siguiente diagrama, se muestra la arquitectura de una canalización de transmisión multimedia de Amazon Chime SDK. Los números del diagrama corresponden al texto numerado que aparece a continuación.

![\[Diagrama que muestra una llamada a la API que crea un grupo de transmisiones multimedia.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/media-stream-pipe-architecture.png)


En el diagrama:

1. Llame a la API `CreateMediaStreamPipeline`. En la solicitud, especifique las fuentes y los receptores de las transmisiones, ya desee capturar audio individual, audio mixto o ambos. Incluya el ARN de su grupo KVS en la solicitud.
   + La matriz de fuentes consta de las letras `SourceType` y `SourceArn`. Debe utilizar el `ChimeSdkMeeting SourceType`. El `SourceArn` es el ARN de la `ChimeSdkMeeting`.
   + La matriz de sumideros se compone de `SinkType`, `SinkArn`, `ReservedStreamCapacity` y `MediaStreamType`. Solo ofrecemos compatibilidad con el `KinesisVideoStreamPoolSinkType`. El `SinkArn` es el ARN de la `KinesisVideoStreamPool`. El `MediaStreamType` controla el tipo de contenido multimedia que se transmite al sumidero, ya sea `MixedAudio` o `IndividualAudio`. `ReservedStreamCapacity`establece el número de transmisiones asignadas al `MediaStreamType` desde el `KinesisVideoStreamPool`.
     + Si desea transmitir `IndividualAudio` y `MixedAudio`, cree dos objetos receptores en la matriz de `Sinks`, uno para `IndividualAudio` y otro para`MixedAudio`. El `SinkArn` (el ARN del `KinesisVideoStreamPool`) puede variar para cada sumidero.
     + Para transmitir solo audio individual o audio mixto, cree un objeto receptor con el `MediaStreamType` deseado.
   + Tenga en cuenta lo siguiente:
     + Al invocar la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html) con `KinesisVideoStreamPool` como `SinkType`, `SinkARN` debe pertenecer a la región del plano de control en la que se está invocando `CreateMediaStreamPipeline`.

       Por ejemplo, si crea una canalización de transmisión multimedia en `us-east-1`, debe usar una `KinesisVideoStreamPool` en `us-east-1`.
     + `ReservedStreamCapacity` debe ser **1** cuando especifique el `MixedAudio` `MediaStreamType`, y entre **1-10** cuando especifique el `IndividualAudio` `MediaStreamType`.

1. El plano de datos de Media Pipeline llama a la [ PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)API de KVS para almacenar el audio individual en una transmisión de KVS que pertenece al grupo de KVS que especifique.

1. El plano de datos de Media Pipeline llama a la API `PutMedia` de KVS para almacenar el audio mezclado en una transmisión que pertenece al grupo de KVS que especifique.

**nota**  
Tras llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html), los creadores pueden usar [eventos de canalización multimedia](media-pipe-events.md) o llamar a la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html) para determinar si el estado de la canalización es `InProgress`.  
Una vez alcanzado el estado `InProgress` de la canalización, el contenido multimedia (cualquier combinación de `IndividualAudio` y `MixedAudio`) se transmite a KVS.   
Para el tipo de `IndividualAudio` transmisión, existe un mapeo 1:1 entre el asistente IDs y la transmisión KVS asignada desde la. `KinesisVideoStreamPool` El mapeo se aplica durante toda la canalización de medios.  
Para saber qué transmisión de KVS se asigna a un identificador de asistente o para qué se asigna MixedAudio, utilice una de las siguientes técnicas:  
Utilice las [notificaciones de Event Bridge](media-stream-event-bridge.md). Cada notificación proporciona información como el asistente IDs y el ARN de KVS que transmite el audio del asistente. Cuando se inicia una sesión de transmisión `IndividualAudio` o `MixedAudio`, enviamos un evento de `chime:MediaPipelineKinesisVideoStreamStart`. Las sesiones de transmisión finalizan cuando un asistente abandona la llamada (para `IndividualAudio`) o cuando finaliza la reunión.
Utilice los metadatos persistentes que Kinesis Video Streams envía con cada fragmento. Los metadatos contienen información similar a la que envía Event Bridge. Los creadores deben analizar todas las transmisiones del `KinesisVideoStreamPool` especificando el nombre del grupo como prefijo en la API [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html) de Kinesis Video Streams mediante esta solución.
La canalización de Media Stream se cierra cuando se elimina la reunión o se invoca la API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) para esa canalización de transmisión multimedia. También se envía una [notificación de Event Bridge](media-pipe-events.md) para indicar la finalización de la canalización de contenido multimedia.