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

# 建立影片串流
<a name="ingestion-create-stream"></a>

請依照這些程序建立將擷取媒體的串流。如果您已建立目的地串流，請略過此步驟。

**重要**  
WebRTC 擷取需要資料保留大於 0 的 Kinesis 影片串流。最短為 1 小時。

若要建立串流，請使用 AWS 管理主控台 AWS CLI、 或其中一個 AWS SDK 呼叫 [CreateStream](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_CreateStream.html) API。

**重要**  
請記下串流 ARN，稍後會需要它。

------
#### [ AWS 管理主控台 ]

請執行下列操作：

1. 開啟位於 https：//[https://console.aws.amazon.com/kinesisvideo/home/](https://console.aws.amazon.com//kinesisvideo/home/) 的 **Kinesis Video Streams** 主控台。

1. 在 **Video streams (影片串流)** 頁面上，選擇 **Create video stream (建立影片串流)**.

1. 在**建立新的影片串流**頁面上，輸入 `YourStreamName`做為串流名稱。保持選取**預設組態**按鈕。

   這會建立資料保留大於 0 的串流。

   選擇 **Create video stream (建立影片串流**。

1. Kinesis Video Streams 建立串流後，請檢閱`YourStreamName`頁面上的詳細資訊。

------
#### [ AWS CLI ]

確認您已安裝 AWS CLI 並設定 。如需詳細資訊，請參閱[「AWS Command Line Interface 使用者指南」](https://docs.aws.amazon.com//cli/latest/userguide/)。

如需安裝說明，請參閱[AWS Command Line Interface 《 使用者指南》](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html#getting-started-install-instructions)。安裝後，使用登入資料和區域[設定 AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-quickstart.html#getting-started-quickstart-new)。

或者，開啟已安裝並設定 AWS CLI 的 AWS CloudShell 終端機。如需詳細資訊，請參閱 [AWS CloudShell 使用者指南](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html#how-to-get-started)。

使用 執行下列`Create-Stream`命令 AWS CLI：

```
aws kinesisvideo create-stream \
  --stream-name "YourStreamName" \
  --data-retention-in-hours 24 \
  --region "us-west-2"
```

回應如下所示：

```
{
    "StreamARN": "arn:aws:kinesisvideo:us-west-2:123456789012:stream/YourStreamName/1234567890123"
}
```

------
#### [ AWS SDK ]

此程式碼片段說明如何使用 AWS 適用於 JavaScript 的 SDK v2 建立 Kinesis 影片串流。語法將與其他 AWS SDKs不同，但一般流程將相同。在 [GitHub](https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-js/blob/master/examples/createStream.js) 上檢視完整的程式碼範例。

建立 Kinesis Video Streams 用戶端。這是用來呼叫 [CreateStream](https://docs.aws.amazon.com//kinesisvideostreams/latest/dg/API_CreateStream.html) API 的用戶端。

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

使用 用戶端呼叫 `CreateStream` API。

```
const createStreamResponse = await kinesisVideoClient
    .createStream({
        StreamName: 'YourStreamName',
        DataRetentionInHours: 48,
    })
    .promise();
```

列印回應。

```
console.log(createStreamResponse.StreamARN);
```

具有此程式碼範例的即時網頁可在 [GitHub](https://awslabs.github.io/amazon-kinesis-video-streams-webrtc-sdk-js/examples/index.html) 上使用。輸入您的區域、 AWS 憑證和訊號頻道的名稱。

展開 **WebRTC 擷取和儲存**節點，輸入串流的名稱，然後選擇**建立串流**。彈出式視窗會詢問您要保留串流資料的時數。輸入大於 0 的值，然後選擇**建立串流**。

------