Streaming data pesan - Amazon Chime SDK

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

Streaming data pesan

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 denganAppInstance.

  • Nama aliran memiliki awalan yang dimulai denganchime-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"

  2. Konfigurasikan streaming dengan memanggil PutMessagingStreamingConfigurationsAPI.

    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:

    DataType Jenis acara yang dihasilkan

    ChannelMessage

    CREATE_CHANNEL_MESSAGE

    REDACT_CHANNEL_MESSAGE

    UPDATE_CHANNEL_MESSAGE

    DELETE_CHANNEL_MESSAGE

    Channel

    CREATE_CHANNEL

    CREATE_SUB_CHANNEL

    UPDATE_CHANNEL

    DELETE_CHANNEL

    UPDATE_CHANNEL_EXPIRATION_SETTINGS

    DELETE_SUB_CHANNEL

    CREATE_CHANNEL_MEMBERSHIP

    DELETE_CHANNEL_MEMBERSHIP

    CREATE_CHANNEL_BAN

    DELETE_CHANNEL_BAN

    CREATE_CHANNEL_MODERATOR

    DELETE_CHANNEL_MODERATOR

  3. 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.

EventType Format muatan

CREATE_CHANNEL_MESSAGE

Channel message

REDACT_CHANNEL_MESSAGE

UPDATE_CHANNEL_MESSAGE

DELETE_CHANNEL_MESSAGE

CREATE_CHANNEL

Channel

UPDATE_CHANNEL

DELETE_CHANNEL

UPDATE_CHANNEL_EXPIRATION_SETTINGS

CREATE_CHANNEL_MEMBERSHIP

ChannelMembership

DELETE_CHANNEL_MEMBERSHIP

CREATE_CHANNEL_BAN

ChannelBan

DELETE_CHANNEL_BAN

CREATE_CHANNEL_MODERATOR

ChannelModerator

DELETE_CHANNEL_MODERATOR

CREATE_SUB_CHANNEL

channelARN

SubChannelId

DELETE_SUB_CHANNEL