本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
適用於 Web 應用程式的 JavaScript 中的 Amazon Kinesis Video Streams with WebRTC SDK WebRTC
您可以在適用於 Web 應用程式的 JavaScript 中找到 Kinesis Video Streams with WebRTC SDK,以及其在 GitHub
安裝軟體開發套件
在 JavaScript 中使用 WebRTC 開發套件安裝 Kinesis Video Streams 是否及如何安裝取決於程式碼是否在Node.js
模組或瀏覽器指令碼中執行。
WebRTC JavaScript SDK 文件
SDK 方法的文件位於 GitHub 讀我檔案下https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js?tab=readme-ov-file#documentation
在用量
如需完整應用程式的範例,包括主要和檢視器角色,請參閱 examples
目錄。
使用範例應用程式
Kinesis Video Streams with WebRTC 也會託管範例應用程式,您可以使用該應用程式來建立新的訊號頻道,或連接至現有的頻道,並將其用作主頻道或檢視器。
Kinesis Video Streams with WebRTC 範例應用程式位於 GitHub
範例應用程式的程式碼位於 examples
目錄中。
主題
從範例應用程式將peer-to-peer串流至 AWS Management Console
-
使用 WebRTC 範例應用程式開啟 Kinesis Video Streams
,並完成下列操作: -
AWS 區域。 例如,
us-west-2
。 -
IAM 使用者或角色的 AWS 存取金鑰和私密金鑰。如果您使用長期 AWS 憑證,請將工作階段字符保留空白。
-
您要連線的訊號頻道的名稱。
如果您想要連線至新的訊號頻道,請選擇建立頻道,以建立具有方塊中所提供值的訊號頻道。
注意
目前帳戶和區域的訊號頻道名稱必須是唯一的。您可以使用字母、數字、底線 (_) 和連字號 (-),但不能使用空格。
-
是否要傳送音訊、視訊或兩者。
-
WebRTC 擷取和儲存。展開節點,然後選擇下列其中一項:
-
選取自動判斷擷取模式。
-
確定未選取自動判斷擷取模式,並將手動覆寫設定為 OFF。
注意
自動判斷擷取模式可讓應用程式呼叫 DescribeMediaStorageConfiguration API,以決定要在哪個模式中執行 (Peer-to-peer或 WebRTC 擷取)。此額外的 API 呼叫會將少量新增至啟動時間。
如果您事先知道此訊號頻道正在哪個模式中執行,請使用手動覆寫略過此 API 呼叫。
-
-
產生 ICE 候選項目。保持
STUN
/TURN
選取並保持Trickle ICE
啟用狀態。
-
-
選擇 Start Master 以連接至訊號頻道。
如有需要,允許存取您的攝影機和/或麥克風。
在 中開啟 Kinesis Video Streams 主控台
AWS Management Console。 確定已選取正確的區域。
在左側導覽中,選取訊號頻道
。 選取上述訊號頻道的名稱。如有需要,請使用搜尋列。
展開媒體播放檢視器區段。
選擇影片播放器上的播放按鈕。這會以 的形式加入 WebRTC 工作階段
viewer
。在示範頁面上傳送的媒體應該會顯示在 中 AWS Management Console。
從範例應用程式串流peer-to-peer到範例應用程式
-
使用 WebRTC 範例應用程式開啟 Kinesis Video Streams
,並填寫下列資訊: -
AWS 區域。 例如,
us-west-2
。 -
IAM 使用者或角色的 AWS 存取金鑰和私密金鑰。如果您使用長期 AWS 憑證,請將工作階段字符保留空白。
-
您要連線的訊號頻道的名稱。
如果您想要連接到新的訊號頻道,請選擇建立頻道,以建立具有方塊中所提供值的訊號頻道。
注意
目前帳戶和區域的訊號頻道名稱必須是唯一的。您可以使用字母、數字、底線 (_) 和連字號 (-),但不能使用空格。
-
是否要傳送音訊、視訊或兩者。
-
WebRTC 擷取和儲存。展開節點,然後選擇下列其中一項:
-
選取自動判斷擷取模式。
-
請確定未選取自動判斷擷取模式,並將手動覆寫設定為 OFF。
注意
自動判斷擷取模式可讓應用程式呼叫 DescribeMediaStorageConfiguration API,以決定要在哪個模式中執行 (Peer-to-peer或 WebRTC 擷取)。此額外的 API 呼叫會將少量新增至啟動時間。
如果您事先知道此訊號頻道正在哪個模式中執行,請使用手動覆寫略過此 API 呼叫。
-
-
產生 ICE 候選項目。保持
STUN
/TURN
選取並保持Trickle ICE
啟用狀態。
-
-
選擇 Start Master 以做為
master
角色連線至訊號頻道。如有需要,允許存取您的攝影機和/或麥克風。
-
開啟另一個瀏覽器索引標籤,並使用 WebRTC 範例應用程式開啟 Kinesis Video Streams
。應載入先前執行的所有資訊。 -
向下捲動並選擇開始檢視器,以做為
viewer
角色連線至訊號頻道。您應該會看到在
master
和 之間交換的媒體viewer
。
使用 WebRTC 擷取,從範例頁面串流peer-to-peer範例頁面
依照 從瀏覽器擷取媒體 來連接主要參與者,並確認其已連線至儲存工作階段。
遵循 將檢視器新增至擷取工作階段 以新增瀏覽者參與者。
檢視器參與者將連接至儲存工作階段並從中接收媒體。他們可以將選用的音訊傳回儲存工作階段。
儲存工作階段會處理混合從主要和檢視器參與者收到的媒體,並將其傳送至適當的目的地。
您可以透過 Kinesis Video Streams 播放來檢視和使用擷取的媒體。
編輯範例應用程式
若要編輯 SDK 和範例應用程式以進行開發,請遵循下列指示。
必要條件
NodeJS 16+ 版
注意
我們建議您從 https://nodejs.org/en/download
編輯範例應用程式
-
在 JavaScript 中下載 Kinesis Video Streams with WebRTC SDK。
在終端機中輸入下列項目:
git clone https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js.git
-
使用 package.json 檔案導覽至 目錄。檔案位於儲存庫的根目錄中。
在終端機中輸入下列項目:
cd amazon-kinesis-video-streams-webrtc-sdk-js
-
安裝依存項目。
在終端機中輸入下列 npm CLI
命令: npm install
-
啟動 Web 伺服器以開始提供網頁。
在終端機中輸入下列 npm CLI
命令: npm run develop
-
在您的瀏覽器中,請造訪 http://localhost:3001/
。 您可以編輯
examples
目錄中的檔案來編輯網頁。