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

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

1. 미디어 캡처 파이프라인의 데이터 싱크로 사용할 Amazon S3 버킷을 생성한 다음 버킷 정책을 구성합니다. Amazon S3 버킷의 서버 측 암호화를 활성화하는 방법에 대한 자세한 내용은 이 안내서의 Amazon Amazon S3 버킷에 대한 서버 측 암호화 활성화를 참조하십시오. 미디어 캡처 파이프라인과 함께 사용할 Amazon 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 Amazon S3 버킷을 생성한 다음 버킷 정책을 구성합니다. Amazon S3 버킷의 서버 측 암호화를 활성화하는 방법에 대한 자세한 내용은 이 안내서의 Amazon 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]:*"
                   }
               }
           }
       ],
   }

   참고

   미디어 캡처 및 미디어 연결 파이프라인에 Amazon 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]"
               }
           }
       ]
   }

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