本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
迁移到 Amazon Chime SDK 消息传递命名空间
Amazon Chime SDK 消息传递命名空间是 API 的专用位置，用于创建和管理 Amazon Chime SDK 消息传递资源。您可以使用命名空间来寻址 Amazon Chime 软件开发工具包消息 API 终端节点所在的任何 AWS 区域。如果您刚开始使用 Amazon Chime SDK，则使用此命名空间。有关“区域”的更多信息，请参阅本指南中的 可用区。
使用 Amazon Chime 命名空间的现有应用程序应计划迁移到专用命名空间。
迁移原因
出于以下原因，我们鼓励您迁移到 Amazon Chime SDK 消息传递命名空间：
- 选择 API 终端节点
Amazon Chime SDK 消息传送命名空间是唯一一个可以在任何提供 API 终端节点的区域中使用 API 终端节点的 API 命名空间。如果您想使用美国东部（弗吉尼亚北部）以外的 API 终端节点，则必须使用 Amazon Chime SDK 消息传递命名空间。
有关 Amazon Chime SDK 消息传递如何使用 AWS 区域的更多信息，请参阅本指南中的可用区域。
- 更新和新的消息传递 API
我们仅在 Amazon Chime SDK 消息传递命名空间中添加或更新消息传递 API。
迁移之前
在迁移之前，记下命名空间之间的差异。下表列出并描述了以上差异。
| Amazon Chime SDK 消息传递命名空间 | Amazon Chime 命名空间 | |
|---|---|---|
| AWS SDK 名称空间 | ChimeSDKMessaging | Chime |
| 区域 | 多个 | 仅限美国东部（弗吉尼亚州北部） |
| API | 仅用于消息传递的 API | 用于消息传递和 Amazon Chime 其他部分的 API |
| 流 | 可用 | 不可用 |
| 弹性频道 | 可用 | 不可用 |
命名空间之间的差异
以下各节解释了 Amazon Chime 与 Amazon Chime SDK Messaging 命名空间之间的差异。
AWS SDK 名称空间
Amazon Chime SDK 命名空间使用 Chime 正式名称。Amazon Chime SDK 消息传递命名空间使用 ChimeSDKMessaging 正式名称。名称的确切格式因平台而异。
例如，如果您在 Node.js 中使用 AWS SDK 来创建消息，则使用一行代码来寻址命名空间。
const chimeMessaging = AWS.Chime();
要迁移到 Amazon Chime Messaging SDK，请使用新的命名空间和终端节点区域更新这行代码。
const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });
区域
Amazon Chime 命名空间只能寻址该 US East (N. Virginia) 地区的 API 终端节点。Amazon Chime SDK 消息传递命名空间可以在任何可用区域中寻址 Amazon Chime SDK 消息传递 API 终端节点。有关最新的消息传递区域列表，请参阅本指南中的 可用区。
端点
Amazon Chime SDK 消息传递命名空间使用与 Amazon Chime 命名空间不同的 API 终端节点。
只能使用用于创建消息传递资源的终端节点对其进行修改。这意味着通过 Europe (Frankfurt) 中的终端节点创建的消息传递资源只能通过 Europe (Frankfurt) 进行修改。这意味着通过欧洲（法兰克福）的终端节点创建的频道只能通过欧洲（法兰克福）进行修改。这也意味着您无法寻址通过命名空间创建的频道，其Chime命名ChimeSDKMessaging空间位于美国东部（弗吉尼亚北部）。有关当前终端节点的更多信息，请参阅本指南中的 API 映射。
服务主体
Amazon Chime SDK 消息传递命名空间使用了新的服务主体：messaging.chime.amazonaws.com。如果您有授予服务访问权限的 SQS、SNS 或其他 IAM 访问策略，则需要更新这些策略以授予新服务主体访问权限。
API
Amazon Chime SDK 消息传递命名空间仅包含用于创建和管理消息传递资源以及发送和接收消息的 API。Amazon Chime 命名空间包括用于 Amazon Chime 服务其他部分的 API 以及消息传递。
频道流
频道流允许开发人员在将动态消息传递给消息传递频道成员之前，对这些消息运行业务逻辑。例如，您可以创建流程，在发送消息之前从消息中删除敏感数据，例如身份证号、电话号码或污言秽语。这可以帮助实施企业传播策略或其他沟通准则。
您还可以使用频道流来执行一些功能，例如在将结果发送回给参与者之前汇总对民意调查的回复，或者通过短信发送消息。
频道流仅在 ChimeSDKMessaging 命名空间中可用。有关更多信息，请参阅本指南中的 使用频道流处理消息。
弹性频道
弹性频道支持大规模的聊天体验，多达 100 万聊天用户可在指定数量的子频道中自动平衡。弹性频道仅在 ChimeSDKMessaging 终端节点中可用。有关弹性频道的更多信息，请参阅本指南中的 使用弹性频道举办实时事件。
其它 API
消息传递命名空间中 Chime 命名空间所没有的 API 在不断增加。如果您刚开始使用 Amazon Chime SDK，请使用消息传递命名空间来访问所有最新功能。有关当前 API 的更多信息，请参阅《Amazon Chime SDK API 参考》中的 Amazon Chime SDK 消息传递。
