

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di pipeline di flussi multimediali per Amazon Chime SDK
<a name="create-stream-pipeline"></a>

La pipeline del flusso multimediale chime deve appartenere allo stesso AWS account della riunione Amazon Chime SDK. Puoi creare la pipeline di flussi multimediali di Amazon Chime SDK chiamando l'[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)API e specificando una fonte e un sink.

Il diagramma seguente mostra l'architettura di una pipeline di flussi multimediali di Amazon Chime SDK. I numeri nel diagramma corrispondono al testo numerato riportato di seguito.

![\[Diagramma che mostra una chiamata API che crea un pool di flussi multimediali.\]](http://docs.aws.amazon.com/it_it/chime-sdk/latest/dg/images/media-stream-pipe-architecture.png)


Nel diagramma:

1. Chiamate l'`CreateMediaStreamPipeline`API. Nella richiesta, specificate le sorgenti e i sink per gli stream, indipendentemente dal fatto che vogliate acquisire audio singolo, audio misto o entrambi. Includi l'ARN del tuo pool KVS nella richiesta.
   + L'array dei sorgenti è composto da e. `SourceType` `SourceArn` È necessario utilizzare il`ChimeSdkMeeting SourceType`. `SourceArn`È l'ARN di. `ChimeSdkMeeting`
   + L'array dei sinks è composto da`SinkType`, `SinkArn``ReservedStreamCapacity`, e. `MediaStreamType` Supportiamo solo il. `KinesisVideoStreamPoolSinkType` `SinkArn`È l'ARN di. `KinesisVideoStreamPool` `MediaStreamType`Controlla il tipo di file multimediale trasmesso al sink, o`MixedAudio`. `IndividualAudio` `ReservedStreamCapacity`imposta il numero di stream allocati per il `MediaStreamType` from. `KinesisVideoStreamPool`
     + Se vuoi eseguire lo streaming di entrambi `IndividualAudio` e`MixedAudio`, crea due oggetti sink nell'`Sinks`array, uno per`IndividualAudio`, l'altro per. `MixedAudio` L'`SinkArn`(l'ARN del`KinesisVideoStreamPool`) può variare per ogni lavello.
     + Per trasmettere solo audio singolo o audio misto, create un oggetto sink con quello desiderato`MediaStreamType`.
   + Tenere presente quanto segue:
     + Quando si richiama l'[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)API con `KinesisVideoStreamPool` as the`SinkType`, `SinkARN` deve appartenere alla regione del piano di controllo in cui `CreateMediaStreamPipeline` viene richiamata.

       Ad esempio, se create una pipeline di flussi multimediali in`us-east-1`, dovete utilizzare un in. `KinesisVideoStreamPool` `us-east-1`
     + `ReservedStreamCapacity`dovrebbe essere **1** quando si specifica il `MixedAudio``MediaStreamType`, e tra **1-10** quando si specifica il `IndividualAudio``MediaStreamType`.

1. Il piano dati della pipeline multimediale richiama l'[ PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)API KVS per memorizzare l'audio individuale in un flusso KVS che appartiene al pool KVS specificato.

1. Il piano dati della pipeline multimediale richiama l'`PutMedia`API KVS per memorizzare l'audio misto in un flusso che appartiene al pool KVS specificato.

**Nota**  
Dopo aver chiamato l'[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)API, i builder possono utilizzare gli [eventi della pipeline multimediale](media-pipe-events.md) o chiamare l'[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)API per determinare se lo stato della pipeline è. `InProgress`  
Una volta raggiunto lo stato della pipeline, i file multimediali`InProgress`, qualsiasi combinazione di e, vengono trasmessi a KVS. `IndividualAudio` `MixedAudio`   
Per il tipo di `IndividualAudio` stream, esiste una mappatura 1:1 tra il partecipante e il flusso KVS allocato da. IDs `KinesisVideoStreamPool` La mappatura si applica per tutta la durata della pipeline multimediale.  
Per sapere a quale stream KVS è associato o a quale ID partecipante è assegnato MixedAudio, utilizzate una delle seguenti tecniche:  
Usa le notifiche di [Event Bridge](media-stream-event-bridge.md). Ogni notifica fornisce informazioni come il partecipante IDs e il KVS ARN che trasmette l'audio del partecipante. Quando inizia una sessione `IndividualAudio` di `MixedAudio` streaming, inviamo un evento. `chime:MediaPipelineKinesisVideoStreamStart` Le sessioni di streaming terminano quando un partecipante abbandona la chiamata (per`IndividualAudio`) o al termine della riunione.
Usa i metadati persistenti che Kinesis Video Streams inviano con ogni frammento. I metadati contengono informazioni simili a quelle inviate da Event Bridge. I builder devono analizzare tutti gli stream di `KinesisVideoStreamPool` specificando il nome del pool come prefisso nell'API Kinesis Video [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html)Streams utilizzando questa soluzione.
La chiusura della pipeline Media Stream avviene quando la riunione viene eliminata o l'API viene richiamata per quella pipeline di flusso multimediale. [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) Viene inoltre inviata una [notifica di Event Bridge](media-pipe-events.md) per indicare la chiusura della pipeline multimediale.