翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS IoT TwinMaker ビデオ統合
<a name="video-integration"></a>

ビデオカメラはデジタルツインシミュレーションの好機です。 AWS IoT TwinMaker を使用して、カメラの位置や物理的状態をシミュレートできます。オンサイトカメラ AWS IoT TwinMaker 用に にエンティティを作成し、ビデオコンポーネントを使用して、サイトから AWS IoT TwinMaker シーンまたは Grafana ダッシュボードにライブビデオとメタデータをストリーミングします。

AWS IoT TwinMaker は、2 つの方法でエッジデバイスからビデオをキャプチャできます。Kinesis Video Streams 用のエッジコネクタを使用してエッジデバイスからビデオをストリーミングすることも、エッジデバイスにビデオを保存して 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 Video Streams 用エッジコネクタを始める](https://github.com/awslabs/aws-iot-greengrass-edge-connector-for-kinesis-video-stream/tree/main/gettingstarted)」を参照してください。
+  AWS IoT Greengrass デバイスに Kinesis ビデオストリームエッジコネクタをデプロイしました。Kinesis Video Streams エッジコネクタコンポーネントのデプロイについて詳しくは、デプロイ [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 Video Streams コンポーネントのエッジコネクタを作成します。

1.  AWS IoT TwinMaker コンソールで、ビデオコンポーネントを追加するシーンを開きます。

1. シーンが開いたら、既存のエンティティを選択するか、コンポーネントを追加するエンティティを作成して、**[コンポーネントの追加]** を選択します。

1. **[コンポーネントの追加]** ペインでコンポーネントの名前を入力し、**[タイプ]** に **com.amazon.iotsitewise.connector.edgevideo** を選択します。

1. 作成した AWS IoT SiteWise カメラモデルの名前を選択して、**アセット**モデルを選択します。この名前は以下の形式でなければなりません: `EdgeConnectorForKVSCameraModel-0abc`、末尾のアルファベットと数字の文字列はアセット名と一致させるべきです。

1. **アセット** で、ビデオをストリーミングする AWS IoT SiteWise カメラアセットを選択します。小さなウィンドウが開き、現在のビデオストリームのプレビューが表示されます。
**注記**  
ビデオストリーミングをテストするには、**[テスト]** を選択します。このテストでは、MQTT イベントを送信して動画ライブストリーミングを開始します。プレイヤーに動画が表示されるまでしばらくお待ちください。

1. エンティティにビデオコンポーネントを追加するには、**[コンポーネントの追加]** を選択します。

## Kinesis Video Streams から Grafana ダッシュボードにビデオとメタデータを追加
<a name="configure-video-panel-Grafana"></a>

 AWS IoT TwinMaker シーンでエンティティのビデオコンポーネントを作成したら、Grafana でビデオパネルを設定してライブストリームを表示できます。Grafana AWS IoT TwinMaker と適切に統合されていることを確認します。詳細については、「[AWS IoT TwinMaker Grafana ダッシュボードの統合](grafana-integration.md)」を参照してください。

**重要**  
Grafana ダッシュボードで動画を表示するには、Grafana データソースに適切な IAM アクセス許可があることを確認する必要があります。必要なロールとポリシーを作成するには、[ダッシュボード IAM ロールの作成](dashboard-IAM-role.md) を参照してください。

次の手順を実行して、Kinesis Video Streams とメタデータを Grafana ダッシュボードに表示します。

1.  AWS IoT TwinMaker ダッシュボードを開きます。

1. **「パネルの追加**」を選択し、**「空のパネルの追加**」を選択します。
**注記**  
Grafana v10.4 の場合、 AWS IoT TwinMaker ビデオプレイヤーは**ウィジェット**にあります。**>> ウィジェットの追加**を選択します。

1. パネルリストから、**[AWS IoT TwinMaker ビデオプレイヤー]** パネルを選択します。

1. **[AWS IoT TwinMaker ビデオプレイヤー]** パネルで、**[KinesisVideoStreamName]** の **[ストリーム名]** に、ビデオをストリーミングしたい Kinesis Video Streams の名前を入力します。
**注記**  
Grafana ビデオパネルにメタデータをストリーミングするには、まずビデオストリーミングコンポーネントを含むエンティティを作成する必要があります。

1. **オプション:** AWS IoT SiteWise アセットからビデオプレーヤーにメタデータをストリーミングするには、**エンティティ**で、 AWS IoT TwinMaker シーンで作成した AWS IoT TwinMaker エンティティを選択します。**[コンポーネント名]** には、 AWS IoT TwinMaker シーン内のエンティティ用に作成したビデオコンポーネントを選択します。