使用 Amazon Chime SDK - Amazon Chime SDK

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

使用 Amazon Chime SDK

您可以使用 Amazon Chime SDK 建置即時媒體應用程式,以傳送和接收音訊和影片,並允許內容共用。Amazon Chime 獨立於任何 Amazon Chime 管理員帳戶SDK運作,不會影響 Amazon Chime 上託管的會議。相反地,Amazon Chime SDK提供建置工具,讓您用來建置自己的會議應用程式。

使用 Amazon Chime 的先決條件 SDK

使用 Amazon Chime SDK需要下列項目:

  • 程式設計的能力。

  • AWS 帳戶。

  • 具有政策IAM的角色,可授予存取 Amazon Chime 所用 Amazon Chime API動作的許可SDK,例如 AWS 受管AmazonChimeSDK政策。如需詳細資訊,請參閱Amazon Chime 管理員指南 中的 Amazon IAM Chime 如何使用 和SDK允許使用者存取 Amazon Chime SDK動作

  • 對於大多數使用案例,您也需要下列項目:

    • 伺服器應用程式 – 管理會議和出席者資源,並將這些資源提供給用戶端應用程式。伺服器應用程式是在 AWS 帳戶中建立的,必須能夠存取上述IAM角色。

    • 用戶端應用程式 – 從伺服器應用程式接收會議和出席者資訊,並使用該資訊進行媒體連線。

Amazon Chime 的概念 SDK

下列術語和概念是了解如何使用 Amazon Chime 的核心SDK。

會議

由唯一 識別的暫時資源MeetingIdMeetingId 會放置在託管作用中會議的一組媒體服務上。

媒體服務群組

託管作用中會議的媒體服務群組。

媒體放置

一組區域化URLs,代表媒體服務群組。出席者會與其用戶端連線媒體服務群組,以傳送和接收即時音訊和影片,並共用其畫面。

出席者

由唯一 識別的會議參與者AttendeeId。與會者可以使用使用 Amazon Chime 用戶端程式庫建置的SDK用戶端應用程式自由加入和退出會議。

加入權杖

指派給每位出席者的唯一權杖。參與者使用聯結權杖來驗證媒體服務群組。

Amazon Chime 的架構 SDK

下列清單說明 Amazon Chime SDK架構的不同元件如何協同運作,以支援會議和出席者、音訊、影片和內容共用。

會議和出席者

當伺服器應用程式建立 Amazon Chime SDK 會議時,會將該會議指派給區域特定的媒體服務。服務中的主機負責在出席者用戶端之間安全地傳輸即時媒體。每個建立的出席者都會獲得一個唯一的聯結權杖,即伺服器應用程式必須安全地傳輸到授權代表出席者加入會議的用戶端的不透明秘密金鑰。每個用戶端都會使用聯結權杖來驗證媒體服務群組。用戶端會使用安全 WebSockets 與資料包傳輸層安全 (DTLS) 的組合,安全地向媒體服務群組發出訊號,並透過媒體服務群組向其他出席者傳送和接收媒體。

音訊

媒體服務會將來自每個出席者的音訊混合在一起,並在從混合中減去自己的音訊後,將混合傳送給每個收件人。Amazon Chime 以裝置和瀏覽器支援的最高速率SDKs範例音訊,最多 48 個kHz。我們使用 Opus 轉碼器來編碼音訊,預設位元速率為 32kbps,最多可提高至 128kbps 的立體聲和 64kbps 的單聲道。

影片

媒體服務使用發佈和訂閱模型,充當選擇性轉送單位 (SFU)。每個與會者都可以發佈一個影片來源,每次會議最多同時發佈 25 個影片。的 Amazon Chime SDK用戶端程式庫 JavaScript 支援高達 1280x720 的影片解析度,每秒 30 個影格,無模擬,以及每秒 15 個影格,附模擬。適用於 iOS Android Windows 的 Amazon Chime SDK用戶端程式庫支援高達每秒 1280x720 和 30 個影格的影片解析度,但實際影格速率和解析度由 Amazon Chime 自動管理SDK。

作用中時,影片模擬器會以兩種不同的解析度和位元速率傳送每個影片串流。具有頻寬限制的用戶端會自動訂閱較低的位元速率串流。視訊編碼和解碼使用硬體加速來改善效能。

資料訊息

除了音訊和影片內容之外,會議出席者還可以互相傳送每個 2 KB 的即時資料訊息。您可以使用訊息來實作自訂會議功能,例如白板、聊天、即時表情符號反應和應用程式特定的樓層控制訊號。

內容共用

用戶端應用程式可以共用音訊和影片內容,例如螢幕擷取或媒體檔案。內容共用支援高達 1280x720 的預先錄製內容影片,每秒 15 個影格,以及高達 48 kHz 的 64kbps 音訊。內容共用的螢幕擷取支援每秒最多 15 個影格,但可能會受到裝置和瀏覽器的功能限制。

Amazon Chime 的配額 SDK

Amazon Chime SDK服務的配額記錄在 中 AWS 一般參考。如需詳細資訊,請參閱中的 Amazon Chime SDK端點和配額AWS 一般參考

注意

服務配額是每個API端點。請求增加服務配額時,請務必請求增加應用程式使用的所有API端點。

Amazon Chime SDK系統需求

下列系統需求適用於使用 Amazon Chime 建立的應用程式SDK。

支援的瀏覽器、適用於 的 Amazon Chime SDK用戶端程式庫 JavaScript

作業系統 瀏覽器 支援的版本 備註

Windows

Mozilla Firefox

75 及更新版本

Google Chrome

78 及更新版本

以鉻為基礎的 Edge

79 及更新版本
鉻基電子 7 及更新版本 搭配 Chrome 78 版及更新版本。
Opera 66 及更新版本

macOS

Mozilla Firefox

75 及更新版本

Google Chrome

78 及更新版本

以鉻為基礎的 Edge

79 及更新版本

鉻基電子

Safari 13 及更新版本
Opera 66 及更新版本
iOS Mozilla Firefox 10 及更新版本 僅限音訊和影片,不共用內容。
Google Chrome 78 及更新版本 僅限音訊和影片,不共用內容。
Safari 13 及更新版本 僅限音訊和影片,不共用內容。
WKWebView 14.3 及更新版本 僅限音訊和影片,不共用內容。
Android Google Chrome 10 及更新版本 僅限音訊和影片,不共用內容。
三星 12 版和更新版本 僅限音訊和影片,不共用內容。
鉻 WebView 5 及更新版本 僅限音訊和影片,不共用內容。
Ubuntu LTS 16.04 及更新版本 Google Chrome 78 及更新版本
適用於 iOS 的 Amazon Chime SDK用戶端程式庫
  • iOS 版本 13 及更高版本

Android 版 Amazon Chime SDK用戶端程式庫
  • Android OS 第 5 版及更新版本,ARM以及ARM64架構