Medienstream-Pipelines erstellen

Die Chime Media Stream-Pipeline muss zu demselben AWS Konto gehören wie das Amazon Chime SDK-Meeting. Sie erstellen die Amazon Chime SDK-Medienstream-Pipeline, indem Sie die CreateMediaStreamPipelineAPI aufrufen und eine Quelle und eine Senke angeben.

Das folgende Diagramm zeigt die Architektur einer Amazon Chime SDK-Medienstream-Pipeline. Die Zahlen im Diagramm entsprechen dem nummerierten Text unten.

Im Diagramm:

1. Sie rufen die CreateMediaStreamPipeline API auf. Geben Sie in der Anfrage die Quellen und Senken für die Streams an. Geben Sie an, ob Sie Einzelaudio, gemischtes Audio oder beides aufnehmen möchten. Geben Sie den ARN Ihres KVS-Pools in die Anfrage ein.

   • Das Quellen-Array besteht aus SourceType undSourceArn. Sie müssen die verwendenChimeSdkMeeting SourceType. Das SourceArn ist der ARN vonChimeSdkMeeting.

   • Das Sinks-Array besteht ausSinkType, SinkArnReservedStreamCapacity, undMediaStreamType. Wir unterstützen nur dieKinesisVideoStreamPoolSinkType. Das SinkArn ist der ARN vonKinesisVideoStreamPool. Der MediaStreamType steuert den Medientyp, der zur Senke gestreamt wird, entweder MixedAudio oderIndividualAudio. ReservedStreamCapacitylegt die Anzahl der Streams fest, die dem MediaStreamType KinesisVideoStreamPool vom zugewiesen wurden.

     • Wenn Sie IndividualAudio sowohl als auch streamen möchtenMixedAudio, erstellen Sie zwei Senkenobjekte im Sinks Array, eines für IndividualAudio und eines fürMixedAudio. Der SinkArn (der ARN vonKinesisVideoStreamPool) kann für jede Senke variieren.

     • Um nur einzelne Audiodaten oder gemischte Audiodaten zu streamen, erstellen Sie ein Senkenobjekt mit den gewünschten AudiodatenMediaStreamType.

   • Beachten Sie Folgendes:

     • Wenn Sie die CreateMediaStreamPipelineAPI mit KinesisVideoStreamPool as the aufrufenSinkType, SinkARN muss sie zu der Region der Steuerungsebene gehören, in der sie aufgerufen CreateMediaStreamPipeline wird.

       Wenn Sie beispielsweise eine Medienstream-Pipeline in erstellenus-east-1, müssen Sie einen KinesisVideoStreamPool Eingang verwenden. us-east-1

     • ReservedStreamCapacitysollte sein, 1 wenn Sie den angeben MixedAudioMediaStreamType, und dazwischen, 1-10 wenn Sie den angeben IndividualAudioMediaStreamType.

2. Die Datenebene der Medienpipeline ruft die PutMediaKVS-API auf, um einzelne Audiodaten in einem KVS-Stream zu speichern, der zu dem von Ihnen angegebenen KVS-Pool gehört.

3. Die Datenebene der Medienpipeline ruft die PutMedia KVS-API auf, um gemischtes Audio in einem Stream zu speichern, der zu dem von Ihnen angegebenen KVS-Pool gehört.

Anmerkung

Nach dem Aufruf der CreateMediaStreamPipelineAPI können Builder Medien-Pipeline-Ereignisse verwenden oder die GetMediaPipelineAPI aufrufen, um festzustellen, ob der Pipeline-Status lautet. InProgress

Sobald der Pipeline-Status erreicht istInProgress, werden die Medien — eine beliebige Kombination von IndividualAudio und MixedAudio — zu KVS gestreamt.

Für den IndividualAudio Stream-Typ besteht eine 1:1 -Zuordnung zwischen den Teilnehmer-IDs und dem aus dem zugewiesenen KVS-Stream. KinesisVideoStreamPool Die Zuordnung gilt für die gesamte Lebensdauer der Medienpipeline.

Um herauszufinden, welcher KVS-Stream einer Teilnehmer-ID zugeordnet ist oder für welchen er zugewiesen ist MixedAudio, verwenden Sie eine der folgenden Methoden:

• Verwenden Sie Event Bridge-Benachrichtigungen. Jede Benachrichtigung enthält Informationen wie Teilnehmer-IDs und den KVS-ARN, der das Audio des Teilnehmers streamt. Wenn eine IndividualAudio oder MixedAudio Streaming-Sitzung beginnt, senden wir ein Ereignis. chime:MediaPipelineKinesisVideoStreamStart Streaming-Sitzungen enden, wenn ein Teilnehmer den Anruf (fürIndividualAudio) verlässt oder wenn das Meeting endet.

• Verwenden Sie die persistenten Metadaten, die die Kinesis Video Streams mit jedem Fragment senden. Die Metadaten enthalten Informationen, die denen ähneln, die Event Bridge sendet. Builder müssen mit dieser Lösung alle Streams von analysieren, KinesisVideoStreamPool indem sie den Poolnamen als Präfix in der ListStreamsKinesis Video Streams Streams-API angeben.

Die Media Stream-Pipeline wird beendet, wenn das Meeting gelöscht oder die DeleteMediaPipelineAPI für diese Media-Stream-Pipeline aufgerufen wird. Eine Event Bridge-Benachrichtigung wird ebenfalls gesendet, um auf die Beendigung der Medienpipeline hinzuweisen.