擷取媒體 - 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 擷取。

注意

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

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

注意

具有多檢視器支援 （預覽） 的 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。