本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
訊息概念
若要有效使用 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
可以發送STANDARD
或CONTROL
消息。 STANDARD
訊息可以包含 4KB 的資料和 1KB 的中繼資料。 CONTROL
訊息只能包含 30 個位元組的資料。訊息可以是PERSISTENT
或NON_PERSISTENT
。您可以從頻道歷史記錄中檢索PERSISTENT
消息。 NON_PERSISTENT
只有目前連線到 Amazon Chime 開發套件簡訊的通道成員才能看到訊息。
系統訊息
Amazon Chime SDK 會產生系統訊息,以回應會員加入或離開通道等事件。