使用 Amazon Chime 聲開發套件 - Amazon Chime SDK

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

使用 Amazon Chime 聲開發套件

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

Amazon Chime 聲 SDK 先決條件

使用 Amazon Chime 開發套件需要下列條件:

  • 編程的能力。

  • 一個 AWS 帳戶。

  • 具有政策的 IAM 角色,可授予存取 Amazon Chime 開發套件所使用之 Amazon Chime API 動作 (例如 AWS 受管AmazonChime開發套件政策) 的權限。如需詳細資訊,請參閱 Amazon Chime 如何使用 IAM允許使用者存取 Amazon Chime 開發套件管理員指南中的 Amazon Chime 開發套件動作

  • 對於大多數用例,您還需要以下內容:

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

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

Amazon Chime 聲 SDK 概念

以下術語和概念是了解如何使用 Amazon Chime 開發套件的核心。

會議

由唯一識別的暫時資源。MeetingId會放MeetingId置在主持使用中會議的媒體服務群組中。

媒體服務群組

主持使用中會議的媒體服務群組。

媒體放置

代表媒體服務群組的一組區域化 URL。與會者與客戶連接到媒體服務組,以發送和接收實時音頻和視頻,以及共享他們的屏幕。

與會者

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

加入令牌

分配給每個出席者的唯一令牌。出席者使用加入權杖向媒體服務群組進行驗證。

Amazon Chime 聲 SDK 架構

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

會議和出席者

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

音訊

媒體服務會將每個出席者的音訊混合在一起,並在從混音中減去自己的音訊後,將混音傳送給每個收件者。Amazon Chime SDK 會以裝置和瀏覽器所支援的最高速率取樣音訊,最高可達 48kHz。我們使用 Opus 編解碼器對音頻進行編碼,默認比特率為 32kbps,最多可以增加到 128kbps 立體聲和 64kbps mono。

影片

媒體服務充當使用發佈和訂閱模型的選擇性轉送單元 (SFU)。每位出席者可以發佈一個視訊來源,每次會議最多可同時發佈 25 部影片。Amazon Chime SDK 用戶端程式庫可 JavaScript 支援高達 1280x720 的視訊解析度,每秒 30 個畫面,無需同步廣播,而且每秒 15 個影格 (同步廣播)。適用於 iOS安卓Windows 的 Amazon Chime SDK 用戶端程式庫支援高達每秒 1280x720 和 30 幀的視訊解析度,但實際的畫面播放速率和解析度是由 Amazon Chime 開發套件自動管理。

當作用中時,視訊同步廣播會以兩種不同的解析度和位元速率傳送每個視訊串流。具有頻寬限制的用戶端會自動訂閱較低位元速率串流。視訊編碼和解碼會在可用的情況下使用硬體加速來改善效能。

資料訊息

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

內容分享

用戶端應用程式可以共用音訊和視訊內容,例如螢幕擷取或媒體檔案。內容分享支援預先錄製的內容視訊,最高可達 1280x720,每秒 15 格,音訊速度最高可達 48 千赫(64kbps)。內容共用的螢幕擷取最多支援每秒 15 個畫面,但可能受到裝置和瀏覽器功能的限制。

Amazon Chime SDK 服務配額

注意

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

此表格列出 Amazon Chime 開發套件會議可用的資源和配額。

資源 配額 可調整

活躍會議

250

每次會議出席者

250

每個會議的音訊串流

250

每個會議發佈的視訊串流

25

是的,最多可容納 250 人

每位出席者訂閱的視訊串流

25

每次會議的內容共用

2

每個主要會議的複本會議 4 是的,最多可容納 40 人

每個會議的活動媒體捕獲管道

1

每個帳戶的活動媒體捕獲管道

us-east-1 個端點為 100,其他端點則為 10 個

API 速率

每秒 10 個請求 (RPS),突發 20 RPS。

是的,但間接

注意

當您增加使用中會議配額時,API 速率限制會增加。

Amazon Chime 聲開發套件系統需求

下列系統需求適用於使用 Amazon Chime 開發套件建立的應用程式。

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

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

Windows

Mozilla Firefox

75 及更高版本

Google Chrome

78 及更高版本

鉻基邊緣

79 及更高版本
鉻基電子 7 及更新版本 使用鉻版本 78 及更高版本。
Opera 66 及更高版本

macOS

Mozilla Firefox

75 及更高版本

Google Chrome

78 及更高版本

鉻基邊緣

79 及更高版本

鉻基電子

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

Amazon Chime 聲 SDK 安卓用戶端程式庫
  • 安卓作業系統版本 5 及更高版本,手臂和 ARM64 架構