迁移到 Amazon Chime SDK 会议命名空间
Amazon Chime SDK 会议命名空间是 API 的专用位置，用于创建和管理 Amazon Chime SDK 会议资源。您可以使用命名空间在 Amazon Chime SDK 会议 API 终端节点所在的任何 AWS 区域对其进行寻址。如果您刚开始使用 Amazon Chime SDK，则使用此命名空间。有关“区域”的更多信息，请参阅本指南中的 Amazon Chime SDK 可用的 AWS 区域。
使用 Amazon Chime 命名空间的现有应用程序应计划迁移到专用命名空间，以使用最新 API 和功能。
迁移原因
出于以下原因，我们鼓励您迁移到 Amazon Chime SDK 会议命名空间：
- 选择 API 终端节点
-
Amazon Chime SDK 会议命名空间是唯一可以在任何提供 API 终端节点的区域中使用 API 终端节点的 API 命名空间。如果您想使用
us-east-1以外的 API 终端节点，则必须使用 Amazon Chime SDK 会议命名空间。有关 Amazon Chime SDK 会议如何使用 AWS 区域的更多信息，请参阅本指南中的会议区域。
- 更新和新的会议 API
-
我们仅在 Amazon Chime SDK 会议命名空间中添加或更新会议 API。
迁移之前
在迁移之前，记下命名空间之间的差异。下表列出并描述了以上差异。
| Amazon Chime SDK 会议命名空间 | Amazon Chime 命名空间 | |
|---|---|---|
| AWS SDK 命名空间 | ChimeSDKMeetings | Chime |
| 区域 | 多个 | 仅限 us-east-1 |
| 端点 | https://meetings-chime.region.amazonaws.com | https://service.chime.aws.amazon.com |
| 服务主体 | meetings.chime.amazonaws.com | chime.amazonaws.com |
| API | 仅用于会议的 API | 用于会议和 Amazon Chime 其他部分的 API |
| CreateMeeting | ExternalMeetingId 和 MediaRegion 为必填。 |
ExternalMeetingId 和 MediaRegion 是可选的。 |
| CreateMeetingWithAttendees | ExternalMeetingId 和 MediaRegion 为必填。 |
ExternalMeetingId 和 MediaRegion 是可选的。 |
ListMeetings |
不可用 | 可用 |
ExternalMeetingId |
验证包括模式匹配 | 可用 |
ExternalUserId |
验证包括模式匹配 | 可用 |
| 会议标签 API | TagResource, UntagResource,
ListTagsForResource |
TagMeeting, UntagMeeting,
ListMeetingTags |
| 与会者标签 | 不可用 | 可用 |
| 回声抑制 | 可用 | 不可用 |
| 实时转录语言识别 | 可用 | 不可用 |
| 与会者能力 | 可用 | 不可用 |
| 媒体复制 | 可用 | 不可用 |
| AppKeys 和 TenantIds | 可用 | 不可用 |
| 媒体管道 | 媒体管道支持 Amazon Chime SDK 会议命名空间中的多个区域。有关更多信息，请参阅 迁移到 Amazon Chime SDK 媒体管道命名空间。 | 通过 us-east-1 终端节点可用 |
| SIP 媒体应用程序 | JoinChimeMeeting 操作需要 MeetingId |
JoinChimeMeeting 操作不需要 MeetingId |
|
直接 SIP 集成 |
不可用 | 可用 |
命名空间之间的差异
以下各节解释了 Amazon Chime 与 Amazon Chime SDK Meetings 命名空间之间的差异。
Amazon Chime SDK 命名空间使用 Chime 正式名称。Amazon Chime SDK 会议命名空间使用 ChimeSDKMeetings 正式名称。名称的确切格式因平台而异。
例如，如果您在 Node.js 中使用 AWS SDK 来创建会议，则使用一行代码来寻址命名空间。
const chimeMeetings = AWS.Chime();
要迁移到 Amazon Chime 会议 SDK，使用新的命名空间和终端节点区域更新这行代码。
const chimeMeetings = AWS.ChimeSDKMeetings({ region: "eu-central-1" });
Amazon Chime 命名空间只能寻址 us-east-1 区域的 API 终端节点。Amazon Chime SDK 会议命名空间可以在任何可用区域寻址 Amazon Chime SDK 会议 API 终端节点。有关会议区域的最新列表，请参阅本指南中的 Amazon Chime SDK 可用的 AWS 区域。
Amazon Chime SDK 会议命名空间使用不同于 Amazon Chime 命名空间的 API 终端节点。
只能使用用于创建会议的终端节点对其进行修改。这意味着通过 EU-CENTRAL-1 中的终端节点创建的会议只能通过 EU-CENTRAL-1 进行修改。这也意味着您无法使用 US-EAST-1 中的 ChimeSDKMeetings 命名空间寻址通过 Chime 命名空间创建的会议。有关当前终端节点的更多信息，请参阅本指南中的 API 映射。
Amazon Chime SDK 会议命名空间使用新的服务主体：meetings.chime.amazonaws.com。如果您有授予服务访问权限的 SQS、SNS 或其他 IAM 访问策略，则需要更新这些策略以授予新服务主体访问权限。
Amazon Chime SDK 会议命名空间仅包含用于创建和管理会议的 API。Amazon Chime 命名空间包括用于会议和 Amazon Chime 服务其他部分的 API。
在 Amazon Chime SDK 会议命名空间中，CreateMeeting 和 CreateMeetingWithAttendees API 需要指定 ExternalMeetingId 和 MediaRegion 字段。
Amazon Chime SDK 会议命名空间强制对可用于 ExternalMeetingId 和 ExternalUserId 的值进行额外验证。
Amazon Chime SDK 会议命名空间提供基于机器学习的回声抑制功能，以帮助防止噪音和来自本地扬声器的声音重新传入会议。有关更多信息，请参阅 GitHub 上的指南。
Amazon Chime SDK 会议命名空间提供对会议中与会者发送和接收音频、视频和内容等功能的精细控制。
Amazon Chime SDK 会议命名空间提供媒体复制，可将主会议链接到副本会议，使多达 10,000 人参与实时会话。连接到副本会话的参与者会接收连接至主会话的主讲人的媒体，但他们可以被升级到主会议。有关更多信息，请参阅本指南中的 在 Amazon Chime SDK 会议中使用媒体复制。
Amazon Chime SDK 会议命名空间提供了一种限制网络对特定 Amazon Chime SDK 会议访问的方法。有关更多信息，请参阅本指南中的 针对 Amazon Chime SDK 使用 AppKey 和 TenantID。
Amazon Chime SDK 媒体管道可与任何会议终端节点创建的会议配合使用，无论是使用 Amazon Chime SDK 会议，还是使用 Amazon Chime 命名空间。有关媒体管道区域的最新列表，请参阅可用区域。
Amazon Chime SDK SIP 媒体应用程序可与任何会议终端节点创建的会议配合使用，无论是使用 Amazon Chime SDK 会议，还是使用 Amazon Chime 命名空间。在通过 Amazon Chime SDK 会议命名空间创建的会议中使用 SIP 媒体应用程序时，JoinChimeMeeting 操作需要 MeetingId 参数。
会议命名空间的 API 列表越来越多，而 Chime 命名空间没有这些 API。如果您刚开始使用 Amazon Chime SDK，请使用会议命名空间访问最新功能。
