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

# AWS IoT TwinMaker 影片整合
<a name="video-integration"></a>

攝影機是數位孿生模擬的好機會。您可以使用 AWS IoT TwinMaker 來模擬相機的位置和實體條件。在 中 AWS IoT TwinMaker 為您的現場攝影機建立實體，並使用影片元件將即時影片和中繼資料從您的網站串流到 AWS IoT TwinMaker 場景或 Grafana 儀表板。

AWS IoT TwinMaker 可以透過兩種方式從邊緣裝置擷取影片。您可以使用 Kinesis 影片串流的邊緣連接器從邊緣裝置串流影片，也可以在邊緣裝置上儲存影片，並使用 MQTT 訊息啟動影片上傳。使用此元件可從您的裝置串流影片資料，以搭配 AWS IoT 服務使用。若要產生所需的資源並部署 Kinesis Video Streams 的邊緣連接器，請參閱 GitHub 上 [Kinesis Video Streams 的邊緣連接器入門](https://github.com/awslabs/aws-iot-greengrass-edge-connector-for-kinesis-video-stream/tree/main/gettingstarted)。如需 AWS IoT Greengrass 元件的詳細資訊，請參閱 [Kinesis Video Streams 邊緣連接器](https://docs.aws.amazon.com/greengrass/v2/developerguide/kvs-edge-connector-component.html)上的 AWS IoT Greengrass 文件。

建立所需的 AWS IoT SiteWise 模型並設定 Kinesis Video Streams Greengrass 元件之後，您可以在 AWS IoT TwinMaker 主控台中將邊緣的影片串流或錄製到數位分身應用程式。您也可以在 Grafana 儀表板中檢視裝置的即時串流和中繼資料。如需整合 Grafana 和 的詳細資訊 AWS IoT TwinMaker，請參閱 [AWS IoT TwinMaker Grafana 儀表板整合](grafana-integration.md)。

## 使用 Kinesis 影片串流的邊緣連接器在 中串流影片 AWS IoT TwinMaker
<a name="add-video-streams-to-TM"></a>

使用 Kinesis 影片串流的邊緣連接器，您可以將影片和資料串流到 AWS IoT TwinMaker 場景中的實體。您可以使用影片元件來執行此操作。若要建立影片元件以用於場景，請完成下列程序。

### 先決條件
<a name="configure-video-streams-prerequisites"></a>

在 AWS IoT TwinMaker 場景中建立影片元件之前，請確定您已完成下列先決條件。
+ 為 Kinesis 影片串流的邊緣連接器建立所需的 AWS IoT SiteWise 模型和資產。如需為連接器建立 AWS IoT SiteWise 資產的詳細資訊，請參閱 [Kinesis 影片串流的邊緣連接器入門](https://github.com/awslabs/aws-iot-greengrass-edge-connector-for-kinesis-video-stream/tree/main/gettingstarted)。
+ 已在您的裝置上部署 Kinesis 影片串流邊緣連接器 AWS IoT Greengrass 。如需部署 Kinesis 影片串流邊緣連接器元件的詳細資訊，請參閱部署 [README](https://github.com/awslabs/aws-iot-greengrass-edge-connector-for-kinesis-video-stream/blob/main/README.md)。

### 建立 AWS IoT TwinMaker 場景的影片元件
<a name="create-video-components"></a>

完成下列步驟，為您的場景建立 Kinesis 影片串流元件的邊緣連接器。

1. 在 AWS IoT TwinMaker 主控台中，開啟您要新增視訊元件的場景。

1. 場景開啟後，選擇現有的實體或建立您要新增元件的實體，然後選擇**新增元件**。

1. 在**新增元件**窗格中，輸入元件的名稱，然後在**類型**中選擇 **com.amazon.iotsitewise.connector.edgevideo**。

1. 選取您建立的 AWS IoT SiteWise 攝影機模型名稱，以選擇**資產**模型。此名稱應該具有下列格式：`EdgeConnectorForKVSCameraModel-0abc`，其中結尾的字母和數字字串與您自己的資產名稱相符。

1. 針對**資產**，選擇您要從中串流視訊的 AWS IoT SiteWise 攝影機資產。此時會出現一個小視窗，顯示目前視訊串流的預覽。
**注意**  
若要測試您的影片串流，請選擇**測試**。此測試會傳送 MQTT 事件以啟動視訊即時串流。等待片刻，查看播放器中出現的影片。

1. 若要將影片元件新增至實體，請選擇**新增元件**。

## 將影片和中繼資料從 Kinesis 影片串流新增至 Grafana 儀表板
<a name="configure-video-panel-Grafana"></a>

在 AWS IoT TwinMaker 場景中為實體建立影片元件之後，您可以在 Grafana 中設定影片面板以查看即時串流。請確定您已 AWS IoT TwinMaker 與 Grafana 正確整合。如需詳細資訊，請參閱[AWS IoT TwinMaker Grafana 儀表板整合](grafana-integration.md)。

**重要**  
若要在 Grafana 儀表板中檢視影片，您必須確定 Grafana 資料來源具有適當的 IAM 許可。若要建立所需的角色和政策，請參閱 [建立儀表板 IAM 角色](dashboard-IAM-role.md)。

完成下列步驟，即可在 Grafana 儀表板中查看 Kinesis Video Streams 和中繼資料。

1. 開啟 AWS IoT TwinMaker 儀表板。

1. 選擇**新增面板**，然後選擇**新增空白面板**。
**注意**  
對於 Grafana v10.4， AWS IoT TwinMaker 影片播放器位於 **Widget** 下。選取**新增 >> 小工具**。

1. 從面板清單中，選擇**AWS IoT TwinMaker 影片播放器**面板。

1. 在**AWS IoT TwinMaker 影片播放器**面板中，輸入 **KinesisVideoStreamName** 的**串流名稱**，其中包含您要串流影片的 Kinesis 影片串流名稱。
**注意**  
若要將中繼資料串流到 Grafana 影片面板，您必須先使用影片串流元件建立實體。

1. **選用：**若要將中繼資料從 AWS IoT SiteWise 資產串流到影片播放器，請在**實體**中選擇您在 AWS IoT TwinMaker 場景中建立的 AWS IoT TwinMaker 實體。針對**元件名稱**，選擇您為場景中的 AWS IoT TwinMaker 實體建立的視訊元件。