기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Chime SDK 미디어 스트림 파이프라인 생성
<a name="create-stream-pipeline"></a>

차임 미디어 스트림 파이프라인은 Amazon Chime SDK 회의와 동일한 AWS 계정에 속해야 합니다. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html) API를 호출하고 소스와 싱크를 지정하여 Amazon Chime SDK 미디어 스트림 파이프라인을 생성합니다.

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

![\[다이어그램은 미디어 스트림 풀을 생성하는 API 직접 호출을 보여줍니다.\]](http://docs.aws.amazon.com/ko_kr/chime-sdk/latest/dg/images/media-stream-pipe-architecture.png)


다이어그램에서,

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`으로 싱크 오브젝트 하나를 만듭니다.
   + 다음 사항에 유의하세요.
     + `KinesisVideoStreamPool`을 `SinkType`으로 설정하여 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html) API를 간접 호출하는 경우 `SinkARN`은 `CreateMediaStreamPipeline`이 간접 호출되는 컨트롤 플레인 영역에 속해야 합니다.

       예를 들어 `us-east-1`에서 미디어 스트림 파이프라인을 생성하는 경우 `us-east-1`에서 `KinesisVideoStreamPool`을 사용해야 합니다.
     + `MixedAudio` `MediaStreamType`을 지정할 때는 `ReservedStreamCapacity`를 **1**이어야 하며, `IndividualAudio` `MediaStreamType`을 지정할 때는 **1-10** 사이여야 합니다.

1. 미디어 파이프라인 데이터 영역은 KVS [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) API를 직접 호출하여 지정한 KVS 풀에 속하는 KVS 스트림에 개별 오디오를 저장합니다.

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

**참고**  
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaStreamPipeline.html) API를 직접 호출한 후 빌더는 [미디어 파이프라인 이벤트](media-pipe-events.md)를 사용하거나 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html) API를 직접 호출하여 파이프라인 상태가 `InProgress`인지 확인할 수 있습니다.  
파이프라인 상태가 `InProgress`에 도달하면 미디어(`IndividualAudio`와 `MixedAudio`의 모든 조합)가 KVS로 스트리밍됩니다.  
`IndividualAudio` 스트림 유형의 경우 참석자 ID와 `KinesisVideoStreamPool`에서 할당된 KVS 스트림 사이에 1:1 매핑이 존재합니다. 매핑은 미디어 파이프라인의 수명 동안 적용됩니다.  
어떤 KVS 스트림이 참석자 ID에 매핑되는지 또는 MixedAudio에 할당되었는지 확인하려면 다음 기법 중 하나를 사용하세요.  
[EventBridge 알림](media-stream-event-bridge.md)을 사용합니다. 각 알림은 참석자 ID 및 참석자의 오디오를 스트리밍하는 KVS ARN과 같은 정보를 제공합니다. `IndividualAudio` 또는 `MixedAudio` 스트리밍 세션이 시작되면 `chime:MediaPipelineKinesisVideoStreamStart` 이벤트를 전송합니다. 스트리밍 세션은 참석자가 통화(`IndividualAudio` 관련)에서 나가거나 회의가 종료되면 종료됩니다.
Kinesis Video Streams가 각 프래그먼트와 함께 전송하는 영구 메타데이터를 사용합니다. 메타데이터에는 EventBridge가 전송하는 것과 유사한 정보가 포함되어 있습니다. 빌더는 이 솔루션을 통해 [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_ListStreams.html) Kinesis Video Streams API에서 풀 이름을 접두사로 지정하여 `KinesisVideoStreamPool`의 모든 스트림을 파싱해야 합니다.
미디어 스트림 파이프라인은 회의가 삭제되거나 해당 미디어 스트림 파이프라인에 대해 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) API가 간접 호출될 때 종료됩니다. [EventBridge 알림](media-pipe-events.md)도 전송되어 미디어 파이프라인 종료를 나타냅니다.