本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 Amazon Chime SDK 您可以使用 Amazon Chime SDK 來建置即時媒體應用程式，以傳送和接收音訊和視訊，並允許內容共用。Amazon Chime SDK 獨立於任何 Amazon Chime 管理員帳戶運作，不會影響 Amazon Chime 上託管的會議。反之，Amazon Chime SDK 會提供建置器工具，讓您用來建置自己的會議應用程式。 **Topics** + [使用 Amazon Chime SDK 的先決條件](#mtg-prereqs) + [Amazon Chime SDK 的概念](#mtg-glossary) + [Amazon Chime SDK 的架構](#mtg-arch) + [Amazon Chime SDK 的配額](#mtg-limits) + [Amazon Chime SDK 系統需求](#mtg-browsers) + [Amazon Chime SDK 的可用 AWS 區域](sdk-available-regions.md) + [了解 Amazon Chime SDK 用戶端程式庫](mtgs-sdk-client-lib.md) + [了解使用 Amazon Chime SDK Voice Connector 的 SIP 整合](mtgs-sdk-cvc.md) + [了解 Amazon Chime SDK 事件通知](mtgs-sdk-notifications.md) + [從 Amazon Chime 命名空間遷移](migrate-from-chm-namespace.md) ## 使用 Amazon Chime SDK 的先決條件 使用 Amazon Chime SDK 需要下列項目： + 編寫程式的能力。 + AWS 帳戶。 + 具有政策的 IAM 角色，可授予存取 Amazon Chime SDK 所用 Amazon Chime API 動作的許可，例如 AWS 受管 **AmazonChimeSDK** 政策。如需詳細資訊，請參閱[《Amazon Chime SDK 管理員指南》中的 Amazon Chime 如何使用 IAM](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html) ** [和允許使用者存取 Amazon Chime SDK 動作](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk)。 + 對於大多數使用案例，您也需要下列項目： + **伺服器應用程式** – 管理會議和出席者資源，並將這些資源提供給用戶端應用程式。伺服器應用程式是在 AWS 帳戶中建立的，必須能夠存取先前提到的 IAM 角色。 + **用戶端應用程式** – 從伺服器應用程式接收會議和出席者資訊，並使用該資訊進行媒體連線。 ## Amazon Chime SDK 的概念 下列術語和概念對於了解如何使用 Amazon Chime SDK 至關重要。 **會議** 由唯一 識別的暫時性資源`MeetingId`。`MeetingId` 會放置在一組主持作用中會議的媒體服務上。 **媒體服務群組** 託管作用中會議的媒體服務群組。 **媒體放置** 一組區域化 URLs，代表媒體服務群組。出席者會與其用戶端連線到媒體服務群組，以傳送和接收即時音訊和視訊，並共用其畫面。 **出席者** 由唯一 識別的會議參與者`AttendeeId`。出席者可以使用以 Amazon Chime SDK 用戶端程式庫建置的用戶端應用程式，自由加入和退出會議。 **聯結字符** 指派給每位出席者的唯一字符。出席者使用聯結字符來驗證媒體服務群組。 ## Amazon Chime SDK 的架構 下列清單說明 Amazon Chime SDK 架構的不同元件如何協同運作，以支援會議和出席者、音訊、影片和內容共用。 **會議和出席者** 當伺服器應用程式建立 Amazon Chime SDK 會議時，會將該會議指派給區域特定的媒體服務。服務中的主機負責在出席者用戶端之間安全地傳輸即時媒體。每個建立的出席者都會獲指派一個唯一的聯結字符，這是不透明的私密金鑰，您的伺服器應用程式必須安全地轉移到授權代表出席者參加會議的用戶端。每個用戶端都會使用聯結字符來驗證媒體服務群組。用戶端使用安全 WebSockets 和 Datagram Transport Layer Security (DTLS) 的組合，安全地向媒體服務群組發出訊號，並透過媒體服務群組傳送和接收來自其他出席者的媒體。 **音訊** 媒體服務會將來自每位出席者的音訊混合在一起，並在從混合中減去自己的音訊之後，將混合傳送給每位收件人。Amazon Chime SDKs 以裝置和瀏覽器支援的最高速率取樣音訊，最大可達 48kHz。我們使用 Opus 轉碼器來編碼音訊，預設位元速率為 32kbps，最多可提高至 128kbps 立體聲和 64kbps 單聲道。 **影片** 媒體服務使用發佈和訂閱模型做為選擇性轉送單位 (SFU)。每個出席者可以發佈一個視訊來源，每次會議最多同時發佈 25 個視訊。適用於 JavaScript 的 Amazon Chime SDK 用戶端程式庫支援高達 1280x720 的視訊解析度，每秒 30 個影格，不含模擬器，每秒 15 個影格。適用於 [iOS](sdk-for-ios.md)、[Android](sdk-for-android.md) 和 [Windows](client-lib-windows.md) 的 Amazon Chime SDK 用戶端程式庫支援高達每秒 1280x720 和 30 個影格的影片解析度，但實際影格速率和解析度是由 Amazon Chime SDK 自動管理。 作用中時，影片模擬器會以兩種不同的解析度和位元速率傳送每個影片串流。具有頻寬限制條件的用戶端會自動訂閱較低的位元速率串流。視訊編碼和解碼會在可用的情況下使用硬體加速來改善效能。 **資料訊息** 除了音訊和視訊內容之外，會議出席者還可以互相傳送每個 2 KB 的即時資料訊息。您可以使用訊息來實作自訂會議功能，例如白板、聊天、即時表情符號反應，以及應用程式特定的樓層控制訊號。 **內容共用** 用戶端應用程式可以共用音訊和視訊內容，例如螢幕擷取或媒體檔案。內容共用支援每秒 15 個影格高達 1280x720 的預先錄製內容影片，以及 64kbps 高達 48kHz 的音訊。內容共用的螢幕擷取支援每秒最多 15 個影格，但可能會受限於裝置和瀏覽器的功能。 ## Amazon Chime SDK 的配額 Amazon Chime SDK 服務的配額記錄在 中 AWS 一般參考。如需詳細資訊，請參閱《》中的 [Amazon Chime SDK 端點和配額](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html)*AWS 一般參考*。 **注意** 服務配額是每個 API 端點。請求提高服務配額時，請務必請求提高應用程式使用的所有 API 端點。 ## Amazon Chime SDK 系統需求 下列系統需求適用於使用 Amazon Chime SDK 建立的應用程式。 **支援的瀏覽器、適用於 JavaScript 的 Amazon Chime SDK 用戶端程式庫** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/meetings-sdk.html) **適用於 iOS 的 Amazon Chime SDK 用戶端程式庫** + iOS 版本 13 及更高版本 **適用於 Android 的 Amazon Chime SDK 用戶端程式庫** + Android OS 第 5 版及更新版本、ARM 和 ARM64 架構 # Amazon Chime SDK 的可用 AWS 區域 下表列出 Amazon Chime SDK 服務的功能，以及提供每個服務的 AWS 區域。 **注意** 必須在 AWS 您的帳戶中啟用標示星號 (**\$1**) 的區域。 預設會 AWS 封鎖這些區域。如需啟用區域的詳細資訊，請參閱《[帳戶管理參考》中的指定您的帳戶可以使用 AWS 的區域](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html)。 *AWS * **Topics** + [主控台區域](#sdk-console-regions) + [呼叫分析區域](#call-analytics-regions) + [會議區域](#sdk-meeting-regions) + [媒體管道區域](#sdk-media-pipelines) + [訊息區域](#sdk-messaging-regions) + [語音區域](#voice-regions) ## 主控台區域 您可以使用 Amazon Chime SDK 主控台來設定資源，並進一步了解 Amazon Chime SDK 服務。 | **AWS 區域** | **主控台** | | --- | --- | | 亞太區域 (首爾) | 是 | | 亞太區域 (新加坡) | 是 | | 亞太區域 (悉尼) | 是 | | 亞太區域 (東京) (ap-northeast-1) | 是 | | 加拿大 (中部) (ca-central-1) | 是 | | 歐洲 (法蘭克福) (eu-central-1) | 是 | | 歐洲 (愛爾蘭) (eu-west-1) | 是 | | 歐洲 (倫敦) (eu-west-2) | 是 | | 美國東部 (維吉尼亞北部) (us-east-1) | 是 | | 美國西部 (奧勒岡) (us-west-2) | 是 | ## 呼叫分析區域 下表列出可用於分析、轉錄和通話記錄 AWS 的區域。 | **AWS 區域** | **語音分析** | **轉錄** | **通話錄音** | | --- | --- | --- | --- | | 美國東部 (維吉尼亞北部) (us-east-1) | 是 | 是 | 是 | | 美國西部 (奧勒岡) (us-west-2) | 是 | 是 | 是 | | 歐洲 (法蘭克福) (eu-central-1) | 否 | 是 | 是 | ## 會議區域 Amazon Chime SDK 會議具有*控制區域*和*媒體區域*。控制區域提供用來建立、更新和刪除會議的 API 端點。控制區域也會接收和處理 [了解 Amazon Chime SDK 會議生命週期事件](using-events.md)。 媒體區域會主持實際會議，而用戶端會連接到您的媒體區域。您可以在呼叫 [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) API 時指定媒體區域。 控制區域可以在相同 AWS 分割區中的任何媒體區域中建立會議。不過，您只能在用來建立會議的控制區域中更新會議。 如需選取控制項和媒體區域的詳細資訊，請參閱 [使用會議區域進行 Amazon Chime SDK 會議](chime-sdk-meetings-regions.md)。 下表列出提供控制項、媒體或兩者的區域。 | **AWS 區域** | **會議控制** | **會議媒體** | | --- | --- | --- | | 非洲 （開普敦） (af-south-1)**\$1** | 是\$1\$1 | 是 | | 亞太區域 (孟買) (ap-south-1) | 是 | 是 | | 亞太區域 (首爾) (ap-northeast-2) | 是 | 是 | | 亞太區域 (新加坡) (ap-southeast-1) | 是 | 是 | | 亞太區域 (雪梨) (ap-southeast-2) | 是 | 是 | | 亞太區域 (東京) (ap-northeast-1) | 是 | 是 | | 加拿大 (中部) (ca-central-1) | 是 | 是 | | 歐洲 (法蘭克福) (eu-central-1) | 是 | 是 | | 歐洲 (愛爾蘭) (eu-west-1) | | 是 | | 歐洲 (倫敦) (eu-west-2) | 是 | 是 | | 歐洲 （米蘭） (eu-south-1)**\$1** | | 是 | | 歐洲 (巴黎) (eu-west-3) | | 是 | | 歐洲 (斯德哥爾摩) (eu-north-1) | | 是 | | 以色列 （特拉維夫） (il-central-1)**\$1** | 是**\$1\$1** | 是 | | 南美洲 (聖保羅) (sa-east-1) | | 是 | | 美國東部 (俄亥俄) (us-east-2) | | 是 | | 美國東部 (維吉尼亞北部) (us-east-1) | 是 | 是 | | 美國西部 (加利佛尼亞北部) (us-west-1) | | 是 | | 美國西部 (奧勒岡) (us-west-2) | 是 | 是 | | AWS GovCloud （美國東部） (us-gov-east-1) | 是 | 是 | | AWS GovCloud （美國西部） (us-gov-west-1) | 是 | 是 | **\$1**您必須在 AWS 帳戶中啟用這些區域。如需詳細資訊，請參閱《 *AWS 一般參考*》中的[啟用區域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。 **\$1\$1**在此區域中使用會議控制的會議只能在此區域中託管媒體。 **注意** 若要在 an AWS GovCloud (US) 區域中建立會議，您必須使用 GovCloud 中的控制區域。此外，控制 GovCloud 中的區域只能在 AWS GovCloud (US) 區域中舉行會議。 ## 媒體管道區域 Amazon Chime SDK 媒體管道具有*控制區域*和*媒體區域*。控制區域提供用來建立和刪除媒體管道的媒體管道 API 端點。您也可以使用控制區域來接收和處理[媒體管道事件](media-pipe-events.md)。 媒體區域會執行您的媒體管道，系統會自動選取與會議相同的媒體區域。 您可以使用控制區域在任何資料區域中建立媒體管道。媒體管道可以在任何會議媒體區域中加入會議。 | **AWS 區域** | **控制項** | **媒體** | | --- | --- | --- | | 非洲 （開普敦） (af-south-1)**\$1** | | 是 | | 亞太區域 (孟買) (ap-south-1) | 是 | 是 | | 亞太區域 (首爾) (ap-northeast-2) | 是 | 是 | | 亞太區域 (新加坡) (ap-southeast-1) | 是 | 是 | | 亞太區域 (雪梨) (ap-southeast-2) | 是 | 是 | | 亞太區域 (東京) (ap-northeast-1) | 是 | 是 | | 加拿大 (中部) (ca-central-1) | 是 | 是 | | 歐洲 (法蘭克福) (eu-central-1) | 是 | 是 | | 歐洲 (愛爾蘭) (eu-west-1) | | 是 | | 歐洲 (倫敦) (eu-west-2) | 是 | 是 | | 歐洲 （米蘭） (eu-south-1)**\$1** | | 是 | | 歐洲 (巴黎) (eu-west-3) | | 是 | | 歐洲 (斯德哥爾摩) (eu-north-1) | | 是 | | 南美洲 (聖保羅) (sa-east-1) | | 是 | | 美國東部 (俄亥俄) (us-east-2) | | 是 | | 美國東部 (維吉尼亞北部) (us-east-1) | 是 | 是 | | 美國西部 (加利佛尼亞北部) (us-west-1) | | 是 | | 美國西部 (奧勒岡) (us-west-2) | 是 | 是 | **\$1**您必須在 AWS 帳戶中啟用這些區域。如需詳細資訊，請參閱《 *AWS 一般參考*》中的[啟用區域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。 ## 訊息區域 Amazon Chime SDK 訊息具有*控制區域*和*資料區域*。控制區域公開訊息 API 端點，而資料區域存放訊息。如果您使用 Amazon Kinesis 串流簡訊資料或頻道流程的 AWS Lambda 函數，它們應該位於控制區域。 | **AWS 區域** | **控制項** | **資料** | | --- | --- | --- | | 歐洲 (法蘭克福) (eu-central-1) | 是 | 是 | | 美國東部 (維吉尼亞北部) (us-east-1) | 是 | 是 | ## 語音區域 Amazon Chime SDK SIP （工作階段啟動通訊協定） 功能具有 *API 區域*和*媒體區域*，以及 *PSTN 區域*。API 區域提供用於建立和設定 SIP 功能的 API 端點。媒體區域包含 Amazon Chime SDK Voice Connectors 和 SIP 媒體應用程式。PSTN 區域可讓客戶將內部部署電話系統連線至公有電話網路。此外，PSTN 區域支援電話號碼佈建和管理。 | **AWS 區域** | **API** | **媒體** | **PSTN** | | --- | --- | --- | --- | | 亞太區域 (首爾) (ap-northeast-2) | 是 | 是 | | | 亞太區域 (新加坡) (ap-southeast-1) | 是 | 是 | | | 亞太區域 (雪梨) (ap-southeast-2) | 是 | 是 | | | 亞太區域 (東京) (ap-northeast-1) | 是 | 是 | | | 加拿大 (中部) (ca-central-1) | 是 | 是 | | | 歐洲 (法蘭克福) (eu-central-1) | 是 | 是 | | | 歐洲 (愛爾蘭) (eu-west-1) | 是 | 是 | | | 歐洲 (倫敦) (eu-west-2) | 是 | 是 | | | 美國東部 (維吉尼亞北部) (us-east-1) | 是 | 是 | 是**\$1** | | 美國西部 (奧勒岡) (us-west-2) | 是 | 是 | 是**\$1** | **\$1**如需特定 AWS 區域中電話號碼可用性的相關資訊，請參閱 [Amazon Chime SDK 定價](https://aws.amazon.com/chime/chime-sdk/pricing/)頁面。 # 了解 Amazon Chime SDK 用戶端程式庫 您必須先將用戶端應用程式與 Amazon Chime SDK 用戶端程式庫整合，才能使用 Amazon Chime SDK 建置即時會議用戶端。下列用戶端程式庫可供使用： + 適用於 [Android 的 Amazon Chime SDK 用戶端程式庫](https://github.com/aws/amazon-chime-sdk-android) – Kotlin 程式庫，可協助您在支援的 Android 裝置上建置 Amazon Chime SDK 應用程式。 + 適用於 [C\$1\$1 的 Amazon Chime SDK 訊號用戶端程式庫](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp) – C\$1\$1 程式庫，可協助您在嵌入式裝置上設定 Amazon Chime SDK 會議的訊號連線。 + 適用於 [iOS 的 Amazon Chime SDK 用戶端程式庫](https://github.com/aws/amazon-chime-sdk-ios) – Swift 程式庫，可協助您在支援的 iOS 裝置上建置 Amazon Chime SDK 應用程式。 + 適用於[ JavaScript 的 Amazon Chime SDK 用戶端程式庫](https://github.com/aws/amazon-chime-sdk-js) ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)) – 具有 TypeScript 類型定義的 JavaScript 程式庫，可協助您在已啟用 WebRTC 的瀏覽器中建置 Amazon Chime SDK 應用程式。 + 適用於 [Windows 的 Amazon Chime SDK 用戶端程式庫](https://github.com/aws/amazon-chime-sdk-cpp)。C\$1\$1 程式庫，可協助您在支援的裝置上建置 Amazon Chime SDK 應用程式。 若要了解如何將用戶端應用程式與 Amazon Chime SDK 整合，請參閱用戶端程式庫`README.md`檔案中的動作。使用示範來了解如何為您的應用程式建置特定的媒體元件。 # 了解使用 Amazon Chime SDK Voice Connector 的 SIP 整合 整合與 SIP 相容的語音基礎設施與 Amazon Chime SDK Voice Connector，以進行 SIP 語音呼叫。您必須使用 `us-east-1`或 `us-east-2`區域。您必須擁有 IP Private Branch Exchange (PBX)、工作階段邊界控制器 (SBC) 或其他具有網際網路存取的語音基礎設施，以支援工作階段起始通訊協定 (SIP)。如需詳細資訊，請參閱《*Amazon Chime SDK 管理員指南*》中的[開始之前](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq)。 **整合您的語音基礎設施** 1. 在 AWS 您的帳戶下建立 Amazon Chime SDK Voice Connector。如需詳細資訊，請參閱《[Amazon Chime SDK 管理員指南》中的建立 Amazon Chime SDK Voice Connector](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon)。 ** 1. 編輯您的 Amazon Chime SDK Voice Connector 設定，以允許從您的語音基礎設施呼叫 AWS。如需詳細資訊，請參閱《[Amazon Chime SDK 管理員指南》中的編輯 Amazon Chime SDK Voice Connector 設定](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon)。 ** 1. 針對**終止設定**，選取**已啟用**。 1. 針對**允許清單**，選擇**新增**。 1. 輸入內部 SIP 基礎設施 IP 地址的 CIDR 表示法。這可讓您的基礎設施存取 Amazon Chime SDK Voice Connector。例如，若要允許來自 IP 地址 的流量`10.24.34.0`，允許列出 CIDR 表示法 `10.24.34.0/32`。 1. 選擇**新增**。 1. 對於 **Calling plan (通話方案)**，請選取要新增至通話方案的一或多個國家/地區。 1. 視需要編輯任何其他設定，然後選擇**儲存**。 1. 在 Amazon Chime SDK 主控台的**語音連接器**下，檢視 Amazon Chime SDK Voice Connector 的**傳出主機名稱**。例如，*abcdef1ghij2klmno3pqr4*.voiceconnector.chime.aws。 1. 若要使用 Amazon Chime SDK 加入會議，請使用 SIP URI 向 Amazon Chime SDK Voice Connector 的**傳出主機名稱**提出 SIP 請求。在 SIP URI **\$117035550122**中使用電話號碼。設定 `transport` 參數以使用 TLS 通訊協定。最後，使用呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html) API 動作所產生的唯一聯結字符。如需詳細資訊，請參閱下列範例。 **Example 範例：SIP 請求** 下列範例顯示用於向 Amazon Chime SDK Voice Connector 提出 SIP 請求的 SIP URI 內容。 ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` 下列範例顯示加入 Amazon Chime SDK 會議的範例 SIP INVITE 訊息。 ``` INVITE sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token SIP/2.0 Via: SIP/2.0/TLS IPaddress:12345;rport;branch=branch;alias Max-Forwards: 70 From: sip:+12065550100@IPaddress;tag=tag To: sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;X-chime-join-token=join-token Contact: Call-ID: a1234567-89b0-1c2d-e34f-5gh678j9k2lm CSeq: 6214 INVITE Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, timer, norefersub Session-Expires: 1800 Min-SE: 90 Content-Type: application/sdp Content-Length: 991 v=0 o=- 3775321410 3775321410 IN IP4 IPaddress s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4000 RTP/SAVP 0 3 8 9 125 101 c=IN IP4 IPaddress b=TIAS:96000 a=rtcp:4001 IN IP4 IPaddress a=sendrecv a=rtpmap:0 PCMU/8000 a=rtpmap:3 GSM/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:9 G722/8000 a=rtpmap:125 opus/48000/2 a=fmtp:125 useinbandfec=1 a=rtpmap:101 telephone-event/8000 a=fmtp:101 0-16 a=crypto:1 AEAD_AES_256_GCM inline:EXAMPLE a=crypto:2 AEAD_AES_256_GCM_8 inline:EXAMPLE a=crypto:3 AES_256_CM_HMAC_SHA1_80 inline:EXAMPLE a=crypto:4 AES_256_CM_HMAC_SHA1_32 inline:EXAMPLE a=crypto:5 AES_CM_128_HMAC_SHA1_80 inline:EXAMPLE a=crypto:6 AES_CM_128_HMAC_SHA1_32 inline:EXAMPLE ``` **注意** Amazon Chime SDK 只會辨識 E.164 格式的電話號碼。請確定您的`From`標頭中有 E.164 電話號碼。 # 了解 Amazon Chime SDK 事件通知 Amazon Chime SDK 支援將會議事件通知傳送至 Amazon EventBridge、Amazon Simple Queue Service (SQS) 和 Amazon Simple Notification Service (SNS)。 **注意** 預設 Amazon Chime SDK 會議命名空間使用 `ChimeSDKMeetings`端點。舊版 Chime 命名空間使用單一端點。如需命名空間和端點的詳細資訊，請參閱本指南[遷移至 Amazon Chime SDK 會議命名空間](meeting-namespace-migration.md)稍早的 。 ## 傳送通知至 EventBridge 您可以將 Amazon Chime SDK 事件通知傳送至 EventBridge。如需搭配 EventBridge 使用 Amazon Chime SDK 的詳細資訊，請參閱[《Amazon Chime SDK 管理員指南》中的搭配 EventBridge 自動化 ](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk) Amazon Chime SDK。 **如需 EventBridge 的相關資訊，請參閱《[Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/)》。 ## 傳送通知至 Amazon SQS 和 Amazon SNS 您可以使用 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) API 參考中的 API，將 Amazon Chime SDK 會議事件通知傳送到一個 Amazon SQS 佇列，每個會議一個 Amazon SNS 主題。 **這有助於減少通知延遲。如需有關 Amazon SQS 主題的詳細資訊，請參閱《[Amazon Simple Queue Service 開發人員指南](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/)》。如需 Amazon SNS 的詳細資訊，請參閱 [Amazon Simple Notification Service 開發人員指南](https://docs.aws.amazon.com/sns/latest/dg/)。 傳送至 Amazon SQS 和 Amazon SNS 的通知包含與 Amazon Chime SDK 傳送至 EventBridge 的通知相同的資訊。Amazon Chime SDK 支援傳送會議事件通知到 API 區域中用於建立會議的佇列和主題。事件通知的傳遞順序可能不同。 ## 授予 Amazon Chime SDK 對 Amazon SQS 和 Amazon SNS 的存取權 在 Amazon Chime SDK 可以透過 Amazon SQS 佇列或 Amazon SNS 主題傳送通知之前，您必須授予 Amazon Chime SDK 將訊息發佈到佇列或主題的 Amazon Resource Name (ARN) 的許可。若要執行此作業，請將 AWS Identity and Access Management (IAM) 政策連接至佇列或主題，以將適當的許可授予 Amazon Chime SDK。如需詳細資訊，請參閱《[Amazon Simple Queue Service 開發人員指南》中的 Amazon SQS 中的身分和存取管理](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html)，以及《Amazon *Simple Notification Service 開發人員指南*》中的 [Amazon SNS 存取控制的範例案例](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html)。 ** **注意** 您的 Amazon SQS 佇列或 Amazon SNS 主題必須使用與 Amazon Chime SDK API 端點相同的 AWS 區域。 **Example 允許 Amazon Chime SDK 將事件發佈至 Amazon SQS 佇列** 下列範例 IAM 政策授予 Amazon Chime SDK 將會議事件通知發佈至指定 Amazon SQS 佇列的許可。請注意 `aws:SourceArn`和 的條件陳述式`aws:SourceAccount`。他們解決了潛在的[混淆代理人](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)問題。 + 您可以在建立以下政策`aws:SourceAccount`時使用 `aws:SourceArn`或 。您不需要同時使用兩者。 + 這些範例使用 `ChimeSDKMeetings` 命名空間和對應的端點。如果您使用 `Chime` 命名空間，則必須使用 `chime.amazonaws.com`端點。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "sqs:SendMessage", "sqs:GetQueueUrl" ], "Resource": "arn:aws:sqs:us-east-1:111122223333:queueName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` 此範例顯示允許 Amazon SNS Chime SDK 傳送會議事件通知至 SNS 主題的 Amazon SNS 政策。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` 如果 Amazon SQS 佇列已啟用伺服器端加密 (SSE)，您必須採取額外的步驟。將 IAM 政策連接至相關聯的 AWS KMS 金鑰，將 Amazon Chime SDK 許可授予加密新增至佇列的資料所需的 AWS KMS 動作。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` **Example 允許 Amazon Chime SDK 將事件發佈至 Amazon SNS 主題** 下列範例 IAM 政策授予 Amazon Chime SDK 將會議事件通知發佈至指定 Amazon SNS 主題的許可。 **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` # 從 Amazon Chime 命名空間遷移 Amazon Chime SDK 會在一組端點上公開 APIs。雖然您可以直接對端點提出 HTTPS 請求，但許多客戶在其應用程式中使用 AWS SDK 來呼叫服務 APIs。 AWS 開發套件提供不同語言，並透過封裝請求簽署和重試邏輯來簡化 API 呼叫。軟體 AWS 開發套件包含每個服務端點的命名空間。 第一次啟動時，Amazon Chime SDK 會與 Amazon Chime 應用程式共用單一端點。因此，解決方案會使用 AWS SDK 中的`Chime`命名空間來呼叫 Amazon Chime 應用程式和 Amazon Chime SDK APIs。 Amazon Chime SDK 現在為每個子服務提供專用端點，例如會議和 PSTN 音訊。每個端點都可以透過 AWS SDK 中的專用命名空間定址。 下列主題列出服務、命名空間和端點，並描述如何在程式碼中使用它們，以及搭配 AWS CLI。 **Topics** + [端點、命名空間和 CLI 命令](#endpoint-namespace-cli) + [每個服務的遷移說明](#help-per-service) + [API 映射](#name-end-map) ## 端點、命名空間和 CLI 命令 下表列出專用 Amazon Chime SDK 命名空間、端點和 CLI 命令。這些連結會帶您取得每個服務的詳細資訊。 | 端點 | AWS SDK 命名空間 | AWS SDK CLI | | --- | --- | --- | | [identity-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) | ChimeSDKIdentity | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html) | | [media-pipelines-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) | ChimeSDKMediaPipelines | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html) | | [會議-音樂](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) | ChimeSDKMeetings | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html) | | [訊息提示](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) | ChimeSDKMessaging | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html) | | [語音提示](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) | ChimeSDKVoice | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html) | ## 每個服務的遷移說明 所有客戶都應考慮使用專用的 Amazon Chime SDK 端點來存取最新的 Amazon Chime SDK 功能、APIs和 AWS 區域。如果您將共用端點與`Chime`命名空間搭配使用，下列遷移指南可協助您了解遷移前的技術差異。 + [遷移至 Amazon Chime SDKIdentity 命名空間](identity-namespace-migration.md) + [遷移至 Amazon Chime SDKMediaPipelines 命名空間](migrate-pipelines.md) + [遷移至 Amazon Chime SDKMeetings 命名空間](meeting-namespace-migration.md) + [遷移至 Amazon Chime SDKMessaging 命名空間](messaging-namespace-migration.md) + [遷移至 Amazon Chime SDKVoice 命名空間](voice-namespace-migration.md) ## API 映射 下表列出 `Chime` 命名空間中的 APIs，及其對應的專用命名空間和 APIs。某些專用 APIs與 `Chime` APIs不同，資料表會指出這些執行個體。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **＋** API 已由具有另一個名稱的 API 取代。 **\$1 **API 不再可用。