遷移至亞馬遜編鐘 SDK 會議命名空間 - Amazon Chime SDK

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

遷移至亞馬遜編鐘 SDK 會議命名空間

Amazon Chime SDK 會議命名空間是建立和管理 Amazon Chime 開發套件會議資源的 API 專用位置。您可以使用命名空間來解決 Amazon Chime SDK 在任何可用 AWS 區域中會議 API 端點的問題。如果您剛開始使用 Amazon Chime 開發套件,請使用此命名空間。如需有關「區域」的詳細資訊,請參閱本指南可用的區域中的。

使用 Amazon Chime 命名空間的現有應用程式應計劃遷移到專用命名空間,以便使用最新的 API 和功能。

遷移的原因

基於下列原因,我們建議您移轉至 Amazon Chime SDK 會議命名空間:

API 端點的選擇

Amazon Chime SDK 會議命名空間是唯一可以在任何提供 API 端點的區域中使用 API 端點的 API 命名空間。如果您想要使用以外的 API 端點us-east-1,則必須使用 Amazon Chime SDK 會議命名空間。

如需 Amazon Chime SDK 會議如何使用 AWS 區域的詳細資訊,請參閱本指南中的會議區域

更新和新的會議 API

我們只會在 Amazon Chime SDK 會議命名空間中新增或更新會議 API。

移轉之前

移轉之前,請注意命名空間之間的差異。下表列出並說明它們。

Amazon Chime 聲 SDK 會議命名空間 Amazon Chime 聲命名空間
AWS SDK 命名空間 嵌合會議 鐘聲
區域 多個 僅限 us-east-1
端點 https://meetings-chime. 地區. 亞馬遜 https://service.chime.aws.amazon.com
服務主體 會議. 奇米. 亞馬遜 奇米亚马逊
API 僅適用於會議的 API 用於會議和 Amazon Chime 聲其他部分的 API
CreateMeeting ExternalMeetingId並且MediaRegion是必需的。 ExternalMeetingIdMediaRegion 為選用。
CreateMeetingWithAttendees ExternalMeetingId並且MediaRegion是必需的。 ExternalMeetingIdMediaRegion 為選用。
ListMeetings 可用性
ExternalMeetingId 驗證包括模式匹配 可用性
ExternalUserId 驗證包括模式匹配 可用性
會議標記 API TagResource, UntagResource, ListTagsForResource TagMeeting, UntagMeeting, ListMeetingTags
出席者標籤 可用性
回音減少 可用性
即時轉錄語言識別 可用性
出席者功能 可用性
媒體複製 可用性
AppKeys 和 TenantIds 可用性
媒體管道 媒體管道支援 Amazon Chime SDK 會議命名空間中的多個區域。如需詳細資訊,請參閱 遷移到ChimeSdkMediaPipelines命名空間 可透過 us-east-1 端點取得
媒體應用程式 JoinChimeMeeting動作需要 MeetingId JoinChimeMeeting動作不需要 MeetingId

直接 SIP 整合

可用性

命名空間之間的差異

以下各節說明Amazon ChimeAmazon Chime SDK Meetings命名空間之間的差異。

Amazon Chime SDK 命名空間使用Chime正式名稱。Amazon Chime SDK 會議命名空間使用ChimeSDKMeetings正式名稱。名稱的精確格式因平台而異。

例如,如果您使用 Node.js 中的 AWS SDK 建立會議,您可以使用一行程式碼來定址命名空間。

const chimeMeetings = AWS.Chime();

若要移轉至 Amazon Chime 會議開發套件,請使用新的命名空間和端點區域更新此行程式碼。

const chimeMeetings = AWS.ChimeSDKMeetings({ region: "eu-central-1" });

Amazon Chime 命名空間只能處理 us-east-1 區域中的 API 端點。Amazon Chime 開發套件會議命名空間可以解決 Amazon Chime SDK 在任何可用區域中會議 API 端點的問題。如需目前的會議區域清單,請參閱本指南可用的區域中的〈〉。

Amazon Chime SDK 會議命名空間使用的 API 端點與 Amazon Chime 命名空間不同。

只有用於建立會議的端點可以用來修改會議。這表示透過 EU-CENTRAL-1 中的端點建立的會議只能透過 EU-CENTRAL-1 修改。這也意味著您無法解決透過命名空間建立的會議,其中包含ChimeChimeSDKMeetings命名空間US-EAST-1。如需有關目前端點的詳細資訊,請參閱本指南API 映射中的〈〉。

Amazon Chime SDK 會議命名空間使用新的服務主體:meetings.chime.amazonaws.com。如果您有 SQS、SNS 或其他 IAM 存取政策授予服務存取權,則需要更新這些政策以授與新服務主體的存取權。

Amazon Chime SDK 會議命名空間只包含用於建立和管理會議的 API。Amazon Chime 命名空間包括用於會議和 Amazon Chime 服務其他部分的 API。

在 Amazon Chime 開發套件會議命名空間中,CreateMeetingCreateMeetingWithAttendeesAPI 需要指定ExternalMeetingIdMediaRegion欄位。

Amazon Chime SDK 會議命名空間會ExternalMeetingId可用於和的值強制執行附加驗證。ExternalUserId

Amazon Chime SDK Meetings 命名空間提供以機器學習為基礎的回音減少功能,有助於消除本機揚聲器中的噪音和聲音,避免循環回會議。如需詳細資訊,請參 GitHub 閱上的指南。

Amazon Chime SDK 會議命名空間提供對會議內出席者功能的精細控制,以傳送和接收音訊、視訊和內容。

Amazon Chime SDK 會議命名空間提供媒體複寫功能,可將主要會議連結至複本會議,讓最多 10,000 人聚集在一起進行即時工作階段。連線到複本工作階段的參與者會收到連線至主要工作階段的簡報者媒體,但他們可以晉升為主要會議。如需詳細資訊,請參閱本指南使用媒體複製中的。

Amazon Chime SDK 會議命名空間提供了一種方法,可將網路存取限制為特定 Amazon Chime 開發套件會議的存取。如需詳細資訊,請參閱本指南使用 AppKeys 和使用中的。

Amazon Chime SDK 媒體管道可與任何會議端點建立的會議搭配使用 Amazon Chime 開發套件會議或 Amazon Chime 命名空間。如需最新的媒體管線區域清單,請參閱可用區域。

Amazon Chime SDK SIP 媒體應用程式可與任何會議端點建立的會議搭配使用 Amazon Chime 開發套件會議Amazon Chi me 命名空間。將 SIP 媒體應用程式與透過 Amazon Chime SDK 會議命名空間建立的會議搭配使用時,此JoinChimeMeeting動作需要MeetingId參數。

會議名稱空間有不斷增加的 Chime 命名空間沒有的 API 清單。如果您要開始使用 Amazon Chime 開發套件,請使用會議命名空間存取最新功能。