本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon IoT TwinMaker 视频集成
<a name="video-integration"></a>

摄像机为数字孪生仿真提供了好机会。您可以使用 Amazon IoT TwinMaker 模拟相机的位置和物理条件。 Amazon IoT TwinMaker 为现场摄像机创建实体，并使用视频组件将实时视频和元数据从您的站点流式传输到 Amazon IoT TwinMaker 场景或 Grafana 仪表板。

Amazon IoT TwinMaker 可以通过两种方式从边缘设备捕获视频。您可以使用 Kinesis 视频流的边缘连接器流式传输边缘设备视频，也可以将视频保存在边缘设备上，并使用 MQTT 消息启动视频上传。使用此组件从您的设备流式传输视频数据以用于 Amazon IoT 服务。要为 Kinesis Video Streams 生成所需资源并部署边缘连接器，请参阅 [Kinesis 视频流边缘连接器入门](https://github.com/awslabs/aws-iot-greengrass-edge-connector-for-kinesis-video-stream/tree/main/gettingstarted)。 GitHub有关该 Amazon IoT Greengrass 组件的更多信息，请参阅有关 [Kinesis Video Streams 边缘连接器的 Amazon IoT Greengrass](https://docs.amazonaws.cn/greengrass/v2/developerguide/kvs-edge-connector-component.html)文档。

创建所需 Amazon IoT SiteWise 模型并配置 Kinesis Video Streams Greengrass 组件后，您可以在控制台中将边缘视频流式传输或录制到数字双胞胎应用程序。 Amazon IoT TwinMaker 您还可以在 Grafana 控制面板中查看设备上的实时数据和元数据。有关集成 Grafan Amazon IoT TwinMaker a 和的更多信息，请参阅。[Amazon IoT TwinMaker Grafana 控制面板集成](grafana-integration.md)

## 使用 Kinesis 视频流的边缘连接器流式传输视频 Amazon IoT TwinMaker
<a name="add-video-streams-to-TM"></a>

借助 Kinesis 视频流的边缘连接器，您可以将视频和数据流式传输到场景中的 Amazon IoT TwinMaker 实体。您可使用视频组件完成此操作。要创建用于场景的视频组件，请完成以下程序。

### 先决条件
<a name="configure-video-streams-prerequisites"></a>

在 Amazon IoT TwinMaker 场景中创建视频组件之前，请确保已完成以下先决条件。
+ 为 Kinesis 视频流的边缘连接器创建了所需的 Amazon IoT SiteWise 模型和资产。有关为连接器创建 Amazon IoT SiteWise 资产的更多信息，请参阅 [Kinesis 视频流边缘连接器入门](https://github.com/awslabs/aws-iot-greengrass-edge-connector-for-kinesis-video-stream/tree/main/gettingstarted)。
+ 已在您的 Amazon IoT Greengrass 设备上部署 Kinesis 视频流边缘连接器。有关部署 Kinesis 视频流边缘连接器组件的更多信息，请参阅部署 [自述文件](https://github.com/awslabs/aws-iot-greengrass-edge-connector-for-kinesis-video-stream/blob/main/README.md)。

### 为 Amazon IoT TwinMaker 场景创建视频组件
<a name="create-video-components"></a>

完成以下步骤，以为场景的 Kinesis 视频流组件创建边缘连接器。

1. 在 Amazon IoT TwinMaker 控制台中，打开要添加视频组件的场景。

1. 场景打开后，选择现有实体或创建组件添加目标实体，然后选择 **添加组件**。

1. 在 **添加组件**窗格中，输入组件名称，在 **类型**栏选择 **com.amazon.iotsitewise.connector.edgevideo**。

1. 通过选择您创建的 Amazon IoT SiteWise 相机**型号的名称来选择资源**模型。此名称应采用以下格式：`EdgeConnectorForKVSCameraModel-0abc`，其中末尾的字母和数字字符串与您自己的资产名称匹配。

1. 在 “**资源**” 中，选择要从中流式传输视频的 Amazon IoT SiteWise 摄像机资源。显示小窗口，可预览当前视频流。
**注意**  
若要测试您的视频流，请选择**测试**。此测试发出 MQTT 活动，以启动视频直播。稍等片刻，视频将会出现在播放器中。

1. 若要将视频组件添加至实体，请选择 **添加组件**。

## 将 Kinesis 视频流中的视频和元数据添加至 Grafana 控制面板
<a name="configure-video-panel-Grafana"></a>

在 Amazon IoT TwinMaker 场景中为实体创建视频组件后，可以在 Grafana 中配置视频面板以查看直播。请确保您已 Amazon IoT TwinMaker 与 Grafana 正确集成。有关更多信息，请参阅 [Amazon IoT TwinMaker Grafana 控制面板集成](grafana-integration.md)。

**重要**  
要在 Grafana 控制面板中观看视频，必须确保 Grafana 数据源具有适当的 IAM 权限。若要创建所需角色和政策，请参见 [创建控制面板 IAM 角色](dashboard-IAM-role.md)。

完成以下步骤，即可在 Grafana 控制面板中查看 Kinesis 视频流和元数据。

1. 打开 Amazon IoT TwinMaker 仪表板。

1. 选择 “**添加面板”**，然后选择 “**添加空面板”**。
**注意**  
**对于 Grafana v10.4，视频播放器位于 Widge Amazon IoT TwinMaker t 下。**选择**添加 >> 控件**。

1. 在面板列表中，选择 **Amazon IoT TwinMaker 视频播放器** 面板。

1. 在**Amazon IoT TwinMaker 视频播放器**面板中，输入的**直播名称 **KinesisVideoStreamName****，以及您要从中流式传输视频的 Kinesis 视频流的名称。
**注意**  
要将元数据流式传输至 Grafana 视频面板，必须先创建带有视频流组件的实体。

1. **可选：**要将 Amazon IoT SiteWise 资源中的元数据流式传输到视频播放器，对于 “**实体**”，请选择您在 Amazon IoT TwinMaker 场景中创建的 Amazon IoT TwinMaker 实体。在 **组件名称**窗格，选择您为 Amazon IoT TwinMaker 场景中的实体创建的视频组件。