Упражнение — подключение к REST API Azure Digital Twins для разрешения предупреждений

  • 8 мин

В реальных условиях операции ветряной фермы не являются непрерывными. Иногда ресурсы турбины испытывают аномалии, которые могут превышать операционные пороговые значения. В этих условиях ресурсы турбины отправляют сигнал оповещения о том, что операторы и инженеры получают, анализируют и принимают меры. Чтобы устранить оповещение о ресурсах турбины в Azure Digital Twins из приложения смешанной реальности, отправьте запросы в REST API Azure Digital Twins.

Чтобы выполнить запросы к REST API, необходимо выполнить проверку подлинности. В контексте этого модуля обучения вы проходите проверку подлинности с помощью учетных данных приложения, соответствующих регистрации приложений. Эти учетные данные представляют собой приложение, а не отдельное лицо и должны быть скопированы в проект Unity. Когда создается приложение, эти учетные данные компилируются непосредственно в приложение. Мы не рекомендуем использовать этот подход к проверке подлинности для рабочих систем, так как для входа не требуется. Таким образом, он не предотвращает несанкционированный доступ пользователей. Используйте этот подход для простоты в этом модуле обучения.

Шаблон ARM, помимо прочего, создает необходимую регистрацию приложения. В рамках выходных данных вы создали AppCredentials.txt и Azure_config_settings.txt текстовые файлы, содержащие важные переменные, необходимые для настройки объектов скриптов Unity. Используйте эти сопоставления переменных для ввода значений в Unity:

Azure_config_settings.txt Единство
Имя хоста adt URL-адрес Adt экземпляра
AppCredentials.txt Единство
appId (идентификатор приложения) ИД клиента
пароль Секрет клиента
арендатор Идентификатор клиента

Эти учетные данные и URL-адрес необходимо передать в проект Unity, чтобы приложение удостоверялось и взаимодействовать с Azure Digital Twins. В частности, необходимо назначить эти значения объекту скрипта в проекте и ссылаться на них ScriptableObject из конкретного GameObject объекта в сцене.

Добавление учетных данных Azure Digital Twins

  1. Перейдите в папку Credentials на панели проекта Unity: Assets>ScriptableObjects>AzureDigitalTwin>Credentials.

  2. Создайте скриптовый объект для учетных данных, выбрав Assets>Create>ScriptableObjects>Credentials>ADT Rest API Credentials.

    Снимок экрана с открытым меню ресурсов Unity, показывающим выбор в

  3. Выберите созданный объект скрипта на панели проекта, чтобы просмотреть параметры конфигурации на панели инспектора. Передайте значения на основе сопоставления переменных в предыдущем разделе из файла AppCredentials.txt .

    Снимок экрана: учетные данные REST API ADT в инспекторе.

Добавление контроллера оповещений турбины

Чтобы добавить контроллер оповещений турбины на сцену и пройти проверку подлинности:

  1. Изменяет ADTTurbineAlertController свойство Alert для цифрового двойника для конкретной турбины. После изменения этого свойства в Azure Digital Twins префаб ADTConnection получает уведомление и обновляет соответствующее значение оповещения локально.

  2. Перетащите Assets>ADTPrefabs>ADTTurbineAlertController из панели «Проект» на панель «Иерархия» в нижней части списка.

    Снимок экрана объектов префабов ADT на панели проекта Unity.

    Снимок экрана объектов префабов ADT, добавленных в панель иерархии Unity.

  3. В инспекторе найдите компонент контроллера оповещений о турбине ADT (скрипт ). Щелкните круглый значок в поле значений под названием Adt Connection Info.

    Скриншот контроллера предупреждений турбины ADT в Unity Inspector.

  4. Выберите свойство Adt Connection Info и назначьте скриптовый объект ADTRestAPICredentials.

    Скриншот скриптового объекта ADT REST API Credentials в папке активов Unity.

  5. Сохраните файл, используя Файл>Сохранить.