AWS IoT TwinMaker Matterport の統合 - AWS IoT TwinMaker
インテグレーションの概要Matterport インテグレーションの前提条件Matterport SDK 認証情報Matterport 認証情報を に保存する AWS Secrets Manager AWS IoT TwinMaker シーン内の Matterport スキャン AWS IoT TwinMaker Grafana ダッシュボードの MatterportMatterport と AWS IoT アプリキットの統合

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

AWS IoT TwinMaker Matterport の統合

Matterpor には、現実の環境をスキャンし、Matterport デジタルツインとも呼ばれる没入型 3D モデルを作成するためのさまざまなキャプチャオプションが用意されています。これらのモデルは Matterport スペースと呼ばれます。 AWS IoT TwinMaker は Matterport インテグレーションをサポートしているため、Matterport デジタルツインを AWS IoT TwinMaker のシーンにインポートできます。Matterport デジタルツインを と組み合わせることで AWS IoT TwinMaker、仮想環境でデジタルツインシステムを視覚化およびモニタリングできます。

Matterport 環境がインポートされた AWS IoT TwinMaker シーン。

Matterport の使用方法について詳しくは、AWS IoT TwinMaker Matterport ページにある Matterport のドキュメントを参照してください。

インテグレーションの概要

このインテグレーションでは、以下の操作を行うことができます。

  • AWS IoT TwinMaker アプリキットで Matterport タグとスペースを使用します。

  • インポートしたマテリアポートデータを AWS IoT TwinMaker Grafana ダッシュボードで表示します。 AWS IoT TwinMaker と Grafana の使用の詳細については、Grafana ダッシュボード統合ドキュメントを参照してください。

  • Matterport スペースを AWS IoT TwinMaker シーンにインポートします。

  • AWS IoT TwinMaker シーン内のデータにバインドする Matterport タグを選択してインポートします。

  • Matterport スペースを自動的に表示し、 AWS IoT TwinMaker シーンの変更にタグを付けて、同期する を承認します。

インテグレーションプロセスは 3 つの重要なステップで構成されています。

  1. Matterport の認証情報を生成して記録してください

  2. Matterport 認証情報を に保存する AWS Secrets Manager

  3. Matterport スペースを AWS IoT TwinMaker シーンにインポートする

AWS IoT TwinMaker コンソールでインテグレーションを開始します。コンソールの [設定] ページで、[サードパーティリソース] の下にある[Matterport インテグレーション] を開き、インテグレーションに必要なさまざまなリソース間を移動します。

AWS IoT TwinMaker コンソールの設定ページ。サードパーティーリソースタブの Matterport 統合ページが表示されます。

Matterport インテグレーションの前提条件

Matterport を と統合する前に AWS IoT TwinMaker 、次の前提条件を満たしていることを確認してください。

  • エンタープライズレベルの Matterport アカウントと、 AWS IoT TwinMaker 統合に必要な Matterport 製品を購入しました。

  • AWS IoT TwinMaker ワークスペースがある。詳細については、「 の開始方法 AWS IoT TwinMaker」を参照してください。

  • AWS IoT TwinMaker ワークスペースロールを更新しました。ワークスペースロールの作成の詳細については、詳しくは、「AWS IoT TwinMakerのサービスロールの作成と管理」を参照してください。

    次のコードをワークスペースロールに追加します。

    {
  "Effect": "Allow",
  "Action": "secretsmanager:GetSecretValue",
  "Resource": [
   "AWS Secrets Manager secret ARN"
  ]
}

  • インテグレーションを有効にするために必要なライセンスを設定するには、Matterport に連絡する必要があります。Matterport はまた、インテグレーションのためのプライベートモデルエンベッド (PME) も可能にします。

    既に Matterport のアカウントマネージャーがいる場合は、直接担当者に連絡してください。

    Matterport の担当者がいない場合は、以下の手順で Matterport に連絡し、インテグレーションをリクエストしてください。

    1. [Matterport と AWS IoT TwinMaker] ページを開きます。

    2. 「お問い合わせ」ボタンを押して、お問い合わせフォームを開きます。

    3. 必要な情報をフォームに入力します。

    4. 準備ができたら、[こんにちは] を選択して Matterport にリクエストを送信してください。

    インテグレーションをリクエストすると、インテグレーションプロセスを続行するために必要な Matterport SDK とプライベートモデルエンベッド (PME) 認証情報を生成できます。

    注記

    これには、新しい製品やサービスの購入に手数料がかかる場合があります。

Matterport の認証情報を生成して記録してください

Matterport を と統合するには AWS IoT TwinMaker、 に Matterport 認証情報を指定 AWS Secrets Manager する必要があります。次の手順に従って、Matterport SDK 認証情報を生成します。

  1. Matterport アカウントにログインします。

  2. アカウントの設定ページに移動します。

  3. 設定ページに移動したら、[開発者ツール] オプションを選択します。

  4. [開発者ツール] ページで、[SDK キー管理] セクションに移動します。

  5. [SDK キー管理] セクションに移動したら、新しい SDK キーを追加するオプションを選択します。

  6. Matterport SDK キーを取得したら、 AWS IoT TwinMaker と Grafana サーバーのキーにドメインを追加します。 AWS IoT TwinMaker アプリキットを使用している場合は、カスタムドメインも必ず追加してください。

  7. 次に、[アプリケーションインテグレーション管理] セクションを見つけると、[PME アプリケーションの一覧] が表示されているはずです。以下の情報を記録してください。

    • [クライアントID]

    • クライアントシークレット

    注記

    [クライアントシークレット] は一度しか表示されないため、[クライアントシークレット] を記録することを強くお勧めします。Matterport インテグレーションを続行するには、 AWS Secrets Manager コンソールで [クライアントシークレット] を提示する必要があります。

    これらの認証情報は、必要なコンポーネントを購入し、アカウントの PME が Matterport によって有効化された時点で自動的に作成されます。これらの認証情報が表示されない場合は、Matterport にお問い合わせください。お問い合わせは、[Matterport および AWS IoT TwinMaker] お問い合わせフォームを参照してください。

Matterport SDK 認証情報について詳しくは、Matterport の公式 SDK ドキュメントの「SDK ドキュメントの概要」を参照してください。

Matterport 認証情報を に保存する AWS Secrets Manager

Matterport 認証情報を に保存するには、次の手順に従います AWS Secrets Manager。

注記

Matterport インテグレーションを続行するには、Matterport の認証情報を生成して記録してください トピックの手順で作成した [クライアントシークレット] が必要です。

  1. AWS Secrets Manager コンソールにログインします。

  2. [シークレット] ページに移動し、[新しいシークレットを保存] を選択します。

  3. [シークレットタイプの選択] で、[他の種類のシークレット] を選択します。

  4. [キー/値ペア] セクションで、Matterport の認証情報を値として、以下のキーと値のペアを追加します。

    • [キー:] application_key と [値:] <Matterport 認証情報>を使用してキーと値のペアを作成します。

    • [キー:] client_id と [値:] <Matterport 認証情報>を使用してキーと値のペアを作成します。

    • [キー:] client_secret と [値:] <Matterport 認証情報>を使用してキーと値のペアを作成します。

    完了したら、以下の例のような設定になっているはずです。

    インテグレーションプロセスで使用される Matterport 認証情報を一覧表示する、必要なキーと値のペア。

  5. [暗号化キー] については、デフォルトの暗号化キー aws/secretsmanager を選択したままにしておくことができます。

  6. [次へ] を選択して [シークレットの設定] ページに進みます。

  7. [シークレット名] と [説明] のフィールドに入力します。

  8. [タグ] セクションで、このシークレットにタグを追加します。

    タグを作成するときは、次のスクリーンショットAWSIoTTwinMaker_Matterportに示すようにキーを割り当てます。

    タグキーを入力したシークレットコンソールの設定ページ。
    注記

    タグを追加する必要があります。[タグ] はオプションとして記載されていますが、サードパーティシークレットを AWS Secrets Managerに追加する場合はタグが必要です。

    「値」フィールドはオプションです。[キー] を入力したら、[追加] を選択して次のステップに進むことができます。

  9. [次へ] を選択して、[ローテーションの設定] ページに進みます。シークレットローテーションの設定は任意です。シークレットの追加を完了したいが、ローテーションは必要ない場合は、もう一度 [次へ] を選択してください。シークレットのローテーションの詳細については、「シークAWS Secrets Manager レットのローテーション」を参照してください。

  10. [レビュー] ページでシークレットの設定を確認します。シークレットを追加する準備ができたら、[保存] を選択します。

の使用の詳細については AWS Secrets Manager、次の AWS Secrets Manager ドキュメントを参照してください。

これで Matterport アセットを AWS IoT TwinMaker シーンにインポートする準備が整いました。次のセクション「Matterport スペースを AWS IoT TwinMaker シーンにインポートする」の手順を参照してください

Matterport スペースを AWS IoT TwinMaker シーンにインポートする

シーン設定ページから接続された Matterport アカウントを選択し、シーンに Matterport スキャンを追加してくます。次の手順に従って、Matterport のスキャンとタグをインポートします。

  1. AWS IoT TwinMaker コンソールにログインします。

  2. Matterport スペースを使用する既存の AWS IoT TwinMaker シーンを作成または開きます。

  3. シーンが開いたら、[設定] タブに移動します。

  4. [設定] の [サードパーティリソース] で、[接続名] を探し、Matterport 認証情報を に保存する AWS Secrets Manager の手順で作成したシークレットを入力します。

    Matterport SDK 認証情報をシークレットとして保存した後の設定タブの内容。
    注記

    [接続なし] というメッセージが表示された場合は、AWS IoT TwinMaker コンソール設定ページに移動して Matterport インテグレーションのプロセスを開始してください。

    「接続なし」メッセージを含む設定タブ。

  5. 次に、シーンで使用したい Matterport スペースを [Matterport スペース] ドロップダウンから選択します。

    Matterport スペースドロップダウンが表示された設定タブ。

  6. スペースを選択したら、Matterport タグをインポートし、タグのインポートボタンを押して AWS IoT TwinMaker シーンタグに変換できます。

    タグのインポートボタンが表示された設定タブ。

    Matterport タグをインポートすると、ボタンは [タグの更新] ボタンに置き換わります。Matterport タグを で継続的に更新 AWS IoT TwinMaker して、Matterport アカウントの最新の変更を常に反映させることができます。

    タグの更新ボタンが表示された設定タブ。

  7. Matterport AWS IoT TwinMaker との統合が正常に完了し、 AWS IoT TwinMaker シーンにインポートした Matterport スペースとタグの両方が追加されました。このシーンは、他の AWS IoT TwinMaker シーンと同じように操作できます。

AWS IoT TwinMaker シーンの操作の詳細については、AWS IoT TwinMaker 「シーンの作成と編集」を参照してください。

Grafana ダッシュボードで Matterport AWS IoT TwinMaker スペースを使用する

Matterport スペースを AWS IoT TwinMaker シーンにインポートしたら、Grafana ダッシュボードの Matterport スペースを使用してそのシーンを表示できます。で Grafana を既に設定している場合は AWS IoT TwinMaker、Grafana ダッシュボードを開くだけで、インポートされた Matterport スペースでシーンを表示できます。

Grafana AWS IoT TwinMaker をまだ設定していない場合は、まず Grafana 統合プロセスを完了します。Grafana AWS IoT TwinMaker と統合する場合、2 つの選択肢があります。セルフマネージド Grafana インスタンスを使用することも、Amazon Managed Grafana を使用することもできます。

Grafana のオプションとインテグレーションプロセスの詳細については、以下のドキュメントを参照してください。

AWS IoT TwinMaker ウェブアプリケーションで Matterport スペースを使用する

Matterport スペースを AWS IoT TwinMaker シーンにインポートしたら、 AWS IoT アプリキットウェブアプリケーションの Matterport スペースを使用してそのシーンを表示できます。

AWS IoT アプリケーションキットの使用の詳細については、次のドキュメントを参照してください。