미디어 연결 파이프라인 구축

다단계 프로세스를 따라 Amazon Chime SDK 미디어 연결 파이프라인을 생성합니다. 다음 단계는 프로세스를 설명합니다.

1. 미디어 캡처 파이프라인의 데이터 싱크로 사용할 Amazon S3 버킷을 생성한 다음 버킷 정책을 구성합니다. S3 버킷의 서버 측 암호화 활성화에 대한 자세한 내용은 이 안내서의 Amazon S3 버킷에 대한 서버 측 암호화 활성화를 참조하십시오. 미디어 캡처 파이프라인과 함께 사용할 Amazon S3 버킷을 생성한 경우, 해당 버킷의 정책에 s3:GetObject 및 s3:ListBucket 작업을 추가해야 합니다. s3:ListBucket작업을 수행하려면 버킷에 대한 권한이 필요합니다. 다른 작업에는 버킷의 객체에 대한 권한이 필요합니다. 두 개의 서로 다른 Amazon 리소스 이름 (ARN) 을 사용하여 버킷 수준 및 객체 수준 권한을 지정해야 합니다.

   다음 예는 버킷 정책을 보여줍니다. 필요에 따라 이 예제를 복사하여 붙여넣습니다.

   {
       "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": "[Account-Id]"
                   }
               },
               "ArnLike": {
                   "aws:SourceArn": "arn:aws:chime:*:[Account-Id]:*"
               }
           },
       ],
   }

2. 미디어 연결 파이프라인의 데이터 싱크로 사용할 Amazon S3 버킷을 생성한 다음 버킷 정책을 구성합니다. S3 버킷의 서버 측 암호화 활성화에 대한 자세한 내용은 이 안내서의 Amazon S3 버킷에 대한 서버 측 암호화 활성화를 참조하십시오.

   다음 예는 정책을 보여줍니다.

   {
       "Version": "2012-10-17",
       "Id": "AWSChimeMediaConcatenationBucketPolicy",
       "Statement": [
           {
               "Sid": " AWSChimeMediaConcatenationBucketPolicy ",
               "Effect": "Allow",
               "Principal": {
                   "Service": ["mediapipelines.chime.amazonaws.com"]
               },
               "Action": [
                   "s3:PutObject",
                   "s3:PutObjectAcl"
               ],
               "Resource": "arn:aws:s3:::[Bucket-Name]/*",
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "[Account-Id]"
                   }
               },
               "ArnLike": {
                   "aws:SourceArn": "arn:aws:chime:*:[Account-Id]:*"
               }
           },
       ]
   }

   참고

   미디어 캡처 및 미디어 연결 파이프라인에 단일 S3 버킷을 사용할 수 있습니다. 하지만 그렇게 하려면 2단계에 표시된 미디어 연결 s3:GetObject 버킷 s3:ListBucket 정책에 및 권한을 추가해야 합니다. 연결 버킷 정책에 이러한 권한이 포함되지 않도록 하려면 각 파이프라인에 대해 별도의 버킷을 생성하세요.

3. CreateMediaCapturePipelineAPI를 사용하여 미디어 캡처 파이프라인을 생성하세요. 그 일환으로 파이프라인의 ARN을 가져오세요. ARN 가져오기에 대한 자세한 내용은 을 참조하십시오. 파이프라인 생성 개요 다음 단계에서 ARN을 사용합니다.

4. CreateMediaConcatenationPipelineAPI를 사용하여 연결 파이프라인을 생성합니다.

   다음 예시는 요청 본문을 보여줍니다. 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]"
               }
           }
       ]
   }

   캡처 파이프라인이 중지될 때마다 연결이 시작됩니다. 연결 파이프라인은 연결을 완료한 후 중지됩니다.