擷取媒體 - Kinesis Video Streams
從瀏覽器擷取媒體從 WebRTC C 擷取媒體 SDK將檢視器新增至擷取工作階段

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

擷取媒體

有下列限制：

  • 工作階段持續時間：一小時，最長

  • 訊號頻道：每個帳戶最多 100 個啟用儲存組態的帳戶

從瀏覽器擷取媒體

重要

Chrome 目前是唯一支援的瀏覽器。

  1. 在 JavaScript 範例頁面SDK中開啟 Amazon Kinesis Video Streams with WebRTC。

  2. 請填妥下列資訊：

    • KVS 端點 - 在區域欄位中，選取您的區域。

      例如：us-west-2。

    • AWS 憑證

      完成下列欄位：

      • Access Key ID (存取金鑰 ID)

      • Secret Access Key (私密存取金鑰)

      • 工作階段權杖 - 範例應用程式支援臨時和長期憑證。如果您使用長期IAM登入資料，請將此欄位保留空白。如需詳細資訊，請參閱 中的臨時安全登入IAM資料。

    • 訊號頻道 - 在頻道名稱欄位中，輸入您先前設定的訊號頻道名稱。如需詳細資訊，請參閱設定目的地。

    • 音軌 - 選取傳送視訊和傳送音訊。

    • WebRTC 擷取和儲存 - 展開節點，然後選取自動判斷擷取模式。此選項可讓範例應用程式呼叫 DescribeMediaStorageConfigurationAPI，以決定要在哪個模式下執行。

  3. 選取啟動主要。

    如果訊號頻道設定為使用 擷取API，則範例應用程式會在連線至訊號頻道以啟動 WebRTC 擷取工作流程JoinStorageSessionAPI後立即自動叫用 DescribeMediaStorageConfiguration 。

從 WebRTC C 擷取媒體 SDK

依照適用於嵌入式裝置的 Amazon Kinesis Video Streams 搭配 C RTC SDK 中的網頁程序建置範例應用程式。

  1. 使用登入 AWS 帳戶 資料設定您的環境：

    export AWS_ACCESS_KEY_ID=YourAccessKey
export AWS_SECRET_ACCESS_KEY=YourSecretKey
export AWS_DEFAULT_REGION=YourAWSRegion

    如果您使用的是臨時 AWS 憑證，也請匯出工作階段字符：

    export AWS_SESSION_TOKEN=YourSessionToken

  2. 執行範例：

    主要範例

    導覽至 build 資料夾，並使用「1」做為第二個引數。類型：

    ./samples/kvsWebrtcClientMaster channel-name 1

    GStreamer 主要範例

    導覽至 build 資料夾，並使用「audio-video-storage」做為第二個引數。類型：

    ./samples/kvsWebrtcClientMasterGstSample channel-name audio-video-storage testsrc

這會啟動 WebRTC 擷取。

注意

您提供的訊號頻道必須設定為儲存。使用 DescribeMediaStorageConfiguration API 確認。

將檢視器新增至擷取工作階段

注意

具有多檢視器支援 （預覽版） 的 WebRTC 擷取會在預覽版中提供，如 AWS 服務條款所定義，且可能有所變更。它目前僅適用於 us-east-1(IAD)。

若要參與預覽，請傳送電子郵件至 。

一旦訊號頻道進入 WebRTC 擷取模式，檢視器參與者就不會再直接連線至主要參與者。檢視器參與者會直接連線至儲存工作階段。檢視器參與者會收到主要參與者傳送的媒體，檢視器參與者可以將選用音訊傳回給主要參與者。只要主要參與者連線到儲存工作階段，檢視器傳回的任何音訊都會傳送至所有其他連線至儲存工作階段並擷取至 Kinesis Video Stream 的對等。

有下列限制：

  • 檢視器數量上限：3

  • 檢視器參與者可以連接到儲存工作階段的時間上限，而主參與者不存在：3 分鐘

重要

如果檢視器與儲存工作階段中斷連線 （關閉對等連線），其配額 （檢視器限制） 會維持 1 分鐘。在這 1 分鐘期間，檢視器可以使用API相同的用戶端 ID 調用此 ID 來重新加入工作階段，而無需額外的檢視器配額。1 分鐘後，檢視器配額會釋出，並可供其他檢視器加入。

瀏覽器

重要

Chrome 是唯一支援的瀏覽器。

  1. 在 JavaScript 範例頁面的 Amazon Kinesis Video Streams with WebRTC SDK中開啟另一個索引標籤。上一頁的所有資訊都會自動填入。如果沒有，請完成下列資訊：

    • KVS 端點 - 在區域欄位中，選取您的區域。

      例如：us-west-2。

    • AWS 憑證

      完成下列欄位：

      • Access Key ID (存取金鑰 ID)

      • Secret Access Key (私密存取金鑰)

      • 工作階段權杖 - 範例應用程式支援臨時和長期憑證。如果您使用長期IAM登入資料，請將此欄位保留空白。如需詳細資訊，請參閱 中的臨時安全登入IAM資料。

    • 訊號頻道 - 在頻道名稱欄位中，輸入您先前設定的訊號頻道名稱。如需詳細資訊，請參閱設定目的地。

    • 音軌 - 選取傳送音訊。請注意，如果已核取傳送視訊，則選擇啟動檢視器時會自動取消核取該視訊。

    • WebRTC 擷取和儲存 - 展開節點，然後選取自動判斷擷取模式。此選項可讓範例應用程式呼叫 DescribeMediaStorageConfigurationAPI，以決定要在哪個模式下執行。

  2. 選取啟動檢視器。

    應用程式會在連線至訊號頻道JoinStorageSessionAsViewerAPI後立即自動呼叫 ，以觸發從工作階段傳送給檢視器的SDP提議。

注意

使用 peer-to-peer Web 時RTC，檢視器參與者是控制對等，而主要參與者是控制對等。在 WebRTC 擷取模式中，儲存工作階段現在是控制對等。連線至 訊號並叫用 後JoinStorageSessionAsViewer，檢視器將需要回應SDP優惠，並透過 Web 建立儲存工作階段的連線RTC。

注意

儲存工作階段只會傳送TURN候選項目。從參與者的角度來指定ICE候選配對時，遠端候選一律為類型 relay。