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

Memahami konsep pesan

Untuk menggunakan SDK pesan Amazon Chime secara efektif, Anda harus memahami istilah dan konsep berikut.

AppInstance

Untuk menggunakan SDK pesan Amazon Chime, Anda harus terlebih dahulu membuat file. AppInstance Sebuah AppInstance berisi AppInstanceUsers dan Saluran. Biasanya, Anda membuat satu AppInstance untuk aplikasi Anda. Sebuah AWS akun dapat memiliki banyak AppInstances. Anda membuat pengaturan level aplikasi, seperti penyimpanan pesan dan konfigurasi streaming, di AppInstance level tersebut. AppInstances diidentifikasi oleh unik ARN dalam format ini:arn:aws:chime:region:aws_account_id:app-instance/app_instance_id.

AppInstanceUser

AppInstanceUsers adalah entitas yang mengirim pesan, membuat saluran, bergabung dengan saluran, dan sebagainya. Biasanya, Anda membuat one-to-one pemetaan AppInstanceUser ke pengguna aplikasi Anda. Anda juga dapat membuat layanan AppInstanceUser untuk terhubung ke back-end, yang memungkinkan pengguna mengidentifikasi pesan yang berasal dari layanan back-end. AppInstanceUsersdiidentifikasi olehARN, sepertiarn:aws:chime:region:aws_account_id:app-instance/app_instance_id/user/app_instance_user_id. Anda mengontrolapp_instance_user_id, dan sebagai praktik terbaik, gunakan kembali IDs yang sudah dimiliki aplikasi Anda.

Channel

Ketika Anda menambahkan AppInstanceUser ke saluran, pengguna tersebut menjadi anggota dan dapat mengirim dan menerima pesan. Saluran dapat bersifat publik, yang memungkinkan setiap pengguna untuk menambahkan diri mereka sebagai anggota, atau pribadi, yang memungkinkan hanya moderator saluran untuk menambahkan anggota. Anda juga dapat menyembunyikan anggota saluran. Anggota tersembunyi dapat mengamati percakapan tetapi tidak mengirim pesan, dan mereka tidak ditambahkan ke keanggotaan saluran.

SubChannel

Anggota saluran elastis dibagi menjadi wadah logis yang disebut SubChannels. Ketika Anda menambahkan AppInstanceUser ke saluran elastis, pengguna menjadi anggota SubChannel dan dapat mengirim dan menerima pesan untuk itu SubChannel. Keanggotaan saluran dan pesan berada pada SubChannel tingkat yang berarti bahwa pesan yang dikirim oleh anggota di salah satu tidak SubChannel akan diterima oleh anggota di yang lain SubChannel. Anggota dipindahkan ke yang berbeda SubChannels untuk mendukung sifat elastis saluran dan mempromosikan keterlibatan.

UserMessage

Seseorang AppInstanceUser yang termasuk dalam saluran dapat mengirim dan menerima pesan pengguna. AppInstanceUserDapat mengirim STANDARD atau CONTROL pesan. STANDARDpesan dapat berisi 4KB data dan 1KB metadata. CONTROLpesan hanya dapat berisi 30 byte data. Pesan bisa PERSISTENT atauNON_PERSISTENT. Anda dapat mengambil PERSISTENT pesan dari riwayat saluran. NON_PERSISTENTpesan hanya dilihat oleh anggota saluran yang saat ini terhubung ke pesan Amazon ChimeSDK.

Pesan Sistem

Amazon Chime SDK menghasilkan pesan sistem sebagai respons terhadap peristiwa seperti anggota yang bergabung atau meninggalkan saluran.