기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Chime SDK 회의용 미디어 연결 파이프라인 생성 미디어 연결 파이프라인을 사용하여 미디어 캡처 파이프라인에서 생성된 아티팩트(파일)를 연결합니다. 미디어 캡처 파이프라인은 미디어 스트림을 청크하고 해당 아티팩트를 Amazon S3 버킷에 저장하여 회의 콘텐츠를 캡처합니다. 미디어 캡처 파이프라인은 다음 아티팩트 유형을 생성합니다. + 오디오 + 비디오 + 콘텐츠 공유 + 데이터 채널 메시지 + 트랜스크립션 메시지 + 회의 이벤트 + 합성된 비디오(콘텐츠 공유 및 여러 비디오 스트림을 그리드에 비디오 타일로 표시) 미디어 연결 파이프라인을 사용하면 각 아티팩트 유형을 단일 파일로 연결한 다음 더 커진 파일을 Amazon S3 버킷에 저장할 수 있습니다. 미디어 캡처 이벤트 종료를 기다리지 않고 미디어 연결 파이프라인을 생성할 수 있지만 연결 파이프라인은 캡처 파이프라인이 중지될 때만 연결을 시작합니다. **참고** 미디어 캡처 파이프라인, 미디어 연결 파이프라인 및 Amazon S3 버킷은 동일한 AWS 계정에 있어야 합니다. **Topics** + [ # Amazon Chime SDK 연결 파이프라인 아키텍처 ](concat-architecture.md) + [ # Amazon Chime SDK 미디어 연결 파이프라인 구축 ](create-concat-pipe-steps.md) + [ # Amazon Chime SDK 연결 파이프라인의 Amazon S3 버킷 폴더 구조 이해 ](concat-folder-structure.md) # Amazon Chime SDK 연결 파이프라인 아키텍처 다음 다이어그램은 미디어 연결 파이프라인의 아키텍처를 보여줍니다. ![\[미디어 연결 파이프라인의 아키텍처를 보여주는 다이어그램입니다.\]](http://docs.aws.amazon.com/ko_kr/chime-sdk/latest/dg/images/concatenation-pipe-architecture-2.png) 이 다이어그램에서 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) 요청을 받으면 미디어 파이프라인 컨트롤 플레인이 미디어 파이프라인 데이터 플레인에서 미디어 캡처 파이프라인을 시작합니다. 그러면 데이터 영역은 캡처된 청크를 5초마다 캡처 버킷으로 푸시합니다. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html) 요청을 받으면 미디어 파이프라인 컨트롤 플레인은 지정된 미디어 캡처 파이프라인이 완료될 때까지 기다렸다가 미디어 파이프라인 데이터 플레인에서 미디어 연결 파이프라인을 시작합니다. 그런 다음 데이터 영역은 캡처된 청크를 버킷에서 읽고 연결된 아티팩트를 연결 버킷으로 푸시합니다. # Amazon Chime SDK 미디어 연결 파이프라인 구축 다단계 프로세스를 따라 Amazon Chime SDK 미디어 연결 파이프라인을 생성합니다. 다음 단계에서는 프로세스에 대해 설명합니다. 1. 미디어 캡처 파이프라인의 데이터 싱크로 사용할 Amazon S3 버킷을 생성한 다음 버킷 정책을 구성합니다. Amazon S3 버킷의 서버 측 암호화를 활성화하는 방법에 대한 자세한 내용은 본 설명서의 [Amazon S3 버킷에 대해 서버 측 암호화 활성화](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html)를 참조하세요. 미디어 캡처 파이프라인과 함께 사용할 Amazon S3 버킷을 생성한 경우, 해당 버킷의 정책에 `s3:GetObject` 및 `s3:ListBucket` 작업을 추가해야 합니다. `s3:ListBucket` 작업은 버킷에 대한 권한이 필요합니다. 다른 작업에는 버킷의 객체에 대한 권한이 필요합니다. 두 개의 서로 다른 Amazon 리소스 이름(ARN)을 사용하여 버킷 수준 및 객체 수준 권한을 지정해야 합니다. 다음 예제는 버킷 정책을 보여줍니다. 필요에 따라 이 예제를 복사하여 붙여 넣습니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "AWSChimeMediaCaptureBucketPolicy", "Statement": [ { "Sid": "AWSChimeMediaCaptureBucketPolicy", "Effect": "Allow", "Principal": { "Service": [ "mediapipelines.chime.amazonaws.com" ] }, "Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::[Bucket-Name]/*", "arn:aws:s3:::[Bucket-Name]" ], "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*:123456789012:*" } } } ] } ``` ------ 1. 미디어 연결 파이프라인의 데이터 싱크로 사용할 Amazon S3 버킷을 생성한 다음 버킷 정책을 구성합니다. Amazon S3 버킷의 서버 측 암호화를 활성화하는 방법에 대한 자세한 내용은 본 설명서의 [Amazon S3 버킷에 대해 서버 측 암호화 활성화](https://docs.aws.amazon.com/chime-sdk/latest/dg/sse-kms.html)를 참조하세요. 다음 예제는 정책을 보여줍니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Id": "AWSChimeMediaConcatenationBucketPolicy", "Statement": [ { "Sid": " AWSChimeMediaConcatenationBucketPolicy ", "Effect": "Allow", "Principal": { "Service": [ "mediapipelines.chime.amazonaws.com" ] }, "Action": [ "s3:PutObject", "s3:PutObjectAcl", "s3:GetObject", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::[Bucket-Name]/*", "arn:aws:s3:::[Bucket-Name]" ], "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012" }, "ArnLike": { "aws:SourceArn": "arn:aws:chime:*:123456789012:*" } } } ] } ``` ------ **참고** 미디어 캡처 및 미디어 연결 파이프라인에 단일 Amazon S3 버킷을 사용할 수 있습니다. 하지만 그렇게 하려면 2단계에 표시된 미디어 연결 버킷 정책에 `s3:GetObject` 및 `s3:ListBucket` 권한을 추가해야 합니다. 연결 버킷 정책에 이러한 권한이 포함되지 않도록 하려면 각 파이프라인에 별도의 버킷을 생성합니다. 1. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html) API를 사용하여 미디어 캡처 파이프라인을 생성합니다. 해당 작업의 일환으로 파이프라인의 ARN을 가져옵니다. ARN 가져오기에 대한 자세한 내용은 [Amazon Chime SDK 미디어 파이프라인 생성 이해](create-pipeline.md)를 참조하세요. 다음 단계에서 ARN을 사용합니다. 1. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaConcatenationPipeline.html) API를 사용하여 연결 파이프라인을 생성합니다. 다음 예제는 요청 본문을 보여줍니다. *Path* 필드는 선택 사항이며, 연결 파이프라인의 ID가 기본값입니다. **참고** 지난 30일 이내에 생성한 `MediaPipelineArn`을 사용해야 합니다. ``` { "Sources": [ { "Type": "MediaCapturePipeline", "MediaCapturePipelineSourceConfiguration": { "MediaPipelineArn": "Media_Pipeline_Arn", //must be <30 days old "ChimeSdkMeetingConfiguration": { "ArtifactsConfiguration": { "Audio": { "State": "Enabled" }, "Video": { "State": "Enabled | Disabled" }, "Content": { "State": "Enabled | Disabled" }, "DataChannel": { "State": "Enabled | Disabled" }, "TranscriptionMessages": { "State": "Enabled | Disabled" }, "MeetingEvents": { "State": "Enabled | Disabled" }, "CompositedVideo": { "State": "Enabled | Disabled" } } } } } ], "Sinks": [ { "Type": "S3Bucket", "S3BucketSinkConfiguration": { "Destination": "arn:aws:s3:::[Bucket_Name]/[Path]" } } ] } ``` 캡처 파이프라인이 중지될 때마다 연결이 시작됩니다. 연결 파이프라인은 연결을 완료한 후 중지됩니다. # Amazon Chime SDK 연결 파이프라인의 Amazon S3 버킷 폴더 구조 이해 미디어 연결 파이프라인용 Amazon S3 버킷은 다음과 같은 폴더 구조를 사용합니다. ``` S3 bucket path/ audio video composited-video data-channel meeting-events transcription-messages ``` **참고** 미디어 파이프라인을 생성할 때 접두사를 지정하면 폴더 경로가 *버킷 이름*/*접두사*가 됩니다. 접두사가 없는 경우 경로는 *버킷 이름*/*미디어 파이프라인 ID*가 됩니다. `S3BucketSinkConfiguration` 객체의 `Destination` 필드에 접두사를 지정합니다. 연결된 파일 이름은 미디어 파일의 경우 *미디어 파이프라인 ID*.mp4로, 텍스트 파일의 경우 *미디어 파이프라인 ID*.txt로 구성됩니다.