기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
차임 미디어 스트림 파이프라인은 Amazon Chime SDK 회의와 동일한 AWS 계정에 속해야 합니다. CreateMediaStreamPipeline API를 호출하고 소스와 싱크를 지정하여 Amazon Chime SDK 미디어 스트림 파이프라인을 생성합니다.
다음 다이어그램은 Amazon Chime SDK 미디어 스트림 파이프라인의 아키텍처를 보여줍니다. 다이어그램의 숫자는 아래 번호가 매겨진 텍스트에 해당합니다.

다이어그램에서,
-
CreateMediaStreamPipeline
API를 직접 호출합니다. 요청에서 스트림의 소스와 싱크를 지정합니다. 개별 오디오나 믹스된 오디오, 아니면 둘 다를 캡처할지를 지정합니다. 요청에 KVS 풀의 ARN을 포함합니다.-
소스 배열은
SourceType
및SourceArn
으로 구성됩니다.ChimeSdkMeeting SourceType
을 사용해야 합니다.SourceArn
은ChimeSdkMeeting
의 ARN입니다. -
싱크 배열은
SinkType
,SinkArn
,ReservedStreamCapacity
및MediaStreamType
으로 구성됩니다.KinesisVideoStreamPoolSinkType
만 지원합니다.SinkArn
은KinesisVideoStreamPool
의 ARN입니다.MediaStreamType
은 싱크로 스트리밍되는 미디어 유형MixedAudio
또는IndividualAudio
를 제어합니다.ReservedStreamCapacity
는KinesisVideoStreamPool
에서MediaStreamType
에 할당된 스트림 수를 설정합니다.-
IndividualAudio
및MixedAudio
를 모두 스트리밍하려면Sinks
배열에IndividualAudio
에 대한 하나,MixedAudio
에 대한 다른 하나로 두 개의 싱크 객체를 만듭니다.SinkArn
(KinesisVideoStreamPool
의 ARN)은 싱크마다 다를 수 있습니다. -
개별 오디오 또는 믹스된 오디오만 스트리밍하려면 원하는
MediaStreamType
으로 싱크 오브젝트 하나를 만듭니다.
-
-
다음 사항에 유의하세요.
-
KinesisVideoStreamPool
을SinkType
으로 설정하여 CreateMediaStreamPipeline API를 간접 호출하는 경우SinkARN
은CreateMediaStreamPipeline
이 간접 호출되는 컨트롤 플레인 영역에 속해야 합니다.예를 들어
us-east-1
에서 미디어 스트림 파이프라인을 생성하는 경우us-east-1
에서KinesisVideoStreamPool
을 사용해야 합니다. -
MixedAudio
MediaStreamType
을 지정할 때는ReservedStreamCapacity
를1
이어야 하며,IndividualAudio
MediaStreamType
을 지정할 때는1-10
사이여야 합니다.
-
-
-
미디어 파이프라인 데이터 영역은 KVS PutMedia API를 직접 호출하여 지정한 KVS 풀에 속하는 KVS 스트림에 개별 오디오를 저장합니다.
-
미디어 파이프라인 데이터 영역은 KVS
PutMedia
API를 직접 호출하여 지정한 KVS 풀에 속하는 스트림에 혼합 오디오를 저장합니다.
참고
CreateMediaStreamPipeline API를 직접 호출한 후 빌더는 미디어 파이프라인 이벤트를 사용하거나 GetMediaPipeline API를 직접 호출하여 파이프라인 상태가 InProgress
인지 확인할 수 있습니다.
파이프라인 상태가 InProgress
에 도달하면 미디어(IndividualAudio
와 MixedAudio
의 모든 조합)가 KVS로 스트리밍됩니다.
IndividualAudio
스트림 유형의 경우 참석자 ID와 KinesisVideoStreamPool
에서 할당된 KVS 스트림 사이에 1:1 매핑이 존재합니다. 매핑은 미디어 파이프라인의 수명 동안 적용됩니다.
어떤 KVS 스트림이 참석자 ID에 매핑되는지 또는 MixedAudio에 할당되었는지 확인하려면 다음 기법 중 하나를 사용하세요.
-
EventBridge 알림을 사용합니다. 각 알림은 참석자 ID 및 참석자의 오디오를 스트리밍하는 KVS ARN과 같은 정보를 제공합니다.
IndividualAudio
또는MixedAudio
스트리밍 세션이 시작되면chime:MediaPipelineKinesisVideoStreamStart
이벤트를 전송합니다. 스트리밍 세션은 참석자가 통화(IndividualAudio
관련)에서 나가거나 회의가 종료되면 종료됩니다. -
Kinesis Video Streams가 각 프래그먼트와 함께 전송하는 영구 메타데이터를 사용합니다. 메타데이터에는 EventBridge가 전송하는 것과 유사한 정보가 포함되어 있습니다. 빌더는 이 솔루션을 통해 ListStreams Kinesis Video Streams API에서 풀 이름을 접두사로 지정하여
KinesisVideoStreamPool
의 모든 스트림을 파싱해야 합니다.
미디어 스트림 파이프라인은 회의가 삭제되거나 해당 미디어 스트림 파이프라인에 대해 DeleteMediaPipeline API가 간접 호출될 때 종료됩니다. EventBridge 알림도 전송되어 미디어 파이프라인 종료를 나타냅니다.