Creazione di pipeline di flussi multimediali

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'CreateMediaStreamPipelineAPI 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.

Nel diagramma:

1. Chiamate l'CreateMediaStreamPipelineAPI. 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 ilChimeSdkMeeting SourceType. SourceArnÈ l'ARN di. ChimeSdkMeeting

   • L'array dei sinks è composto daSinkType, SinkArnReservedStreamCapacity, e. MediaStreamType Supportiamo solo il. KinesisVideoStreamPoolSinkType SinkArnÈ l'ARN di. KinesisVideoStreamPool MediaStreamTypeControlla il tipo di file multimediale trasmesso al sink, oMixedAudio. IndividualAudio ReservedStreamCapacityimposta il numero di stream allocati per il MediaStreamType from. KinesisVideoStreamPool

     • Se vuoi eseguire lo streaming di entrambi IndividualAudio eMixedAudio, crea due oggetti sink nell'Sinksarray, uno perIndividualAudio, l'altro per. MixedAudio L'SinkArn(l'ARN delKinesisVideoStreamPool) può variare per ogni lavello.

     • Per trasmettere solo audio singolo o audio misto, create un oggetto sink con quello desideratoMediaStreamType.

   • Tieni presente quanto segue:

     • Quando si richiama l'CreateMediaStreamPipelineAPI con KinesisVideoStreamPool as theSinkType, SinkARN deve appartenere alla regione del piano di controllo in cui CreateMediaStreamPipeline viene richiamata.

       Ad esempio, se create una pipeline di flussi multimediali inus-east-1, dovete utilizzare un in. KinesisVideoStreamPool us-east-1

     • ReservedStreamCapacitydovrebbe essere 1 quando si specifica il MixedAudioMediaStreamType, e tra 1-10 quando si specifica il IndividualAudioMediaStreamType.

2. Il piano dati della pipeline multimediale richiama l' PutMediaAPI KVS per memorizzare l'audio individuale in un flusso KVS che appartiene al pool KVS specificato.

3. Il piano dati della pipeline multimediale richiama l'PutMediaAPI KVS per memorizzare l'audio misto in un flusso che appartiene al pool KVS specificato.

Nota

Dopo aver chiamato l'CreateMediaStreamPipelineAPI, i builder possono utilizzare gli eventi della pipeline multimediale o chiamare l'GetMediaPipelineAPI per determinare se lo stato della pipeline è. InProgress

Una volta raggiunto lo stato della pipeline, i file multimedialiInProgress, qualsiasi combinazione di e, vengono trasmessi a KVS. IndividualAudio MixedAudio

Per il tipo di IndividualAudio stream, esiste una mappatura 1:1 tra gli ID dei partecipanti e il flusso KVS allocato da. 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. Ogni notifica fornisce informazioni come gli ID dei partecipanti 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 (perIndividualAudio) 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 ListStreamsStreams 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. DeleteMediaPipeline Viene inoltre inviata una notifica di Event Bridge per indicare la chiusura della pipeline multimediale.