

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Streaming data perpesanan di perpesanan Amazon Chime SDK
<a name="streaming-export"></a>

Anda dapat mengonfigurasi data `AppInstance` untuk menerima, seperti pesan dan acara saluran, dalam bentuk aliran. Anda kemudian dapat bereaksi terhadap data tersebut secara real time. Saat ini, pesan Amazon Chime SDK hanya menerima aliran Kinesis sebagai tujuan streaming. Anda harus memiliki prasyarat ini untuk menggunakan aliran Kinesis dengan fitur ini:
+ Aliran Kinesis harus dalam AWS akun yang sama dengan. `AppInstance`
+ Aliran harus berada di wilayah yang sama dengan`AppInstance`.
+ Nama aliran memiliki awalan yang dimulai dengan`chime-messaging-`.
+ Anda harus mengkonfigurasi setidaknya dua pecahan. Setiap pecahan dapat menerima data hingga 1MB per detik, jadi skala streaming Anda sesuai dengan itu.
+ Anda harus mengaktifkan enkripsi sisi server (SSE).

**Untuk mengkonfigurasi aliran Kinesis**

1. Buat satu atau lebih aliran Kinesis menggunakan prasyarat di bagian sebelumnya, lalu dapatkan ARN. Pastikan pemanggil memiliki izin Kinesis selain izin Amazon Chime.

   Contoh berikut menunjukkan cara menggunakan AWS CLI untuk membuat aliran Kinesis dengan dua pecahan, dan cara mengaktifkan 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. Konfigurasikan streaming dengan memanggil [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.

   Anda dapat mengonfigurasi satu atau kedua dari dua tipe data, dan Anda dapat memilih aliran yang sama atau aliran terpisah untuk mereka.

   Contoh berikut menunjukkan bagaimana menggunakan AWS CLI untuk mengkonfigurasi `appinstance` untuk streaming `ChannelMessage` dan tipe `Channel` data.

   ```
   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}}
   ```

   Tipe data memiliki cakupan berikut:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/streaming-export.html)

1. Mulai membaca data dari aliran Kinesis yang dikonfigurasi.
**catatan**  
Setiap peristiwa yang dikirim sebelum Anda mengonfigurasi streaming tidak dikirim ke aliran Kinesis Anda.

**Format data**  
Kinesis mengeluarkan catatan dalam format JSON dengan bidang berikut: dan. `EventType` `Payload` Format payload tergantung pada. `EventType` Tabel berikut mencantumkan jenis acara dan format payload yang sesuai.


<table>
<thead>
  <tr><th>EventType</th><th>Format muatan</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></tr>
  <tr><td>`REDACT_CHANNEL_MESSAGE`</td></tr>
  <tr><td>`UPDATE_CHANNEL_MESSAGE`</td></tr>
  <tr><td>`DELETE_CHANNEL_MESSAGE`</td></tr>
  <tr><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></tr>
  <tr><td>`UPDATE_CHANNEL`</td></tr>
  <tr><td>`DELETE_CHANNEL`</td></tr>
  <tr><td>`UPDATE_CHANNEL_EXPIRATION_SETTINGS`</td></tr>
  <tr><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></tr>
  <tr><td>`DELETE_CHANNEL_MEMBERSHIP`</td></tr>
  <tr><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></tr>
  <tr><td>`DELETE_CHANNEL_BAN`</td></tr>
  <tr><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></tr>
  <tr><td>`DELETE_CHANNEL_MODERATOR`</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></tr>
  <tr><td>`DELETE_SUB_CHANNEL`</td></tr>
</tbody>
</table>
