迁移到 Amazon Chime SDK 会议命名空间 - Amazon Chime SDK
迁移原因迁移之前命名空间之间的差异

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

迁移到 Amazon Chime SDK 会议命名空间

Amazon Chime SDK 会议命名空间是 API 的专用位置，用于创建和管理 Amazon Chime SDK 会议资源。您可以使用命名空间在 Amazon Chime SDK 会议 API 终端节点所在的任何 AWS 区域对其进行寻址。如果您刚开始使用 Amazon Chime SDK，则使用此命名空间。有关“区域”的更多信息，请参阅本指南中的 可用区。

使用 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 会议命名空间中的多个区域。有关更多信息，请参阅 迁移到 ChimeSdkMediaPipelines 命名空间。 通过 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 会议命名空间使用不同于 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 Meetings 命名空间中，CreateMeeting和 CreateMeetingWithAttendeesAPI 需要MediaRegion指定ExternalMeetingId和字段。

Amazon Chime SDK 会议命名空间强制对可用于 ExternalMeetingId 和 ExternalUserId 的值进行额外验证。

Amazon Chime SDK 会议命名空间提供基于机器学习的回声抑制功能，以帮助防止噪音和来自本地扬声器的声音重新传入会议。有关更多信息， GitHub 请参阅上的指南。

Amazon Chime SDK 会议命名空间提供对会议中与会者发送和接收音频、视频和内容等功能的精细控制。

Amazon Chime SDK 会议命名空间提供媒体复制，可将主会议链接到副本会议，使多达 10,000 人参与实时会话。连接到副本会话的参与者会接收连接至主会话的主讲人的媒体，但他们可以被升级到主会议。有关更多信息，请参阅本指南中的 使用媒体复制。

Amazon Chime SDK 会议命名空间提供了一种限制网络对特定 Amazon Chime SDK 会议访问的方法。有关更多信息，请参阅本指南中的 使用 AppKeys 和租户 ID。

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，请使用会议命名空间访问最新功能。