訊息概念 - Amazon Chime SDK

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

訊息概念

若要有效使用 Amazon Chime 開發套件簡訊,您必須瞭解下列術語和概念。

AppInstance

若要使用 Amazon Chime 開發套件簡訊,您必須先建立 AppInstance. 一個 AppInstance 包含 AppInstanceUsers 和通道。通常,您 AppInstance 為應用程序創建一個單一的。一個 AWS 帳戶可以有多個 AppInstances。您可以在層級進行應用程式層級設定,例如訊息保留和串流設定 AppInstance 。 AppInstances 由以下格式的唯一 ARN 識別:arn:aws:chime:region:aws_account_id:app-instance/app_instance_id

AppInstanceUser

AppInstanceUsers 是傳送訊息、建立頻道、加入頻道等的實體。通常,您會建立應用程式AppInstanceUser使用者的 one-to-one 對應。您也可以建立連線AppInstanceUser至後端服務,讓使用者將訊息識別為來自後端服務的訊息。 AppInstanceUsers由 ARN 識別,例如arn:aws:chime:region:aws_account_id:app-instance/app_instance_id/user/app_instance_user_id。您可以控制app_instance_user_id,最佳作法是重複使用應用程式已有的 ID。

頻道

當您新增頻道AppInstanceUser時,該使用者會成為會員,並且可以傳送和接收訊息。頻道可以是公開的,允許任何使用者將自己新增為成員,也可以是私人頻道,只允許頻道管理員新增成員。您也可以隱藏頻道成員。隱藏的會員可以觀察對話,但無法傳送訊息,也不會加入頻道會員資格中。

SubChannel

彈性通道的成員被劃分為一個名為邏輯容器 SubChannels。當您將彈性通道添加 AppInstanceUser 到彈性通道時,用戶將成為該通道的成員, SubChannel 並且可以發送和接收該特定信道的消息 SubChannel。頻道會員資格和訊息都處於某個 SubChannel 層級,這表示其中一位會員傳送的訊息不 SubChannel 會被另 SubChannel一位會員收到。會員被轉移 SubChannels 到不同的地方,以支持渠道的彈性性並促進參與度。

UserMessage

屬於頻道的AppInstanceUser誰可以傳送和接收使用者訊息。AppInstanceUser可以發送STANDARDCONTROL消息。 STANDARD訊息可以包含 4KB 的資料和 1KB 的中繼資料。 CONTROL訊息只能包含 30 個位元組的資料。訊息可以是PERSISTENTNON_PERSISTENT。您可以從頻道歷史記錄中檢索PERSISTENT消息。 NON_PERSISTENT只有目前連線到 Amazon Chime 開發套件簡訊的通道成員才能看到訊息。

系統訊息

Amazon Chime SDK 會產生系統訊息,以回應會員加入或離開通道等事件。