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

# 在 Amazon Chime SDK 訊息中串流訊息資料
<a name="streaming-export"></a>

您可以設定 `AppInstance` 以串流的形式接收資料，例如訊息和頻道事件。然後，您可以即時回應該資料。目前，Amazon Chime SDK 訊息僅接受 Kinesis 串流做為串流目的地。您必須具備這些先決條件，才能使用 Kinesis 串流與此功能：
+ Kinesis 串流必須與 位於相同的 AWS 帳戶中`AppInstance`。
+ 串流必須與 位於相同的區域`AppInstance`。
+ 串流名稱的字首開頭為 `chime-messaging-`。
+ 您必須設定至少兩個碎片。每個碎片每秒最多可接收 1MB 的資料，因此請相應地擴展串流。
+ 您必須啟用伺服器端加密 (SSE)。

**設定 Kinesis 串流**

1. 使用上一節的先決條件建立一或多個 Kinesis 串流，然後取得 ARN。確保發起人除了 Amazon Chime 許可外還有 Kinesis 許可。

   下列範例示範如何使用 AWS CLI 建立具有兩個碎片的 Kinesis 串流，以及如何啟用 SSE。

   `aws kinesis create-stream --stream-name {{chime-messaging-unique-name}} --shard-count {{2}}`

   `aws kinesis start-stream-encryption --stream-name {{chime-messaging-unique-name}} --encryption-type KMS --key-id "{{alias}}/aws/kinesis"`

1. 呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html) API 來設定串流。

   您可以設定兩種資料類型中的一種或兩種，並且可以為它們選擇相同的串流或單獨的串流。

   下列範例示範如何使用 AWS CLI 來設定 `appinstance`以串流 `ChannelMessage`和 `Channel`資料類型。

   ```
   aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn {{app_instance_arn}} \
   --streaming-configurations DataType=ChannelMessage,ResourceArn={{kinesis_data_stream_arn}}
   ```

   ```
   aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn {{app_instance_arn}} \
   --streaming-configurations DataType=Channel,ResourceArn={{kinesis_data_stream_arn}}
   ```

   資料類型的範圍如下：    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/streaming-export.html)

1. 開始從設定的 Kinesis 串流讀取資料。
**注意**  
在您設定串流之前傳送的任何事件都不會傳送到您的 Kinesis 串流。

**資料格式**  
Kinesis 會使用下列欄位以 JSON 格式輸出記錄： `EventType`和 `Payload`。承載格式取決於 `EventType`。下表列出事件類型及其對應的承載格式。


<table>
<thead>
  <tr><th>EventType</th><th>承載格式</th><th></th></tr>
</thead>
<tbody>
  <tr><td>`CREATE_CHANNEL_MESSAGE`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html) </td><td></td></tr>
  <tr><td>`REDACT_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html) </td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_EXPIRATION_SETTINGS`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MEMBERSHIP`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MEMBERSHIP`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_BAN`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_BAN`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MODERATOR`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MODERATOR`</td><td></td></tr>
  <tr><td>`CREATE_SUB_CHANNEL`</td><td rowspan="2">[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax)<br />[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId)</td><td></td></tr>
  <tr><td>`DELETE_SUB_CHANNEL`</td><td></td></tr>
</tbody>
</table>