設定目的地 - 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 擷取和儲存節點，確認串流名稱欄位為空白，然後選擇更新媒體儲存組態。頻道將不再設定為將媒體擷取至指定的串流。