Exercício - Conecte-se à API REST do Azure Digital Twins para resolver alertas

  • 8 minutos

Em condições reais, as operações dos parques eólicos não são contínuas. Às vezes, os ativos da turbina experimentam anomalias que podem exceder os limites operacionais. Nessas circunstâncias, os ativos da turbina enviam um sinal de alerta que os operadores e engenheiros recebem, analisam e tomam medidas. Para resolver um alerta de ativo de turbina nos Gêmeos Digitais do Azure a partir do aplicativo de realidade mista, envie solicitações para a API REST dos Gêmeos Digitais do Azure.

Para fazer solicitações à API REST, você precisa autenticar. No contexto deste módulo de aprendizagem, você se autentica usando credenciais de aplicativo correspondentes a um Registro de Aplicativo. Essas credenciais representam um aplicativo, não um indivíduo, e precisam ser copiadas para o projeto Unity. Quando o aplicativo é criado, essas credenciais são compiladas diretamente no aplicativo. Não recomendamos essa abordagem de autenticação para sistemas de produção porque ela não exige que o usuário faça login. Como tal, não impede o acesso não autorizado de utilizadores. Use esta abordagem por uma questão de simplicidade neste módulo de aprendizagem.

O modelo ARM, entre outras coisas, cria o registro de aplicativo necessário. Como parte da saída, você criou os arquivos de texto AppCredentials.txt e Azure_config_settings.txt que contêm variáveis importantes necessárias para configurar os objetos programáveis Unity. Use estes mapeamentos de variáveis para inserir os valores em Unity:

Azure_config_settings.txt Unity
adtHostName URL da instância do Adt
AppCredentials.txt Unity
appId ID de Cliente
password Segredo do Cliente
tenant ID de Inquilino

Essas credenciais e URL precisam ser transferidas para seu projeto Unity para que seu aplicativo possa se autenticar e interagir com os Gêmeos Digitais do Azure. Especificamente, você precisa atribuir esses valores a um objeto programável no projeto e fazer referência a esse ScriptableObject de um específico GameObject na cena.

Adicionar credenciais do Azure Digital Twins

  1. Navegue até a pasta Credenciais no painel do projeto Unity: Assets>ScriptableObjects>AzureDigitalTwin>Credentials.

  2. Crie um objeto programável para as credenciais selecionando Assets>Create>ScriptableObjects>Credentials>ADT Rest API Credentials.

    Captura de tela do menu de ativos Unity aberto mostrando a seleção do menu Create > ScriptableObjects > Credentials > ADT Rest API Credentials.

  3. Selecione o objeto programável recém-criado no painel do projeto para ver seus parâmetros de configuração no painel Inspetor . Transfira os valores com base no mapeamento de variáveis na seção anterior do arquivo AppCredentials.txt.

    Captura de tela das credenciais da API REST do ADT no Inspetor.

Adicionar controlador de alerta de turbina

Para adicionar o controlador de alerta da turbina à sua cena e autenticar:

  1. O ADTTurbineAlertController altera a propriedade Alert no gêmeo digital para uma turbina específica. Depois que essa propriedade tiver sido alterada no Azure Digital Twins, o pré-fabricado ADTConnection receberá uma notificação e atualizará um valor de Alerta correspondente localmente.

  2. Arraste o ADTPrefabs>>ADTTurbineAlertController de ativos do painel Projeto para o painel Hierarquia na parte inferior da lista.

    Captura de tela dos objetos pré-fabricados do ADT no painel do projeto Unity.

    Captura de tela dos objetos pré-fabricados do ADT adicionados ao painel de hierarquia Unity.

  3. No Inspetor, localize o componente ADT Turbine Alert Controller (Script). Selecione o ícone circular dentro da caixa de valor para o campo chamado Adt Connection Info.

    Captura de tela do controlador de alerta da turbina ADT no inspetor Unity.

  4. Selecione a propriedade Adt Connection Info e atribua o objeto programável ADTRestAPICredentials .

    Captura de tela do objeto programável ADT Rest API Credentials na pasta de ativos Unity.

  5. Salve seu arquivo com Salvar arquivo>.