Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan saluran elastis untuk menyelenggarakan acara langsung dalam rapat Amazon Chime SDK
Saluran elastis mendukung pengalaman obrolan skala besar dengan hingga 1 juta anggota. Penggunaan umum termasuk pesta menonton untuk acara olahraga atau politik. Anda dapat menggunakan saluran elastis hanya di wilayah AS Timur (Virginia N.).
Saluran elastis terdiri dari satu saluran dengan konfigurasi umum, ditambah jumlah sub-saluran yang bervariasi atau *elastis*. Konfigurasi juga mencakup ambang minimum dan maksimum untuk anggota di sub-saluran.
Misalnya, Anda membuat saluran elastis dengan 100 sub-saluran, dan untuk sub-saluran Anda menetapkan ambang batas rendah 500 anggota dan ambang batas tinggi 10.000 anggota. Ketika pengguna bergabung dengan saluran contoh ini, sistem secara otomatis menetapkannya ke satu sub-saluran hingga jumlah anggota melebihi 10.000. Pada saat itu, sistem membuat sub-saluran baru dan menambahkan anggota baru di sana. Saat pengguna pergi, sistem menghapus sub-saluran dan mendistribusikan anggota di seluruh sub-saluran yang tersisa.
Memisahkan audiens di seluruh sub-saluran membuat percakapan lebih mudah diikuti oleh peserta. Moderator juga mengurangi beban kerja, karena mereka hanya perlu menonton beberapa sub-saluran. Selain itu, moderator dapat menggunakan alat bawaan yang disediakan saluran elastis. Misalnya, moderator dapat [melarang pengguna](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html) dari saluran, [membuat moderator](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html), dan menggunakan [alur saluran](https://docs.aws.amazon.com/chime-sdk/latest/dg/using-channel-flows.html) untuk memoderasi semua pesan di saluran secara otomatis.
*Untuk informasi selengkapnya tentang kuota Amazon Chime SDK Messaging, lihat [Kuota Pesan di](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) Referensi Umum Amazon Chime SDK.*
**Topics**
+ [Prasyarat](#elastic-prereqs)
+ [Konsep saluran elastis](#elastic-concepts)
+ [Fitur tambahan yang didukung](#additional-features)
+ [Membuat saluran elastis untuk rapat Amazon Chime SDK](create-elastic-channel.md)
+ [Mengelola anggota saluran elastis untuk rapat Amazon Chime SDK](manage-elastic-members.md)
+ [Mengirim pesan saluran elastis dalam rapat Amazon Chime SDK](send-messages-elastic.md)
+ [Memahami pesan WebSocket sistem di saluran elastis untuk rapat Amazon Chime SDK](websocket-messages-elastic.md)
+ [Menggunakan aliran Kinesis untuk menerima pesan sistem untuk rapat Amazon Chime SDK](elastic-onboard-streams.md)
+ [Menguji saluran elastis untuk rapat Amazon Chime SDK di aplikasi demo kami](elastic-testing.md)
## Prasyarat
Anda harus memiliki yang berikut untuk menggunakan saluran elastis.
+ Pengetahuan tentang fungsionalitas Amazon Chime SDK Messaging, seperti mengelola saluran, serta mengirim serta menerima pesan.
+ Kemampuan untuk memanggil Amazon Chime SDK Messaging. APIs
## Konsep saluran elastis
Untuk menggunakan saluran elastis secara efektif, Anda harus memahami konsep-konsep ini.
**Sub-saluran**
Saluran elastis membagi anggotanya menjadi wadah logis yang disebut sub-saluran. Saat Anda menambahkan `AppInstanceUser` ke saluran elastis, pengguna menjadi anggota sub-saluran. Pengguna itu dapat mengirim dan menerima pesan, tetapi hanya dengan anggota lain dari sub-saluran itu. Sistem tidak pernah mengizinkan pesan dari satu sub-saluran muncul di sub-saluran lain.
**Penskalaan**
Untuk mendukung keterlibatan pengguna, setiap sub-saluran harus memenuhi persyaratan keanggotaan minimum. Anda memberikan nilai itu saat Anda membuat saluran elastis. Saat pengguna bergabung atau meninggalkan acara, sistem mentransfer anggota ke sub-saluran yang berbeda, yang membuat keseluruhan saluran “elastis.” Sub-saluran menjalankan tindakan penskalaan berikut.
+ **SCALE\$1OUT** — Ketika permintaan keanggotaan saluran elastis baru masuk dan semua sub-saluran penuh, sistem akan menskalakan dengan membuat sub-saluran baru, dan kemudian mentransfer keanggotaan dari sub-saluran yang ada ke sub-saluran baru.
+ **SCALE\$1IN** — Ketika jumlah keanggotaan sub-saluran berada di bawah persyaratan minimum, dan sub-saluran lain memiliki kapasitas untuk mengakomodasi semua anggota sub-saluran pertama, `SCALE_IN` acara mentransfer keanggotaan tersebut, dan kemudian menghapus sub-saluran dan semua pesan.
Jika Anda perlu mengakses pesan dari saluran yang telah dihapus, Anda harus mengaktifkan streaming pesan terlebih dahulu. Untuk informasi lebih lanjut, lihat[Streaming data perpesanan di perpesanan Amazon Chime SDK](streaming-export.md).
**Transfer anggota**
Ini terjadi ketika keseimbangan keanggotaan memindahkan `AppInstanceUser` dari satu sub-saluran ke sub-saluran lainnya. `AppInstanceUser`Masih milik saluran elastis setelah transfer. Namun, sub-saluran baru berisi keanggotaan dan pesan yang berbeda, sehingga pesan yang dikirim oleh `AppInstanceUser` setelah transfer masuk ke anggota yang berbeda. Keseimbangan keanggotaan tidak mempengaruhi keanggotaan moderator.
**catatan**
Saluran elastis tidak mendukung keanggotaan tersembunyi, preferensi keanggotaan, dan stempel waktu baca pesan.
## Fitur tambahan yang didukung
Saluran elastis juga mendukung fitur perpesanan ini.
+ [Prefetch](websockets.md#prefetch)
+ [Aliran saluran](using-channel-flows.md)
# Membuat saluran elastis untuk rapat Amazon Chime SDK
Anda menggunakan `ElasticChannelConfiguration` bidang di [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html)API untuk membuat saluran elastis. Setelah Anda membuat saluran elastis, Anda membuat keanggotaan saluran.
**catatan**
Untuk saluran non-elastis, saluran `AppInstanceUser` yang membuat saluran secara otomatis ditambahkan ke saluran itu sebagai anggota dan moderator. Untuk saluran elastis, pembuat saluran hanya ditambahkan sebagai moderator.
Anda tidak dapat memperbarui set `ElasticChannelConfiguration` sekali.
Anda tidak dapat memperbarui saluran dari elastis ke non-elastis dan sebaliknya.
Anda tidak dapat menyertakan daftar anggota ARNs dalam permintaan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html)API. Namun, Anda dapat memasukkan daftar moderator ARNs.
Anda tidak dapat membuat saluran elastis `UNRESTRICTED` tipe.
# Mengelola anggota saluran elastis untuk rapat Amazon Chime SDK
Untuk mengelola anggota dalam saluran elastis, gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelMembership.html), [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html), dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html) APIs. Informasi berikut menjelaskan cara menggunakannya.
**Keanggotaan saluran**
`CreateChannelMembership`API membuat keanggotaan di tingkat sub-saluran. sub-saluran dapat mencakup moderator dan anggota reguler.
+ **Moderator** — Anda dapat menambahkan moderator ke beberapa sub-saluran. Itu memungkinkan moderator untuk mengirim pesan pada masing-masing sub-saluran yang mereka miliki. Saat Anda menambahkan moderator ke sub-saluran, Anda harus menyediakan. `SubChannelId`
Jika Anda ingin menetapkan moderator ke sub-saluran baru secara otomatis, Anda dapat [mengaktifkan streaming pesan](streaming-export.md), mendengarkan acara pembuatan sub-saluran, dan kemudian membuat keanggotaan moderator sebagai respons terhadap peristiwa tersebut.
Terakhir, Anda dapat menghapus moderator dari sub-saluran tertentu, atau dari semua sub-saluran. Anda menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_DeleteChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_DeleteChannelMembership.html)API dalam kedua kasus. Untuk menghapus moderator dari sub-saluran tertentu, Anda menyediakan. `SubChannelId` Jika Anda tidak memberikan ID untuk sub-saluran, sistem akan menghapus moderator dari semua sub-saluran. Terakhir, Anda dapat menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels)API untuk membuat daftar sub-saluran dan jumlah anggota di masing-masing.
+ **Anggota reguler** — Ini terdiri dari sebagian besar keanggotaan saluran. Anda hanya dapat menambahkan anggota reguler ke satu sub-saluran. Selain itu, Anda tidak dapat meneruskan `SubChannelId` saat membuat atau menghapus keanggotaan saluran, karena sistem mengontrol sub-saluran mana keanggotaan dibuat.
**Moderator saluran**
`CreateChannelModerator`API menciptakan moderator pada tingkat saluran elastis. Moderator dapat melihat semua pesan di semua sub-saluran. Saat Anda mempromosikan anggota reguler ke moderator saluran, sistem akan menghapus semua keanggotaan saluran yang ada untuk anggota tersebut. Hal yang sama terjadi ketika Anda menurunkan moderator.
**Larangan saluran**
`CreateChannelBan`API membuat larangan pada tingkat saluran elastis. Dilarang tidak `AppInstanceUser` dapat dimiliki oleh sub-saluran mana pun. Saat Anda melarang anggota, sistem akan menghapus semua keanggotaan saluran untuk anggota tersebut.
# Mengirim pesan saluran elastis dalam rapat Amazon Chime SDK
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html)API membuat pesan di tingkat sub-saluran. Untuk mengirim pesan, Anda harus memiliki`subChannelId`. Anda juga dapat menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_UpdateChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_UpdateChannelMessage.html), dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_RedactChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_RedactChannelMessage.html) APIs untuk mengedit dan menghapus pesan, tetapi dalam semua kasus, Anda harus memiliki`subChannelId`.
**catatan**
Pengirim pesan hanya dapat mengedit atau menyunting pesan jika mereka termasuk sub-saluran yang mereka kirimi pesan. Jika saldo keanggotaan mentransfer anggota ke sub-saluran lain, anggota tersebut hanya dapat mengedit atau menyunting pesan yang mereka kirim di sub-saluran baru tersebut.
# Memahami pesan WebSocket sistem di saluran elastis untuk rapat Amazon Chime SDK
Amazon Chime SDK mengirimkan pesan sistem ke semua klien yang terhubung untuk peristiwa yang terjadi di saluran. Daftar berikut menjelaskan pesan sistem untuk saluran elastis.
**Acara pesan**
Muatan acara untuk saluran elastis berisi `subChannelId` bidang. Muatan untuk saluran non-elastis tetap sama.
**Acara keanggotaan**
`DELETE_CHANNEL_MEMBERSHIP`Acara `CREATE_CHANNEL_MEMBERSHIP` dan sekarang memiliki `subChannelId` bidang dalam muatan mereka.
Saluran elastis tidak mendukung `BATCH_CREATE_CHANNEL_MEMBERHSIP` acara tersebut. Saat Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_BatchCreateChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_BatchCreateChannelMembership.html)API, sistem mengirimkan `CREATE_CHANNEL_MEMBERSHIP` peristiwa individual.
Anda sekarang dapat menggunakan jenis `UPDATE_CHANNEL_MEMBERSHIP` acara untuk memberi sinyal perubahan dalam informasi keanggotaan. Misalnya, selama transfer anggota dari satu sub-saluran ke sub-saluran lainnya, sistem mengirimkan `UPDATE_CHANNEL_MEMBERSHIP` acara dengan yang baru `SubChannelId` di muatan untuk menunjukkan bahwa anggota telah ditransfer.
Sistem hanya mengirimkan `UPDATE_CHANNEL_MEMBERSHIP` acara ke anggota yang ditransfer, dan bukan ke anggota sub-saluran lainnya. Untuk alasan ini, kami mendorong Anda untuk menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListChannelMemberships.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListChannelMemberships.html)API alih-alih mengisi daftar WebSockets nama keanggotaan saluran Anda. Untuk informasi lebih lanjut, lihat[Menggunakan WebSockets untuk menerima pesan di perpesanan Amazon Chime SDK](websockets.md).
# Menggunakan aliran Kinesis untuk menerima pesan sistem untuk rapat Amazon Chime SDK
Anda dapat mengkonfigurasi `AppInstance` untuk menerima data dalam bentuk aliran. Misalnya, aliran dapat mencakup pesan, peristiwa sub-saluran, dan acara saluran.
Sebagai bagian dari itu, kami mendukung `CREATE_SUB_CHANNEL` dan `DELETE_SUB_CHANNEL` acara. Mereka menunjukkan kapan sub-saluran dibuat atau dihapus sebagai bagian dari keseimbangan keanggotaan. Untuk informasi selengkapnya tentang menerima aliran data, lihat. [Streaming data perpesanan di perpesanan Amazon Chime SDK](streaming-export.md)
# Menguji saluran elastis untuk rapat Amazon Chime SDK di aplikasi demo kami
[Anda dapat menguji semua fitur Amazon Chime SDK Messaging di GitHub /. https://github.com/aws-samples/ amazon-chime-sdk tree/main/apps/chat](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat)