設定目的地 - Kinesis Video Streams

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

設定目的地

建立 Kinesis Video Streams 資源後,您需要告知訊號頻道要將其儲存到哪個串流。

如果您想要刪除訊號頻道或串流,您必須先將其取消連結。請參閱 取消連結訊號頻道和串流

使用 UpdateMediaStorageConfiguration API,並為您要連結的 Kinesis Video Streams 資源輸入 ARNs。

重要

一旦StorageStatus啟用,就不會再發生直接peer-to-peer(主要檢視者) 連線。對等直接連線至儲存工作階段。您必須呼叫 JoinStorageSession API 來觸發 SDP 優惠傳送,並在對等和儲存工作階段之間建立連線。

AWS Management Console
注意

Kinesis Video Streams 目前不支援此操作 AWS Management Console。

開啟 AWS CLI 已安裝並設定 的 AWS CloudShell 終端機。如需詳細資訊,請參閱 AWS CloudShell 使用者指南

遵循 AWS CLI 索引標籤中的指示。

AWS CLI

確認您已安裝 AWS CLI 並設定 。如需詳細資訊,請參閱AWS Command Line Interface文件。

如需安裝說明,請參閱AWS Command Line Interface 《 使用者指南》。安裝後,使用登入資料和區域設定 AWS CLI

或者,開啟已安裝並設定 AWS CLI 的 AWS CloudShell 終端機。如需詳細資訊,請參閱 AWS CloudShell 使用者指南

在 中執行 Update-Media-Storage-Configuration命令 AWS CLI:

aws kinesisvideo update-media-storage-configuration \ --channel-arn arn:aws:kinesisvideo:us-west-2:123456789012:channel/YourChannelName/1234567890123 \ --media-storage-configuration \ StreamARN="arn:aws:kinesisvideo:us-west-2:123456789012:stream/YourStreamName/1234567890123",Status="ENABLED" \ --region "us-west-2"
AWS SDK

此程式碼片段說明如何使用適用於 JavaScript 的 AWS SDK v2 設定訊號頻道,將媒體擷取至指定的 Kinesis 影片串流。語法將與其他 AWS SDKs不同,但一般流程將相同。在 GitHub 上檢視完整的程式碼範例。

建立 Kinesis Video Streams 用戶端。這是用來呼叫 UpdateMediaStorageConfiguration API 的用戶端。

const clientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2' }; const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);

使用 用戶端呼叫 UpdateMediaStorageConfiguration API。

await kinesisVideoClient .updateMediaStorageConfiguration({ ChannelARN: 'YourChannelARN', MediaStorageConfiguration: { Status: 'ENABLED', StreamARN: 'YourStreamARN', }, }) .promise();

具有此程式碼範例的即時網頁可在 GitHub 上使用。輸入您的區域、 AWS 憑證和訊號頻道的名稱。

展開 WebRTC 擷取和儲存節點,輸入串流的名稱,然後選擇更新媒體儲存組態。頻道會設定為將媒體擷取至指定的串流。

重要

在訊號頻道或串流彼此取消連結之前,您無法將其刪除。

如果您不希望訊號頻道的媒體擷取至串流,請使用 UpdateMediaStorageConfiguration API 來取消連結 Kinesis Video Streams 資源。頻道取消連結後,即可繼續直接peer-to-peer連線。

AWS Management Console
注意

Kinesis Video Streams 目前不支援此操作 AWS Management Console。

開啟 AWS CLI 已安裝並設定 的 AWS CloudShell 終端機。如需詳細資訊,請參閱 AWS CloudShell 使用者指南

遵循 AWS CLI 索引標籤中的指示。

AWS CLI

確認您已安裝 AWS CLI 並設定 。如需詳細資訊,請參閱AWS Command Line Interface文件。

如需安裝說明,請參閱AWS Command Line Interface 《 使用者指南》。安裝後,使用登入資料和區域設定 AWS CLI

或者,開啟 AWS CLI 已安裝並設定 的 AWS CloudShell 終端機。如需詳細資訊,請參閱 AWS CloudShell 使用者指南

在 中執行 Update-Media-Storage-Configuration命令 AWS CLI:

aws kinesisvideo update-media-storage-configuration \ --channel-arn arn:aws:kinesisvideo:us-west-2:123456789012:channel/YourChannelName/1234567890123 \ --media-storage-configuration \ StreamARN="null",Status="DISABLED" \ --region "us-west-2"
AWS SDK

此程式碼片段說明如何使用適用於 JavaScript 的 AWS SDK v2 設定訊號頻道,將媒體擷取至指定的 Kinesis 影片串流。語法將與其他 AWS SDKs不同,但一般流程將相同。在 GitHub 上檢視完整的程式碼範例。

建立 Kinesis Video Streams 用戶端。這是用來呼叫 UpdateMediaStorageConfiguration API 的用戶端。

const clientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2' }; const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);

使用 用戶端呼叫 UpdateMediaStorageConfiguration API。

await kinesisVideoClient .updateMediaStorageConfiguration({ ChannelARN: 'YourChannelARN', MediaStorageConfiguration: { Status: 'DISABLED', StreamARN: 'null', }, }) .promise();

具有此程式碼範例的即時網頁可在 GitHub 上使用。輸入您的區域、 AWS 憑證和訊號頻道的名稱。

展開 WebRTC 擷取和儲存節點,確認串流名稱欄位為空白,然後選擇更新媒體儲存組態。頻道將不再設定為將媒體擷取至指定的串流。