翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Kinesis Video Streams 向けのエッジコネクタ Kinesis Video Streams コンポーネントのエッジコネクタ (`aws.iot.EdgeConnectorForKVS`) は、ローカルカメラからビデオフィードを読み取り、ストリームを Kinesis Video Streams に発行します。このコンポーネントは、リアルタイムストリーミングプロトコル (RTSP) を使用してインターネットプロトコル (IP) カメラからビデオフィードを読み取るように設定できます。次に、[Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) またはローカルの Grafana サーバーでダッシュボードを設定すると、ビデオストリームの監視とやり取りを行えます。 このコンポーネントを AWS IoT TwinMaker と統合して、Grafana ダッシュボードでビデオストリームを表示および制御できます。 AWS IoT TwinMaker は、物理システムの運用デジタルツインを構築できる AWS サービスです。 AWS IoT TwinMaker を使用すると、センサー、カメラ、エンタープライズアプリケーションのデータを視覚化して、物理的な工場、建物、産業プラントを追跡できます。また、このデータを使用してオペレーションの監視、エラーの診断、エラーの修復を行うことができます。詳細については、「 [AWS IoT TwinMaker ユーザーガイド」の「TwinMaker とは](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html)」を参照してください。 *AWS IoT TwinMaker * このコンポーネントは AWS IoT SiteWise、産業用データをモデル化して保存する AWS サービスである にその設定を保存します。では AWS IoT SiteWise、*アセット*はデバイス、機器、または他のオブジェクトのグループなどのオブジェクトを表します。このコンポーネントを設定して使用するには、Greengrass コアデバイスごと、および各コアデバイスに接続された IP カメラごとに AWS IoT SiteWise アセットを作成します。各アセットにはライブストリーミング、オンデマンドアップロード、ローカルキャッシュなどの機能を制御するために設定を行うプロパティがあります。各カメラの URL を指定するには、カメラの URL が含まれているシークレットを AWS Secrets Manager に作成します。カメラが認証を必要とする場合は、URL にユーザー名とパスワードも指定します。次に、IP カメラのアセットプロパティでそのシークレットを指定します。 このコンポーネントは、各カメラのビデオストリームを Kinesis のビデオストリームにアップロードします。各カメラの AWS IoT SiteWise アセット設定で、送信先 Kinesis ビデオストリームの名前を指定します。Kinesis の ビデオストリームが存在しない場合、このコンポーネントはユーザーのためにそれを作成します。 AWS IoT TwinMaker には、これらの AWS IoT SiteWise アセットと Secrets Manager シークレットを作成するために実行できるスクリプトが用意されています。これらのリソースの作成方法、およびこのコンポーネントのインストール、設定、および使用方法の詳細については、「AWS IoT TwinMaker ユーザーガイド」の「[AWS IoT TwinMaker のビデオ統合](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html)」を参照してください。 **注記** Kinesis Video Streams コンポーネントのエッジコネクタは、以下の AWS リージョンでのみ利用できます。 米国東部 (バージニア北部) 米国西部 (オレゴン) 欧州 (フランクフルト) 欧州 (アイルランド) アジアパシフィック (シンガポール) アジアパシフィック (東京) アジアパシフィック (ソウル) アジアパシフィック (シドニー) アジアパシフィック (ムンバイ) 中国 (北京) **Topics** + [バージョン](#kvs-edge-connector-component-versions) + [タイプ](#kvs-edge-connector-component-type) + [オペレーティングシステム](#kvs-edge-connector-component-os-support) + [要件](#kvs-edge-connector-component-requirements) + [依存関係](#kvs-edge-connector-component-dependencies) + [設定](#kvs-edge-connector-component-configuration) + [ライセンス](#kvs-edge-connector-component-licenses) + [使用方法](#kvs-edge-connector-component-usage) + [ローカルログファイル](#kvs-edge-connector-component-log-file) + [変更ログ](#kvs-edge-connector-component-changelog) + [関連情報](#kvs-edge-connector-component-see-also) ## バージョン このコンポーネントには、次のバージョンがあります。 + 1.0.x ## タイプ このコンポーネントはジェネリックコンポーネント (`aws.greengrass.generic`) です。[Greengrass nucleus](greengrass-nucleus-component.md) は、コンポーネントのライフサイクルスクリプトを実行します。 詳細については、「[コンポーネントタイプ](develop-greengrass-components.md#component-types)」を参照してください。 ## オペレーティングシステム このコンポーネントは、Linux コアデバイスにのみインストールできます。 ## 要件 このコンポーネントには次の要件があります。 + コンポーネント設定はコアデバイスごとに一意である必要があるため、このコンポーネントをデプロイできるのはシングルコアデバイスに対してのみです。このコンポーネントをコアデバイスのグループにデプロイすることはできません。 + コアデバイスに [GStreamer](https://gstreamer.freedesktop.org) 1.18.4 以降がインストールされています。詳細については、「[GStreamer のインストール](https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c)」を参照してください。 `apt` を使用するデバイスでは、以下のコマンドを実行して GStreamer をインストールできます。 ``` sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps sudo apt install -y gstreamer1.0-libav sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools ``` + 各コアデバイスの AWS IoT SiteWise アセット。この AWS IoT SiteWise アセットはコアデバイスを表します。このアセットの作成方法の詳細については、「AWS IoT TwinMaker ユーザーガイド」の「[AWS IoT TwinMaker のビデオ統合](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html)」を参照してください。 + 各コアデバイスに接続する各 IP カメラ用の AWS IoT SiteWise アセット。これらの AWS IoT SiteWise アセットは、各コアデバイスにビデオをストリーミングするカメラを表します。各カメラのアセットを、カメラに接続するコアデバイスのアセットに関連付ける必要があります。カメラアセットには、Kinesis ビデオストリーム、認証シークレット、およびビデオストリーミングパラメータを指定する設定を行えるプロパティがあります。カメラアセットの作成および設定方法の詳細については、「AWS IoT TwinMaker ユーザーガイド」の「[AWS IoT TwinMaker のビデオ統合](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html)」を参照してください。 + 各 IP カメラ用のシー AWS Secrets Manager クレット。このシークレットは、キーと値のペアを定義する必要があります。この場合、キーは `RTSPStreamUrl`、値はカメラの URLになります。カメラが認証を必要とする場合は、この URL にユーザー名とパスワードを含めます。このコンポーネントに必要なリソースを作成するとき、スクリプトを使用してシークレットを作成できます。詳細については、「AWS IoT TwinMaker ユーザーガイド」の「[AWS IoT TwinMaker のビデオ統合](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html)」を参照してください。 Secrets Manager コンソールと API を使用して、追加のシークレットを作成することもできます。詳細については、「AWS Secrets Manager ユーザーガイド」の「[シークレットの作成](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html)」を参照してください。 + [Greengrass トークン交換ロール](device-service-role.md)では AWS Secrets Manager AWS IoT SiteWise、次の IAM ポリシーの例に示すように、 および Kinesis Video Streams アクションを許可する必要があります。 **注記** このポリシーの例は、デバイスが **IPCamera1Url** と **IPCamera2Url** という名前のシークレットの値を取得することを許可します。各 IP カメラを設定するときは、そのカメラの URL を含むシークレットを指定します。カメラが認証を必要とする場合は、URL にユーザー名とパスワードも指定します。コアデバイスのトークン交換ロールは、各 IP カメラが接続するために、シークレットへのアクセスを許可する必要があります。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "secretsmanager:GetSecretValue" ], "Effect": "Allow", "Resource": [ "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera1Url", "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera2Url" ] }, { "Action": [ "iotsitewise:BatchPutAssetPropertyValue", "iotsitewise:DescribeAsset", "iotsitewise:DescribeAssetModel", "iotsitewise:DescribeAssetProperty", "iotsitewise:GetAssetPropertyValue", "iotsitewise:ListAssetRelationships", "iotsitewise:ListAssets", "iotsitewise:ListAssociatedAssets", "kinesisvideo:CreateStream", "kinesisvideo:DescribeStream", "kinesisvideo:GetDataEndpoint", "kinesisvideo:PutMedia", "kinesisvideo:TagStream" ], "Effect": "Allow", "Resource": [ "*" ] } ] } ``` ------ **注記** カスタマーマネージド AWS Key Management Service キーを使用してシークレットを暗号化する場合、デバイスロールは `kms:Decrypt`アクションも許可する必要があります。 ### エンドポイントおよびポート このコンポーネントは、基本的な操作に必要なエンドポイントとポートに加えて、次のエンドポイントとポートに対し、アウトバウンドリクエストを実行できる必要があります。詳細については、「[プロキシまたはファイアウォールを介したデバイストラフィックを許可する](allow-device-traffic.md)」を参照してください。 | Endpoint | ポート | 必要 | 説明 | | --- | --- | --- | --- | | `kinesisvideo.region.amazonaws.com` | 443 | はい | Kinesis Video Streams にデータをアップロードします。 | | `data.iotsitewise.region.amazonaws.com` | 443 | はい | ビデオストリームのメタデータを AWS IoT SiteWiseに発行します。 | | `secretsmanager.region.amazonaws.com` | 443 | はい | コアデバイスにカメラ URL シークレットをダウンロードします。 | ## 依存関係 コンポーネントをデプロイすると、 は互換性のあるバージョンの依存関係 AWS IoT Greengrass もデプロイします。つまり、コンポーネントを正常にデプロイするには、コンポーネントとその依存関係のすべての要件を満たす必要があります。このセクションでは、このコンポーネントの[リリースされたバージョン](#kvs-edge-connector-component-changelog)の依存関係と、各依存関係に対するコンポーネントのバージョンを定義するセマンティックバージョン制約をリスト表示しています。コンポーネントの各バージョンの依存関係は、[AWS IoT Greengrass コンソール](https://console.aws.amazon.com//greengrass)でも確認できます。コンポーネントの詳細ページで **[Dependencies]** (依存関係) リストを確認します。 次の表に、このコンポーネントのバージョン 1.0.0 から 1.0.5 までの依存関係を示します。 | 依存関係 | 互換性のあるバージョン | 依存関係タイプ | | --- | --- | --- | | [トークン交換サービス](token-exchange-service-component.md) | >=2.0.3 | ハード | | [ストリームマネージャー](stream-manager-component.md) | >=2.0.9 | ハード | コンポーネントの依存関係の詳細については、「[コンポーネント recipe のリファレンス](component-recipe-reference.md#recipe-reference-component-dependencies)」を参照してください。 ## 設定 このコンポーネントには、コンポーネントのデプロイ時にカスタマイズできる次の設定パラメータが用意されています。 `SiteWiseAssetIdForHub` このコアデバイスを表す AWS IoT SiteWise アセットの ID。このアセットを作成して、このコンポーネントとのやり取りに使用する方法の詳細については、「*AWS IoT TwinMaker ユーザーガイド*」の「[AWS IoT TwinMaker video integration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html)」を参照してください。 **Example 例: 設定マージの更新** ``` { "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ``` ## ライセンス このコンポーネントには、次のサードパーティーソフトウェア/ライセンス品が含まれています。 + [Quartz Job Scheduler](http://www.quartz-scheduler.org/) / Apache License 2.0 + [Java bindings for GStreamer 1.x](https://github.com/gstreamer-java/gst1-java-core) / GNU Lesser General Public License v3.0 ## 使用方法 このコンポーネントを設定して操作するには、コアデバイスと接続する IP カメラを表す AWS IoT SiteWise アセットにプロパティを設定できます。また、 AWS IoT TwinMaker を介して Grafana ダッシュボードのビデオストリームを視覚化して操作することもできます。詳細については、「*AWS IoT TwinMaker ユーザーガイド*」の「[AWS IoT TwinMaker video integration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html)」を参照してください。 ## ローカルログファイル このコンポーネントは次のログファイルを使用します。 ``` /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` **このコンポーネントのログを確認するには** + コアデバイスに次のコマンドを実行して、このコンポーネントのログファイルをリアルタイムに確認します。を AWS IoT Greengrass ルートフォルダへのパス`/greengrass/v2`に置き換えます。 ``` sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log ``` ## 変更ログ 次の表は、コンポーネントの各バージョンにおける変更を示します。 | **バージョン** | **変更** | | --- | --- | | 1.0.5 | 一般的なバグ修正と機能強化。 | | 1.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/greengrass/v2/developerguide/kvs-edge-connector-component.html) | | 1.0.3 | 一般的なバグ修正と機能強化。 | | 1.0.1 | 一般的なバグ修正と機能強化。 | | 1.0.0 | 当初のバージョン | ## 関連情報 + [AWS IoT TwinMaker ユーザーガイドの「TwinMaker とは](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html)*AWS IoT TwinMaker*」 + [AWS IoT TwinMaker ユーザーガイドの TwinMaker ビデオ統合](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) *AWS IoT TwinMaker * + *AWS IoT SiteWise ユーザーガイド*の[「 AWS IoT SiteWiseとは](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)」 + 「*AWS IoT SiteWise ユーザーガイド*」の「[Updating attribute values](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html)」 + 「 AWS Secrets Managerユーザーガイド」の「[AWS Secrets Manager とは](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)」 + 「*AWS Secrets Manager ユーザーガイド*」の「[Create and manage secrets](https://docs.aws.amazon.com/secretsmanager/latest/userguide/managing-secrets.html)」