本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 遷移至 Amazon Chime SDK 會議命名空間
[Amazon Chime SDK 會議](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html)命名空間是 APIs 的專用空間，可建立和管理 Amazon Chime SDK 會議資源。您可以使用 命名空間來定址 Amazon Chime SDK 在任何 AWS 可用區域的 API 端點。如果您才剛開始使用 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) 命名空間的現有應用程式應計劃遷移至專用命名空間，以便使用最新的 APIs和功能。
**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 Meetings 命名空間是唯一可在任何[區域中使用 API 端點的 API ](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions.html)命名空間。如果您想要使用 以外的 API 端點`us-east-1`，您必須使用 Amazon Chime SDK Meetings 命名空間。
如需 Amazon Chime SDK 會議如何使用 AWS 區域的詳細資訊，請參閱本指南中的[會議區域](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html)。
**已更新和新的會議 APIs**
我們只會在 Amazon Chime SDK 會議命名空間中新增或更新會議 APIs。
## 遷移之前
遷移之前，請注意命名空間之間的差異。下表列出並加以說明。
| | 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 | 只有會議APIs | Amazon Chime 會議和其他部分的 APIs |
| [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 | 不適用 | Available |
| ExternalMeetingId | 驗證包括模式比對 | Available |
| ExternalUserId | 驗證包括模式比對 | Available |
| 會議標籤 APIs | TagResource, UntagResource, ListTagsForResource | TagMeeting, UntagMeeting, ListMeetingTags |
| 出席者標籤 | 不適用 | Available |
| 回音減少 | Available | 不適用 |
| 即時轉錄語言識別 | Available | 不適用 |
| 出席者功能 | Available | 不適用 |
| 媒體複寫 | Available | 不適用 |
| AppKeys 和 TenantIds | Available | 不適用 |
| 媒體管道 | 媒體管道支援 Amazon Chime SDK 會議命名空間中的多個區域。如需詳細資訊，請參閱[遷移至 Amazon Chime SDK 媒體管道命名空間](migrate-pipelines.md)。 | 透過 us-east-1 端點提供 |
| SIP 媒體應用程式 | JoinChimeMeeting 動作需要 MeetingId | JoinChimeMeeting 動作不需要 MeetingId |
| **Direct SIP 整合** | 不適用 | Available |
## 命名空間之間的差異
下列各節說明 `Amazon Chime`和 `Amazon Chime SDK Meetings`命名空間之間的差異。
### AWS SDK 命名空間
Amazon Chime SDK 命名空間使用`Chime`正式名稱。Amazon Chime SDK Meetings 命名空間使用`ChimeSDKMeetings`正式名稱。名稱的精確格式因平台而異。
例如，如果您使用 Node.js 中的 AWS SDK 來建立會議，您可以使用一行程式碼來定址命名空間。
```
const chimeMeetings = AWS.Chime();
```
若要遷移至 Amazon Chime Meetings 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 Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 命名空間可以解決任何可用區域中符合 API 端點的 Amazon Chime SDK。如需會議區域的目前清單，請參閱本指南[Amazon Chime SDK 的可用 AWS 區域](sdk-available-regions.md)中的 。
### 端點
[Amazon Chime SDK Meetings](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 端點建立的會議。這也表示您無法在 中使用 `Chime` 命名空間來處理透過 `ChimeSDKMeetings` 命名空間建立的會議`US-EAST-1`。如需目前端點的詳細資訊，請參閱本指南[API 映射](migrate-from-chm-namespace.md#name-end-map)中的 。
### 服務主體
[Amazon Chime SDK Meetings](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 Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 命名空間僅包含用於建立和管理會議APIs。[Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime.html) 命名空間包含會議APIs 和 Amazon Chime 服務的其他部分。
### 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) APIs 需要指定 `ExternalMeetingId`和 `MediaRegion` 欄位。
### 外部 ID 值
[Amazon Chime SDK Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 命名空間會對可用於 `ExternalMeetingId`和 的值強制執行額外的驗證`ExternalUserId`。
### 回音減少
[Amazon Chime SDK Meetings](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 Meetings](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 Meetings](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) 命名空間可讓您限制從網路到特定 Amazon Chime SDK 會議的存取。如需詳細資訊，請參閱本指南[針對 Amazon Chime SDK 使用 AppKeys 和 TenantIDs](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 Meetings 命名空間建立的會議使用 SIP 媒體應用程式時， [JoinChimeMeeting](join-chime-meeting.md)動作需要 `MeetingId` 參數。
### 其他 APIs
會議命名空間具有 Chime 命名空間沒有的不斷增長的 APIs 清單。如果您開始使用 Amazon Chime SDK，請使用 會議命名空間來存取最新的功能。