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

Menggunakan WebSockets untuk menerima pesan

Anda dapat menggunakan Amazon Chime JS SDK untuk menerima pesan menggunakan WebSockets, atau Anda dapat menggunakan pustaka WebSocket klien pilihan Anda.

Ikuti topik ini dalam urutan yang tercantum untuk mulai menggunakan WebSockets:

Mendefinisikan kebijakan IAM

Untuk memulai, tentukan kebijakan IAM yang memberi Anda izin untuk membuat WebSocket koneksi. Contoh kebijakan berikut memberikan AppInstanceUser izin untuk membuat WebSocket koneksi.

"Version": "2012-10-17",
"Statement": [
  {
    "Effect": "Allow",
    "Action: [
      "chime:Connect"
    ],
    "Resource": [
      "arn:aws:chime:region:{aws_account_id}:app-instance/{app_instance_id}/user/{app_instance_user_id}"
    ]
 },
 {
    "Effect": "Allow",
    "Action: [
      "chime:GetMessagingSessionEndpoint"
    ],
    "Resource": [
      "*"
    ]
 }
 ]
} 

Mengambil titik akhir

Langkah-langkah berikut menjelaskan cara mengambil titik akhir yang digunakan dalam koneksi WebSocket .

Membangun koneksi

Setelah Anda mengambil endpoint, Anda menggunakan connect API untuk membuat WebSocket sambungan ke server back-end Amazon Chime SDK dan menerima pesan untuk file. AppInstanceUser Anda harus menggunakan AWS Signature Version 4 untuk menandatangani permintaan. Untuk informasi selengkapnya tentang menandatangani permintaan, lihat Menandatangani AWS Permintaan dengan Tanda Tangan Versi 4.

Permintaan Sintaks

GET /connect
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIARALLEXAMPLE%2F20201214%2Fregion%2Fchime%2Faws4_request
&X-Amz-Date=20201214T171359Z
&X-Amz-Expires=10
&X-Amz-SignedHeaders=host
&sessionId={sessionId}
&userArn={appInstanceUserArn}
&X-Amz-Signature=db75397d79583EXAMPLE

Parameter Permintaan URI

Semua Parameter Kueri Permintaan URI harus dikodekan URL.

X-Amz-Algoritma

Mengidentifikasi versi AWS Signature dan algoritma yang Anda gunakan untuk menghitung tanda tangan. Amazon Chime SDK hanya mendukung otentikasi AWS Signature Version 4, jadi nilainya adalah. AWS4-HMAC-SHA256

X-Amz-Kredensyal

Selain ID kunci akses Anda, parameter ini juga menyediakan AWS Wilayah dan layanan—cakupan—yang tanda tangannya valid. Nilai ini harus sesuai dengan cakupan yang Anda gunakan dalam perhitungan tanda tangan. Bentuk umum untuk nilai parameter ini adalah:

<yourAccessKeyId>/<date>/<awsRegion>/<awsService >/aws4_request

Sebagai contoh:

AKIAIOSFODNN7EXAMPLE/20201214/us-east-1/chime/aws4_request

X-Amz-Tanggal

Format tanggal dan waktu harus mengikuti standar ISO 8601, dan Anda harus memformatnya sebagai. yyyyMMddTHHmmssZ Misalnya, Anda harus mengonversi 08/01/2020 15:32:41.982-700 ke Coordinated Universal Time (UTC) dan mengirimkannya sebagai. 20200801T083241Z

X-Amz-Signed-Header

Daftar header yang Anda gunakan untuk menghitung tanda tangan. Header berikut diperlukan dalam perhitungan tanda tangan:

Tanda Tangan X-Amz

Memberikan tanda tangan untuk mengautentikasi permintaan Anda. Tanda tangan ini harus cocok dengan tanda tangan yang dihitung Amazon Chime SDK. Jika tidak, Amazon Chime SDK menolak permintaan tersebut. Misalnya, 733255ef022bec3f2a8701cd61d4b371f3f28c9f19EXAMPLEd48d5193d7.

X-Amz-Token Keamanan

Parameter kredensi opsional jika menggunakan kredensil yang bersumber dari Security Token Service. Untuk informasi selengkapnya tentang layanan ini, lihat https://docs.aws.amazon.com/STS/latest/APIReference/.

SessionId

Menunjukkan Id unik untuk WebSocket koneksi yang sedang dibuat.

UserArn

Menunjukkan identitas AppInstanceUser mencoba membuat koneksi. Nilainya harus ARN dari. AppInstanceUser Misalnya, arn:aws:chime:us%2Deast%2D1:123456789012:app%2Dinstance/694d2099%2Dcb1e%2D463e%2D9d64%2D697ff5b8950e/user/johndoe

Menggunakan prefetch untuk menyampaikan detail saluran

Saat Anda membuat WebSocket sambungan, Anda dapat menentukan prefetch-on=connect parameter kueri untuk mengirimkan CHANNEL_DETAILS peristiwa. Fitur prefetch dilengkapi dengan connect API, dan fitur ini memungkinkan pengguna untuk melihat tampilan obrolan yang diperkaya tanpa panggilan API tambahan. Pengguna dapat:

Setelah pengguna terhubung dengan parameter prefetch yang ditentukan, pengguna menerima acara yang dibuat sesi, yang menunjukkan koneksi telah dibuat. Pengguna kemudian menerima hingga 50 CHANNEL_DETAILS acara. Jika pengguna memiliki kurang dari 50 saluran, API connect akan mengambil semua saluran melalui CHANNEL_DETAILS acara. Jika pengguna memiliki lebih dari 50 saluran, API akan mengambil 50 saluran teratas yang berisi pesan yang belum dibaca dan nilai terbaru. LastMessageTimestamp CHANNEL_DETAILSAcara tiba dalam urutan acak, dan Anda menerima acara untuk semua 50 saluran.

Juga, prefetch mengembalikan berikut untuk ChannelMessages dan: ChannelMemberships

Contoh ini menunjukkan cara menggunakanprefetch-on=connect.

GET /connect
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIARALLEXAMPLE%2F20201214%2Fregion%2Fchime%2Faws4_request
&X-Amz-Date=20201214T171359Z
&X-Amz-Expires=10
&X-Amz-SignedHeaders=host
&sessionId=sessionId
&prefetch-on=connect
&userArn=appInstanceUserArn
&X-Amz-Signature=db75397d79583EXAMPLE

Contoh ini menunjukkan respons untuk satu saluran. Anda akan menerima tanggapan untuk semua 50 saluran.

{
   "Headers": { 
        "x-amz-chime-event-type": "CHANNEL_DETAILS", 
        "x-amz-chime-message-type": "SYSTEM" 
        },
   "Payload": JSON.stringify"({
        Channel: ChannelSummary 
        ChannelMessages: List of ChannelMessageSummary  
        ChannelMemberships: List of ChannelMembershipSummary
        ReadMarkerTimestamp: Timestamp 
        ChannelMessagesHasMore: Boolean 
    })
} 

Memproses acara

AppInstanceUserUntuk menerima pesan setelah mereka membuat koneksi, Anda harus menambahkannya ke saluran. Untuk melakukan itu, gunakan CreateChannelMembershipAPI.

Sebuah AppInstanceAdmin dan a ChannelModerator tidak menerima pesan di saluran kecuali Anda menggunakan CreateChannelMembershipAPI untuk menambahkannya secara eksplisit.

Topik berikut menjelaskan cara memproses peristiwa.

Memahami struktur pesan

Setiap WebSocket pesan yang Anda terima mematuhi format ini:

{
   "Headers": {"key": "value"},
   "Payload": "{\"key\": \"value\"}"
}

Header

Pesan Amazon Chime SDK menggunakan tombol header berikut:

Bagian selanjutnya mencantumkan dan menjelaskan kemungkinan nilai dan muatan header.

Muatan

Pesan Websocket mengembalikan string JSON. Struktur string JSON tergantung pada header. x-amz-event-type Tabel berikut mencantumkan kemungkinan x-amz-chime-event-type nilai dan muatan:

x-amz-chime-pesan-tipe

Tabel berikut mencantumkan jenis x-amz-chime-message-type pesan.

x-amz-chime-acara-alasan-

Ini adalah header opsional yang didukung untuk kasus penggunaan tertentu. Header memberikan informasi tentang mengapa acara tertentu diterima.

Penanganan terputus

Websockets dapat terputus karena perubahan konektivitas jaringan, atau ketika kredensil kedaluwarsa. Setelah Anda membuka WebSocket, Amazon Chime SDK mengirimkan ping reguler ke klien perpesanan untuk memastikannya masih terhubung. Jika koneksi ditutup, klien menerima kode WebSocket tutup. Klien dapat mencoba menyambung kembali, atau tidak, tergantung pada kode tutup. Tabel berikut menunjukkan kode tutup yang dapat digunakan klien untuk menyambung kembali.

Untuk 1000 hingga 4000 kode penutupan, sambungkan kembali hanya untuk pesan berikut:

Untuk kode 4XXX, selalu sambungkan kembali kecuali untuk pesan berikut:

Ketika aplikasi menggunakan kode tutup untuk menyambung kembali, aplikasi harus:

Jika Anda menggunakan amazon-chime-sdk-js pustaka, ini akan ditangani untuk Anda jika Anda menerapkan properti needsRefresh () dan metode refresh (). Untuk contoh kerja, lihat https://github.com/aws-samples/amazon-chime-sdk/blob/dc11c4c76c78d28f618577706bba2087919a5635/apps/chat/src/providers/ AuthProvider .jsx #L93 -L101.