演習 - アラートを解決するために Azure Digital Twins REST API に接続する

  • 8 分

実際の状況では、風力発電所は継続的には稼働しません。 タービン アセットで、稼働しきい値を超える異常が発生する場合もあります。 このような状況では、タービン アセットは、オペレーターとエンジニアが受信し、分析し、それに基づいて対応するアラート信号を送信します。 Mixed Reality アプリから Azure Digital Twins のタービン アセット アラートを解決するには、Azure Digital Twins REST API に要求を送信します。

REST API に要求を送信するには、認証する必要があります。 この学習モジュールのコンテキストでは、"アプリ登録" に対応するアプリ資格情報を使用して認証します。 これらの資格情報は、個人ではなくアプリを表し、Unity プロジェクトにコピーする必要があります。 アプリをビルドすると、これらの資格情報はアプリに直接コンパイルされます。 この方法は、ユーザーがサインインする必要がないため、運用システムの認証にはお勧めしません。 この方法では、承認されていないユーザーのアクセスを防げません。 この学習モジュールでは、わかりやすくするためにこの方法を使用します。

とりわけ、ARM テンプレートは必要なアプリ登録を作成します。 出力の一部として、Unity スクリプト可能オブジェクトの構成に必要な重要な変数を含む、AppCredentials.txt と Azure_config_settings.txt のテキスト ファイルを作成しました。 次の変数マッピングを使用して、Unity に値を入力します。

Azure_config_settings.txt Unity
adtHostName Adt Instance URL
AppCredentials.txt Unity
appId クライアント ID
password クライアント シークレット
tenant テナント ID

アプリが認証して Azure Digital Twins と対話できるように、これらの資格情報と URL を Unity プロジェクトに転送する必要があります。 具体的には、これらの値をプロジェクト内のスクリプト可能オブジェクトに割り当て、シーン内の特定の GameObject からその ScriptableObject を参照する必要があります。

Azure Digital Twins の資格情報を追加する

  1. Unity プロジェクト パネルで Credentials フォルダーに移動します。[アセット]>[ScriptableObjects]>[AzureDigitalTwin]>[Credentials]。

  2. 資格情報のスクリプト可能オブジェクトを作成するには、[アセット]>[作成]>[ScriptableObjects]>[資格情報]>[ADT Rest API 資格情報] を選択します。

    Screenshot of the Unity assets menu open showing Create > ScriptableObjects > Credentials > ADT Rest API Credentials menu selection.

  3. 新たに作成したスクリプト可能なオブジェクトを [プロジェクト] パネルで選択し、[インスペクター] パネルでそのオブジェクトの構成パラメーターを確認します。 上記の変数マッピングに基づいて、AppCredentials.txt ファイルから値を転送します。

    Screenshot of the ADT Rest API Credentials in the Inspector.

タービン アラート コントローラーを追加する

タービン アラート コントローラーをシーンに追加して認証するには:

  1. ADTTurbineAlertController は、特定のタービンのデジタル ツインのアラート プロパティを変更します。 このプロパティが Azure Digital Twins で変更されると、ADTConnection プレハブは通知を受信し、対応するアラート値をローカルで更新します。

  2. [アセット]>[ADTPrefabs]>[ADTTurbineAlertController] を [プロジェクト] パネルから一覧の下部にある [階層] パネルにドラッグします。

    Screenshot of the ADT prefab objects in the Unity project panel.

    Screenshot of the ADT prefab objects added to the Unity hierarchy panel.

  3. [インスペクター] で、ADT タービンアラート コントローラー (スクリプト) コンポーネントを探します。 [Adt 接続情報] という名前のフィールドの値ボックス内の円形アイコンを選択します。

    Screenshot of the ADT turbine alert controller in the Unity inspector.

  4. [Adt 接続情報] でプロパティを選択し、ADTRestAPICredentials スクリプト可能オブジェクトを割り当てます。

    Screenshot of the ADT Rest API Credentials scriptable object in the Unity assets folder.

  5. [ファイル]>[保存] でファイルを保存します。