本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
遷移至 Amazon Chime 語音開發套件語音命名空間
Amazon Chime SDK 語音命名空間是建立和管理 Amazon Chime SDK 語音資源的 API 專用位置。您可以使用命名空間來處理任何提供這些端點的 AWS 區域中的 Amazon Chime SDK 語音 API 端點。如果您剛開始使用 Amazon Chime 開發套件,請使用此命名空間。如需有關「區域」的詳細資訊,請參閱本指南可用的區域中的。
使用 Amazon Chime 命名空間的現有應用程式應計劃遷移到專用命名空間,以便使用更新的 API 和新功能。
遷移的原因
我們建議您移轉至 Amazon Chime SDK 語音命名空間,原因如下:
- API 端點的選擇
Amazon Chime SDK 語音命名空間可讓您在任何可用的區域中使用 API 端點。如果您想要使用以外的 API 端點
us-east-1
,則必須使用 Amazon Chime SDK 語音命名空間。如需有關目前端點的詳細資訊,請參閱本指南API 映射中的〈〉。- 更新和新的語音 API
我們只會在 Amazon Chime SDK 語音命名空間中新增或更新語音 API。
移轉之前
移轉之前,請注意命名空間之間的差異。下表列出並說明它們。
Amazon Chime 聲 SDK 語音命名空間 |
Amazon Chime 聲命名空間 |
|
---|---|---|
AWS 命名空間 |
|
|
區域 |
多個 |
僅限 |
端點 |
|
|
服務主體 |
|
|
API |
僅適用於 PSTN 音訊服務的 API | 適用於 PSTN 音訊和 Amazon Chime 聲其他部分的 API |
語音連接器管理 | 多個地區 | us-east-1 |
語音連接器群組管理 | 多個地區 | us-east-1 |
SIP 媒體應用程式與 SIP 規則管理 | 多個地區 | us-east-1 |
電話號碼管理 | 多個地區 | us-east-1 |
通話分析 | 可用性 | 無 |
語音設定檔網域 | 可用性 | 無 |
緊急呼叫管理 | 多個地區 | us-east-1 |
代理電話會話管理 | 多個地區 | us-east-1 |
串流管理 | 多個地區 | us-east-1 |
記錄和指標管理 | 多個地區 | us-east-1 |
如需有關可用區域的詳細資訊,請參閱本指南PSTN 地區前面的說明。
命名空間之間的差異
以下各節說明Amazon Chime SDK Voice
和Amazon Chime
命名空間之間的差異。
AWS 名稱區
Amazon Chime SDK 命名空間使用Chime
正式名稱。Amazon Chime 聲 SDK 語音命名空間使用ChimeSDKVoice
正式名稱。名稱的精確格式因平台而異。
例如,如果您使用 Node.js 中的 AWS SDK 建立會議,您可以使用下列程式碼行來定址命名空間。
const chimeVoice = AWS.Chime();
若要移轉至 Amazon Chime SDK 語音命名空間,請使用新的命名空間和端點區域更新此行程式碼。
const chimeVoice = AWS.ChimeSDKVoice({ region: "
eu-central-1
" });
區域
Amazon Chime 命名空間只能處理us-east-1
區域中的 API 端點。Amazon Chime SDK 語音命名空間可以處理任何可用區域中的 Amazon Chime SDK 語音 API 端點。如需語音區域的目前清單,請參閱本指南可用的區域中的。
端點
Amazon Chime SDK 語音命名空間使用的 API 端點與 Amazon Chime 命名空間不同。
只有用來建立語音動作的端點可以用來修改它。這表示透過中的端點建立的語音動作只eu-central-1
能透過修改eu-central-1
。這也意味著您無法解決通過Chime
命名空間中命名空間創建的語音操作us-east-1
。ChimeSDKVoice
如需有關目前端點的詳細資訊,請參閱本指南API 映射中的〈〉。
服務主體
這兩個命名空間都使用chime.amazonaws.com
服務主體。如果您擁有授與服務存取權的存取原則,則不需要更新這些原則。
API
Amazon Chime SDK 語音命名空間僅包含用於建立和管理語音動作的 API。Amazon Chime 命名空間包含語音和 Amazon Chime 服務的其他部分 (例如會議) 的 API。
標記
只有 Amazon Chime SDK 語音命名空間支援標籤。如需有關標籤的詳細資訊,請參閱TagResource和UntagResource。
媒體區域
如果您使用Chime
命名空間來建立語音連接器和 SIP 媒體應用程式等資源,則只能在us-east-1
和中執行us-west-2
,而且必須使用us-east-1
端點。
相反地,ChimeSDKVoice
命名空間允許在所有支援的區域中建立資源,而不只是us-east-1
和us-west-2
. 如需區域涵蓋範圍的詳細資訊,請參閱可用的區域。