AWS IoT TwinMaker video integration
Video cameras present a good opportunity for digital twin simulation. You can use AWS IoT TwinMaker to simulate your camera's location and physical conditions. Create entities in AWS IoT TwinMaker for your on-site cameras, and use video components to stream live video and metadata from your site to your AWS IoT TwinMaker scene or to a Grafana dashboard.
AWS IoT TwinMaker can capture video from edge devices in two ways. You can stream video from edge
devices with the edge connector for Kinesis video stream, or you can save video on the edge device and
initiate video uploading with MQTT messages. Use this component to stream video data from
your devices for use with AWS IoT services. To generate the required resources and deploy the
edge connector for Kinesis Video Streams, see the Getting started with the edge connector for Kinesis video stream
After you've created the required AWS IoT SiteWise models and configured the Kinesis Video Streams Greengrass component, you can stream or record video on the edge to your digital twin application in the AWS IoT TwinMaker console. You can also view livestreams and metadata from your devices in a Grafana dashboard. For more information about integrating Grafana and AWS IoT TwinMaker, see AWS IoT TwinMaker Grafana dashboard integration.
Use the edge connector for Kinesis video stream to stream video in AWS IoT TwinMaker
With the edge connector for Kinesis video stream, you can stream video and data to an entity in your AWS IoT TwinMaker scene. You use a video component to do this. To create the video component for use in your scenes, complete the following procedure.
Prerequisites
Before you create the video component in your AWS IoT TwinMaker scene, make sure you've completed the following prerequisites.
-
Created the required AWS IoT SiteWise models and assets for the edge connector for Kinesis video stream. For more information about creating the AWS IoT SiteWise assets for the connector, see Getting started with the edge connector for Kinesis video stream
. -
Deployed the Kinesis video stream edge connector on your AWS IoT Greengrass device. For more information about deploying the Kinesis video stream edge connector component, see the deployment README
.
Create video components for AWS IoT TwinMaker scenes
Complete the following steps to create the edge connector for the Kinesis video stream component for your scene.
In the AWS IoT TwinMaker console, open the scene you want to add the video component to.
After the scene is opens, choose an existing entity or create the entity you want to add the component to, and then choose Add component.
In the Add component pane, enter a name for the component, and for the Type, choose com.amazon.iotsitewise.connector.edgevideo.
Choose an Asset Model by selecting the name of the AWS IoT SiteWise camera model you created. This name should have the following format:
EdgeConnectorForKVSCameraModel-0abc
, where the string of letters and numbers at the end matches your own asset name.For Asset, choose the AWS IoT SiteWise camera assets you want to stream video from. A small window appears showing you a preview of the current video stream.
Note
To test your video streaming, choose test. This test sends out an MQTT event to initiate video live streaming. Wait for a few moments to see the video show up in the player.
To add the video component to your entity, choose Add component.
Add video and metadata from Kinesis video stream to a Grafana dashboard
After you've created a video component for your entity in your AWS IoT TwinMaker scene, you can configure the video panel in Grafana to see live streams. Make sure you have properly integrated AWS IoT TwinMaker with Grafana. For more information, see AWS IoT TwinMaker Grafana dashboard integration.
Important
To view video in your Grafana dashboard, you must make sure the Grafana datasources have the proper IAM permissions. To create the required role and policy see Creating a dashboard IAM role.
Complete the following steps to see Kinesis Video Streams and metadata in your Grafana dashboard.
Open the AWS IoT TwinMaker dashboard.
Choose Add panel, and then choose Add an empty panel.
From the panels list, choose the AWS IoT TwinMaker video player panel.
In the AWS IoT TwinMaker video player panel, enter the stream name of the KinesisVideoStreamName, with the name of the Kinesis video stream you want to stream video from.
Note
To stream metadata to the Grafana video panel, you must first have created an entity with a video streaming component.
-
Optional: To stream metadata from AWS IoT SiteWise assets to the video player, for Entity, choose the AWS IoT TwinMaker entity that you created in your AWS IoT TwinMaker scene. For the Component name, choose the video component you created for the entity in your AWS IoT TwinMaker scene.