Cvičení – připojení k rozhraní REST API služby Azure Digital Twins za účelem řešení výstrah

  • 8 min

V reálných podmínkách nejsou provoz větrné farmy nepřetržitý. V některých případech mají prostředky turbíny anomálie, které by mohly překročit provozní prahové hodnoty. Za těchto okolností zařízení turbíny odesílají signál výstrahy, který operátoři a inženýři přijímají, analyzují a podniknou akci. Pokud chcete vyřešit výstrahu prostředku turbíny ve službě Azure Digital Twins z aplikace hybridní reality, odešlete požadavky do rozhraní REST API služby Azure Digital Twins.

Pokud chcete provádět požadavky na rozhraní REST API, musíte provést ověření. V kontextu tohoto výukového modulu se ověřujete pomocí přihlašovacích údajů aplikace odpovídajících registraci aplikace. Tyto přihlašovací údaje představují aplikaci, nikoli jednotlivec, a je potřeba je zkopírovat do projektu Unity. Po sestavení aplikace se tyto přihlašovací údaje kompilují přímo do aplikace. Tento přístup k ověřování pro produkční systémy nedoporučujeme, protože nevyžaduje, aby se uživatel přihlásil. Proto nezabrání neoprávněnému přístupu uživatelů. Tento přístup použijte pro jednoduchost v tomto výukovém modulu.

Šablona ARM mimo jiné vytvoří požadovanou registraci aplikace. Jako součást výstupu jste vytvořili AppCredentials.txt a Azure_config_settings.txt textové soubory, které obsahují důležité proměnné potřebné ke konfiguraci skriptovatelných objektů Unity. Pomocí těchto mapování proměnných zadejte hodnoty do Unity:

Azure_config_settings.txt Unity
adtHostName Adt Instance URL
AppCredentials.txt Unity
appId ID klienta
Heslo Tajný klíč klienta
klient ID tenanta

Tyto přihlašovací údaje a adresu URL je potřeba přenést do projektu Unity, aby se vaše aplikace mohly ověřovat a pracovat s Azure Digital Twins. Konkrétně je potřeba přiřadit tyto hodnoty skriptovatelnému objektu v projektu a odkazovat na tyto ScriptableObject hodnoty z konkrétní GameObject scény.

Přidání přihlašovacích údajů služby Azure Digital Twins

  1. Přejděte do složky Přihlašovací údaje na panelu projektu Unity: Assets>ScriptableObjects>Credentials.

  2. Vytvořte skriptovatelný objekt pro přihlašovací údaje výběrem prostředků>Create>ScriptableObjects>Credentials ADT Rest API Credentials.>

    Snímek obrazovky s otevřenou nabídkou prostředků Unity s výběrem nabídky Vytvořit > scriptableObjects > Credentials > ADT Rest API Credentials

  3. Výběrem nově vytvořeného skriptovatelného objektu na panelu projektu zobrazíte jeho konfigurační parametry na panelu inspektoru. Přeneste hodnoty na základě mapování proměnných v předchozí části ze souboru AppCredentials.txt .

    Snímek obrazovky s přihlašovacími údaji rozhraní REST API SLUŽBY ADT v inspektoru

Přidání kontroleru upozornění turbíny

Přidání kontroleru upozornění turbíny do scény a ověření:

  1. Změní ADTTurbineAlertController vlastnost Výstraha u digitálního dvojčete pro konkrétní turbínu. Po změně této vlastnosti ve službě Azure Digital Twins obdrží prefab služby ADTConnection oznámení a aktualizuje odpovídající hodnotu výstrahy místně.

  2. Přetáhněte prostředky>ADTPrefabs>ADTTurbineAlertController z panelu Projektu na panel Hierarchie v dolní části seznamu.

    Snímek obrazovky s objekty předfabem ADT na panelu projektu Unity

    Snímek obrazovky s objekty předfabem ADT přidané na panel hierarchie Unity

  3. V inspektoru najděte komponentu ADT Turbine Alert Controller (Script). Vyberte kruhovou ikonu uvnitř pole hodnoty pro pole s názvem Adt Connection Info( Informace o připojení Adt).

    Snímek obrazovky s kontrolerem upozornění turbíny ADT v inspektoru Unity

  4. Vyberte vlastnost Adt Connection Info a přiřaďte objekt ADTRestAPICredentials scriptable objekt.

    Snímek obrazovky se skriptovatelným objektem přihlašovacích údajů rozhraní ADT REST API ve složce assetů Unity

  5. Uložte soubor pomocí možnosti Uložit>.