了解 Amazon Chime SDK 消息传递的概念

要有效地使用 Amazon Chime SDK 消息传递，您必须了解以下术语和概念。

AppInstance

要使用 Amazon Chime SDK 消息传递，必须先创建一个 AppInstance。AppInstance 包含 AppInstanceUser 和频道。通常，您可以为应用程序创建单个 AppInstance。一个 AWS 账户可以有多个 AppInstance。您可以在 AppInstance 级别进行应用程序级别的设置，例如消息保留和流配置。AppInstance 由以下格式的唯一 ARN 标识：arn:aws:chime:region:aws_account_id:app-instance/app_instance_id。

AppInstanceUser

AppInstanceUser 是发送消息、创建频道、加入频道等的实体。通常，您可以创建与应用程序用户的 AppInstanceUser 一对一映射。您还可以创建 AppInstanceUser 连接到后端服务，这样用户就可以将消息识别为来自后端服务。AppInstanceUser 由 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

弹性频道的成员被分成一个名为 SubChannel 的逻辑容器。当您将 AppInstanceUser 添加到弹性频道时，该用户将成为 SubChannel 的成员，并且可以发送和接收该特定 SubChannel 的消息。频道成员资格和消息属于 SubChannel 级别，这意味着成员在一个 SubChannel 中发送的消息不会被另一个 SubChannel 中的成员接收。成员会被转移到不同的 SubChannel，以支持频道的弹性并促进参与度。

UserMessage

属于频道的 AppInstanceUser 可以发送和接收用户消息。AppInstanceUser 可以发送 STANDARD 或 CONTROL 消息。STANDARD 消息可以包含 4KB 的数据和 1KB 的元数据。CONTROL 消息只能包含 30 字节的数据。消息可以是 PERSISTENT 或 NON_PERSISTENT。您可以从频道历史记录中检索 PERSISTENT 消息。NON_PERSISTENT 只有当前连接到 Amazon Chime SDK 消息的频道成员才能看到消息。

系统消息

Amazon Chime SDK 会生成系统消息，以响应诸如成员加入或离开频道之类的事件。