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