本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
提示媒體串流管道必須屬於與 Amazon Chime SDK 會議相同的 AWS 帳戶。您可以呼叫 來建立 Amazon Chime SDK 媒體串流管道 CreateMediaStreamPipeline API 並指定來源和接收器。
下圖顯示 Amazon Chime SDK 媒體串流管道的架構。圖表中的數字對應於下方的編號文字。
在圖表中:
您呼叫
CreateMediaStreamPipeline
API。在請求中,指定串流的來源和接收端。您要擷取個別音訊、混合音訊,還是同時擷取兩者。在請求中包含ARN集KVS區的 。來源陣列由
SourceType
和 組成SourceArn
。您必須使用ChimeSdkMeeting SourceType
。SourceArn
是 ARN的ChimeSdkMeeting
。-
接收器陣列包含
SinkType
、SinkArn
、ReservedStreamCapacity
和MediaStreamType
。我們僅支援KinesisVideoStreamPoolSinkType
。SinkArn
是 ARN的KinesisVideoStreamPool
。MediaStreamType
控制串流至 接收端的媒體類型,可以是MixedAudio
或IndividualAudio
。ReservedStreamCapacity
會設定MediaStreamType
從 為 配置的串流數目KinesisVideoStreamPool
。如果您想要同時串流
IndividualAudio
和MixedAudio
,請在Sinks
陣列中建立兩個接收器物件,一個用於IndividualAudio
,另一個用於MixedAudio
。SinkArn
( ARN的KinesisVideoStreamPool
) 會因每個儲存槽而異。若要僅串流個別音訊或混合音訊,請使用所需的 建立一個接收器物件
MediaStreamType
。
-
注意下列事項:
-
叫用 時 CreateMediaStreamPipeline API 使用
KinesisVideoStreamPool
作為SinkType
,SinkARN
必須屬於CreateMediaStreamPipeline
正在調用 的控制平面區域。例如,如果您在 中建立媒體串流管道
us-east-1
,則必須在KinesisVideoStreamPool
中使用us-east-1
。 ReservedStreamCapacity
當您指定MixedAudio
1
時,應該是MediaStreamType
,而當您指定1-10
時,應該是IndividualAudio
介於 之間MediaStreamType
。
-
媒體管道資料平面會呼叫 KVS PutMediaAPI,將個別音訊存放在屬於您指定KVS集區的KVS串流中。
媒體管道資料平面會呼叫 KVS
PutMedia
API,將混合音訊存放在屬於您指定KVS集區的串流中。
注意
呼叫 之後 CreateMediaStreamPipeline API,建置器可以使用媒體管道事件或呼叫 GetMediaPipeline API 以判斷管道狀態是否為 InProgress
。
一旦管道狀態達到 InProgress
,媒體 - IndividualAudio
和 的任何組合 MixedAudio
- 串流到 KVS。
對於IndividualAudio
串流類型,出席者IDs與從 配置的KVS串流之間存在 1:1 映射KinesisVideoStreamPool
。映射適用於媒體管道的生命週期。
若要知道指派給出席者 ID 或 的KVS串流對應 MixedAudio,請使用下列其中一項技術:
使用事件橋接通知 。每個通知都會提供出席者IDs和串流出席者音訊的 KVS ARN 等資訊。當
IndividualAudio
或MixedAudio
串流工作階段開始時,我們會傳送chime:MediaPipelineKinesisVideoStreamStart
事件。串流工作階段會在出席者離開通話 (適用於IndividualAudio
) 或會議結束時結束。使用 Kinesis Video Streams 隨每個片段傳送的持久中繼資料。中繼資料包含與 Event Bridge 傳送內容類似的資訊。建置器需要剖析 的所有串流
KinesisVideoStreamPool
,方法是將集區名稱指定為 中的字首 ListStreams API使用此解決方案的 Kinesis Video Streams。
刪除會議或 DeleteMediaPipeline API 會針對該媒體串流管道叫用 。也會傳送 Event Bridge 通知,以指示媒體管道終止。