

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Chime SDK ミーティングでメディア連結パイプラインを作成する
<a name="create-concat-pipe"></a>

メディア連結パイプラインを使用し、メディアキャプチャパイプラインで生成したアーティファクト (ファイル) を連結します。

メディアキャプチャパイプラインでは、メディアストリームをチャンク化し、それらのアーティファクトを Amazon S3 バケットに保存することで、会議のコンテンツをキャプチャします。メディアキャプチャパイプラインでは、次のタイプのアーティファクトを作成します。
+  音声
+ 動画
+ 共有コンテンツ
+ データチャネルメッセージ
+ 文字起こしメッセージ
+ 会議イベント
+ 合成された動画 (共有コンテンツと複数の動画ストリームが動画タイルとしてグリッドに表示されます)。

メディア連結パイプラインを使用すると、各タイプのアーティファクトを 1 つのファイルに連結してから、それらの大容量のファイルを 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 連結パイプラインのアーキテクチャ
<a name="concat-architecture"></a>

次の図は、メディア連結パイプラインのアーキテクチャを示しています。

![\[メディア連結パイプラインのアーキテクチャを示す図。\]](http://docs.aws.amazon.com/ja_jp/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 メディア連結パイプラインの構築
<a name="create-concat-pipe-steps"></a>

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` アクションには、バケットに対するアクセス許可が必要です。その他のアクションには、バケット内のオブジェクトに対するアクセス許可が必要です。バケットレベルとオブジェクトレベルのアクセス許可を指定するには、2 つの異なる 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:*"
                   }
               }
           }
       ]
   }
   ```

------
**注記**  
1 つの 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 バケットフォルダ構造について
<a name="concat-folder-structure"></a>

メディア連結パイプラインの Amazon S3 バケットでは、このフォルダ構造が使用されています。

```
S3 bucket path/
  audio
  video
  composited-video
  data-channel
  meeting-events
  transcription-messages
```

**注記**  
メディアパイプラインの作成時にプレフィックスを指定すると、フォルダへのパスはバケット名/プレフィックスになります。プレフィックスなしの場合、パスはバケット名/メディアパイプライン ID になります。`S3BucketSinkConfiguration` オブジェクトの `Destination` フィールドでプレフィックスを指定します。連結されたファイル名は、メディアファイルの場合はメディアパイプライン ID.mp4、テキストファイルの場合はメディアパイプライン ID.txt になります。