Упражнение — подключение к 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 Unity
adtHostName URL-адрес Adt экземпляра
AppCredentials.txt Unity
appId ИД клиента
password Секрет клиента
tenant Идентификатор клиента

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

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

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

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

    Снимок экрана: меню

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

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

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

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

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

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

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

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

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

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

  4. Выберите свойство сведения о подключении ADT и назначьте объект ADTRestAPICredentials с помощью скрипта.

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

  5. Сохраните файл с помощью сохранения файлов>.