Membuat saluran pipa aliran media

Pipeline aliran media chime harus memiliki AWS akun yang sama dengan rapat Amazon Chime SDK. Anda membuat pipeline aliran media Amazon Chime SDK dengan memanggil CreateMediaStreamPipelineAPI dan menentukan sumber dan sink.

Diagram berikut menunjukkan arsitektur saluran aliran media Amazon Chime SDK. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.

Dalam diagram:

1. Anda memanggil CreateMediaStreamPipeline API. Dalam permintaan, tentukan sumber dan sink untuk stream. apakah Anda ingin menangkap audio individual, audio campuran, atau keduanya. Sertakan ARN kolam KVS Anda dalam permintaan.

   • Array sumber terdiri dari SourceType danSourceArn. Anda harus menggunakanChimeSdkMeeting SourceType. SourceArnItu adalah ARN dari. ChimeSdkMeeting

   • Array sink terdiri dariSinkType,, SinkArnReservedStreamCapacity, danMediaStreamType. Kami hanya mendukungKinesisVideoStreamPoolSinkType. SinkArnItu adalah ARN dari. KinesisVideoStreamPool MediaStreamTypeKontrol jenis media yang dialirkan ke wastafel, baik MixedAudio atauIndividualAudio. ReservedStreamCapacitymenetapkan jumlah aliran yang dialokasikan untuk MediaStreamType dari. KinesisVideoStreamPool

     • Jika Anda ingin melakukan streaming keduanya IndividualAudio danMixedAudio, buat dua objek sink dalam Sinks array, satu untukIndividualAudio, yang lain untukMixedAudio. SinkArn(ARN dariKinesisVideoStreamPool) dapat bervariasi untuk setiap wastafel.

     • Untuk melakukan streaming hanya audio individual atau audio campuran, buat satu objek wastafel dengan yang diinginkanMediaStreamType.

   • Perhatikan hal berikut:

     • Saat menjalankan CreateMediaStreamPipelineAPI dengan KinesisVideoStreamPool as theSinkType, SinkARN harus milik wilayah bidang kontrol tempat CreateMediaStreamPipeline dipanggil.

       Misalnya, jika Anda membuat pipeline aliran media dius-east-1, Anda harus menggunakan KinesisVideoStreamPool inus-east-1.

     • ReservedStreamCapacityharus 1 ketika Anda menentukan MixedAudioMediaStreamType, dan antara 1-10 saat Anda menentukan IndividualAudioMediaStreamType.

2. Bidang data pipeline media memanggil KVS PutMediaAPI untuk menyimpan audio individual dalam aliran KVS yang termasuk dalam kumpulan KVS yang Anda tentukan.

3. Bidang data pipeline media memanggil KVS PutMedia API untuk menyimpan audio campuran dalam aliran milik kumpulan KVS yang Anda tentukan.

catatan

Setelah memanggil CreateMediaStreamPipelineAPI, builder dapat menggunakan peristiwa pipeline media atau memanggil GetMediaPipelineAPI untuk menentukan apakah status pipeline tersebutInProgress.

Setelah status pipa mencapaiInProgress, media—kombinasi apa pun dari IndividualAudio MixedAudio dan—mengalir ke KVS.

Untuk jenis IndividualAudio aliran, pemetaan 1:1 ada antara ID peserta dan aliran KVS yang dialokasikan dari. KinesisVideoStreamPool Pemetaan berlaku untuk masa pakai pipa media.

Untuk mengetahui aliran KVS mana yang memetakan ke ID peserta, atau ditetapkan MixedAudio, gunakan salah satu teknik berikut:

• Gunakan Pemberitahuan Jembatan Acara. Setiap pemberitahuan memberikan informasi seperti ID peserta dan ARN KVS yang mengalirkan audio peserta. Saat sesi MixedAudio streaming IndividualAudio atau streaming dimulai, kami mengirim chime:MediaPipelineKinesisVideoStreamStart acara. Sesi streaming berakhir saat peserta meninggalkan panggilan (untukIndividualAudio), atau saat rapat berakhir.

• Gunakan metadata persisten yang dikirim oleh Kinesis Video Streams dengan setiap fragmen. Metadata berisi informasi yang mirip dengan apa yang dikirim Event Bridge. Builder perlu mengurai semua aliran KinesisVideoStreamPool dengan menentukan nama pool sebagai awalan di Kinesis Video ListStreamsStreams API menggunakan solusi ini.

Pengakhiran pipeline Media Stream terjadi saat rapat dihapus, atau DeleteMediaPipelineAPI dipanggil untuk pipeline aliran media tersebut. Pemberitahuan Event Bridge juga dikirim untuk menunjukkan penghentian pipa media.