本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon Chime SDK
您可以使用 Amazon Chime 開發套件來建置即時媒體應用程式，以傳送和接收音訊和視訊，並允許內容共用。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 用戶端程式庫**
- **Windows**
- **瀏覽器:** Mozilla Firefox / **支援的版本:** 75 及更新版本 / **備註:**
- **瀏覽器:** Google Chrome / **支援的版本:** 78 及更新版本 / **備註:**
- **瀏覽器:** 以 Chromium 為基礎的 Edge / **支援的版本:** 79 及更新版本 / **備註:**
- **瀏覽器:** 以 Chromium 為基礎的電子 / **支援的版本:** 7 和更新版本 / **備註:** 使用 Chrome 78 版和更新版本。
- **瀏覽器:** Opera / **支援的版本:** 66 及更新版本 / **備註:**
- ** macOS **
- **瀏覽器:** Mozilla Firefox / **支援的版本:** 75 及更新版本 / **備註:**
- **瀏覽器:** Google Chrome / **支援的版本:** 78 及更新版本 / **備註:**
- **瀏覽器:** 以 Chromium 為基礎的 Edge / **支援的版本:** 79 及更新版本 / **備註:**
- **瀏覽器:** 以 Chromium 為基礎的電子 / **支援的版本:** / **備註:**
- **瀏覽器:** Safari / **支援的版本:** 13 及更新版本 / **備註:**
- **瀏覽器:** Opera / **支援的版本:** 66 及更新版本 / **備註:**
- **iOS**
- **瀏覽器:** Mozilla Firefox / **支援的版本:** 10 及更新版本 / **備註:** 僅限音訊和視訊，不共用內容。
- **瀏覽器:** Google Chrome / **支援的版本:** 78 及更新版本 / **備註:** 僅限音訊和視訊，不共用內容。
- **瀏覽器:** Safari / **支援的版本:** 13 及更新版本 / **備註:** 僅限音訊和視訊，不共用內容。
- **瀏覽器:** WKWebView / **支援的版本:** 14.3 及更新版本 / **備註:** 僅限音訊和視訊，不共用內容。
- **Android**
- **瀏覽器:** Google Chrome / **支援的版本:** 10 及更新版本 / **備註:** 僅限音訊和視訊，不共用內容。
- **瀏覽器:** Samsung / **支援的版本:** 12 版和更新版本 / **備註:** 僅限音訊和視訊，不共用內容。
- **瀏覽器:** Chromium WebView / **支援的版本:** 5 和更新版本 / **備註:** 僅限音訊和視訊，不共用內容。
- **Ubuntu LTS 16.04 及更新版本**
- **瀏覽器:** Google Chrome
- **支援的版本:** 78 及更新版本
- **備註:**
**適用於 iOS 的 Amazon Chime SDK 用戶端程式庫**
+ iOS 版本 13 及更高版本
**適用於 Android 的 Amazon Chime SDK 用戶端程式庫**
+ Android OS 第 5 版及更新版本、ARM 和 ARM64 架構