미디어 스트림 파이프라인 생성

차임 미디어 스트림 파이프라인은 Amazon Chime SDK 미팅과 동일한 AWS 계정에 속해야 합니다. CreateMediaStreamPipelineAPI를 호출하고 소스와 싱크를 지정하여 Amazon Chime SDK 미디어 스트림 파이프라인을 생성합니다.

다음 다이어그램은 Amazon Chime SDK 미디어 스트림 파이프라인의 아키텍처를 보여줍니다. 다이어그램의 숫자는 아래 번호가 매겨진 텍스트에 해당합니다.

다이어그램에서,

1. 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으로 싱크 오브젝트 하나를 만듭니다.

   • 유의할 사항:

     • KinesisVideoStreamPoolas를 CreateMediaStreamPipeline사용하여 API를 호출할 때는 CreateMediaStreamPipeline 호출되는 컨트롤 플레인 영역에 SinkARN 속해야 합니다. SinkType

       예를 들어 us-east-1에서 미디어 스트림 파이프라인을 생성하는 경우 us-east-1에서 KinesisVideoStreamPool을 사용해야 합니다.

     • MixedAudio MediaStreamType을 지정할 때는 ReservedStreamCapacity를 1이어야 하며, IndividualAudio MediaStreamType을 지정할 때는 1-10 사이여야 합니다.

2. 미디어 파이프라인 데이터 플레인은 KVS PutMediaAPI를 호출하여 지정된 KVS 풀에 속하는 KVS 스트림에 개별 오디오를 저장합니다.

3. 미디어 파이프라인 데이터 영역은 KVS PutMedia API를 직접 호출하여 지정한 KVS 풀에 속하는 스트림에 혼합 오디오를 저장합니다.

참고

빌더는 CreateMediaStreamPipelineAPI를 호출한 후 미디어 파이프라인 이벤트를 사용하거나 GetMediaPipelineAPI를 호출하여 파이프라인 상태가 올바른지 확인할 수 있습니다. 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가 전송하는 것과 유사한 정보가 포함되어 있습니다. 빌더는 이 솔루션을 사용하여 Kinesis Video Streams API에서 풀 이름을 접두사로 KinesisVideoStreamPool 지정하여 의 모든 ListStreams스트림을 구문 분석해야 합니다.

미디어 스트림 파이프라인 종료는 회의가 삭제되거나 해당 미디어 스트림 파이프라인에 대한 DeleteMediaPipelineAPI가 호출될 때 발생합니다. EventBridge 알림도 전송되어 미디어 파이프라인 종료를 나타냅니다.