本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 為 Amazon Chime SDK 會議建立媒體串連管道
<a name="create-concat-pipe"></a>

您可以使用媒體串連管道串連媒體擷取管道產生的成品 （檔案）。

媒體擷取管道會壓縮媒體串流，並將這些成品存放在 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 串連管道架構
<a name="concat-architecture"></a>

下圖顯示媒體串連管道的架構。

![\[顯示媒體串連管道架構的圖表。\]](http://docs.aws.amazon.com/zh_tw/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` 動作需要儲存貯體的許可。其他動作需要儲存貯體中物件的許可。您必須使用兩個不同的 Amazon Resource Name (ARNs) 來指定儲存貯體層級和物件層級許可。

   下列範例顯示儲存貯體政策。視需要複製並貼上此範例。

------
#### [ 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 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 儲存貯體進行媒體擷取和媒體串連管道。不過，如果您這樣做，則必須將 `s3:GetObject`和 `s3:ListBucket`許可新增至步驟 2 中顯示的媒體串連儲存貯體政策。如果您不希望串連儲存貯體政策具有這些許可，請為每個管道建立單獨的儲存貯體。

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 建立串連管道。

   下列範例顯示請求內文。*路徑*欄位是選用的，預設為串連管道的 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 組成。