Guia de Início Rápido – Introdução ao 3D Scenes (versão prévia) Studio para Gêmeos Digitais do Azure

O 3D Scenes Studio (versão prévia) dos Gêmeos Digitais do Azure é um ambiente 3D imersivo, em que os funcionários de negócios e da linha de frente podem consumir e investigar dados operacionais das soluções dos Gêmeos Digitais do Azure com contexto visual.

Neste artigo, você vai configurar todos os recursos necessários para usar o 3D Scenes Studio, incluindo uma instância dos Gêmeos Digitais do Azure usando dados de exemplo e recursos de armazenamento do Azure. Depois, você vai criar uma cena no estúdio conectada ao ambiente de exemplo dos Gêmeos Digitais do Azure.

Essa cena de exemplo usada neste guia de início rápido monitora a eficiência do transporte de braços robóticos em uma fábrica. Os braços robóticos pegam um certo número de caixas por hora, enquanto câmeras de vídeo monitoram cada braço para detectar se ele não conseguiu pegar alguma caixa. Cada braço tem um gêmeo digital associado nos Gêmeos Digitais do Azure, e os gêmeos digitais são atualizados com novos dados sempre que um braço perde uma caixa. Considerando esse cenário, este guia de início rápido percorre a configuração de uma cena 3D para visualizar os braços na fábrica, juntamente com alertas visuais sempre que uma caixa é perdida.

A cena terá esta aparência:

Pré-requisitos

Você precisará de uma assinatura do Azure para concluir este guia de início rápido. Se não tiver uma, crie-a gratuitamente agora mesmo.

Você também precisará baixar um arquivo 3D gITF (Graphics Language Transmission Format) de exemplo a ser usado na cena neste guia de início rápido. Baixe o seguinte arquivo de exemplo do GitHub: RobotArms.glb.

Configurar os Gêmeos Digitais do Azure e os dados de exemplo

A primeira etapa para trabalhar com os Gêmeos Digitais do Azure é criar uma instância dos Gêmeos Digitais do Azure. Depois de criar uma instância do serviço, você poderá vincular a instância a uma visualização do 3D Scenes Studio mais tarde no guia de início rápido.

O restante desta seção demonstra como criar a instância. Se você já tem uma instância dos Gêmeos Digitais do Azure que foi configurada em algum guia de início rápido anterior, pule para a próxima seção.

Criar uma instância dos Gêmeos Digitais do Azure

Nesta seção, você criará uma instância dos Gêmeos Digitais do Azure usando o portal do Azure. Navegue até o portal, depois entre com suas credenciais.

1. Após entrar no portal, comece clicando em Criar um recurso no menu da home page de serviços do Azure.

   

2. Pesquise os gêmeos digitais do azure na caixa de pesquisa, depois escolha o serviço dos Gêmeos Digitais do Azure nos resultados.

   Deixe o campo Plano definido como Gêmeos Digitais do Azure selecione o botão Criar para começar a criar uma nova instância do serviço.

   

3. Preencha os campos na guia Noções básicas da instalação, incluindo Assinatura, Grupo de recursos,um Nome de recurso para a nova instância e região. Marque a caixa Atribuir a Função de Proprietário de Dados dos Gêmeos Digitais do Azure para se dar permissões para gerenciar dados na instância.

   

   Observação

   Se a caixa Atribuir Função de Proprietário de Dados dos Gêmeos Digitais do Azure estiver acinzentada, significará que você não tem permissões em sua assinatura do Azure para gerenciar o acesso do usuário aos recursos. Você pode continuar criando a instância nesta seção e então fazer com que alguém com as permissões necessárias atribua essa função a você na instância antes da conclusão do restante deste início rápido.

   Funções comuns que atendem a esse requisito são Proprietário, Administrador da conta ou a combinação de Colaborador e Administrador de Acesso do Usuário.

4. Selecione Revisar + Criar para concluir a criação da sua instância.

5. Você verá uma página de resumo mostrando os detalhes inseridos. Confirme e crie a instância selecionando Criar.

Isso levará você até a página de Visão geral do status de implantação de acompanhamento da instância.

Aguarde até que a página diga que a implantação foi concluída.

Coletar o nome do host

Após a conclusão da implantação, use o botão Ir para o recurso para navegar até a página Visão geral da instância no portal.

Depois, anote o valor do nome do host da instância, que será usado mais tarde.

Gerar modelos e gêmeos de exemplo

Nesta seção, você usará a ferramenta simulador de dados dos Gêmeos Digitais do Azure para gerar modelos e gêmeos de exemplo a fim de popular sua instância. Depois, você usará o simulador para transmitir os dados de exemplo aos gêmeos no grafo.

Observação

Modelos, gêmeos e dados simulados são fornecidos para você neste guia de início rápido para simplificar o processo de criação de um ambiente que possa exibido no 3D Scenes Studio. Ao desenvolver a sua solução completa dos Gêmeos Digitais do Azure, você mesmo vai criar modelos e gêmeos para descrever o ambiente em detalhes e configurar os seus fluxos de dados, conforme o necessário.

Este cenário de exemplo representa um centro de distribuição de pacotes que contém seis braços robóticos. Cada braço tem um gêmeo digital com propriedades para rastrear quantas caixas o braço não consegue pegar, juntamente com as IDs das caixas perdidas.

1. Navegue até o simulador de dados no navegador da Web.

2. No espaço da URL da Instância, insira o nome do host da instância dos Gêmeos Digitais do Azure da seção anterior. Defina o Tipo de simulação como Braços de robô.

3. Use o botão Gerar ambiente para criar um ambiente de exemplo com modelos e gêmeos. (Se você já tiver modelos e gêmeos na instância, eles não serão excluídos e os novos serão adicionados.)

   

4. Role para baixo e selecione Iniciar simulação para começar a enviar dados simulados à instância dos Gêmeos Digitais do Azure. A simulação só será executada enquanto esta janela estiver aberta e a opção Iniciar simulação estiver ativa.

Veja os modelos e o grafo que foram criados usando a ferramenta Graph do Azure Digital Twins Explorer. Para acessar essa ferramenta, selecione o ícone Graph no menu à esquerda.

Depois, use o botão Executar Consulta para consultar todos os gêmeos e as relações que foram criados na instância.

Você pode selecionar cada gêmeo para vê-lo com mais detalhes.

Para ver os modelos que foram carregados e como eles se relacionam entre si, selecione Grafo de modelo.

Dica

Para obter uma introdução ao Azure Digital Twins Explorer, confira o guia de início rápido Introdução ao Azure Digital Twins Explorer.

Criar recursos de armazenamento

Agora, você vai criar uma conta de armazenamento e um contêiner na conta de armazenamento. O 3D Scenes Studio usará esse contêiner de armazenamento para armazenar o arquivo 3D e as informações de configuração.

Você também vai configurar permissões de leitura e gravação na conta de armazenamento. Para definir esses recursos de backup rapidamente, esta seção usa o Azure Cloud Shell.

1. Navegue até o Cloud Shell no navegador.

   Execute o comando a seguir para definir o contexto da CLI para a assinatura desta sessão.

   az account set --subscription "<your-Azure-subscription-ID>"
   

2. Execute o comando a seguir para criar a conta de armazenamento na assinatura. O comando contém espaços reservados para você inserir um nome e escolher uma região para sua conta de armazenamento, bem como um espaço reservado para seu grupo de recursos.

   az storage account create --resource-group <your-resource-group> --name <name-for-your-storage-account> --location <region> --sku Standard_RAGRS
   

   Quando o comando for concluído com êxito, você verá detalhes da nova conta de armazenamento na saída. Procure o valor ID na saída e copie-o para usar no próximo comando.

   

3. Execute o comando a seguir para conceder a você o acesso de Proprietário de dados do armazenamento de blobs na conta de armazenamento. Esse nível de acesso permitirá que você execute operações de leitura e gravação no 3D Scenes Studio. O comando contém espaços reservados para o email associado à sua conta do Azure e a ID da sua conta de armazenamento que você copiou na etapa anterior.

   az role assignment create --role "Storage Blob Data Owner" --assignee <your-Azure-email> --scope <ID-of-your-storage-account>
   

   Quando o comando for concluído com êxito, você verá detalhes da atribuição de função na saída.

4. Execute o comando a seguir para configurar o CORS para sua conta de armazenamento. Isso será necessário para que o 3D Scenes Studio acesse o contêiner de armazenamento. O comando contém um espaço reservado para o nome da sua conta de armazenamento.

   az storage cors add --services b --methods GET OPTIONS POST PUT --origins https://explorer.digitaltwins.azure.net --allowed-headers Authorization x-ms-version x-ms-blob-type --account-name <your-storage-account>
   

   Esse comando não tem nenhuma saída.

5. Execute o seguinte comando para criar um contêiner particular na conta de armazenamento. Seus arquivos do 3D Scenes Studio serão armazenados aqui. O comando contém um espaço reservado para você inserir um nome para o contêiner de armazenamento e um espaço reservado para o nome da sua conta de armazenamento.

   az storage container create --name <name-for-your-container> --public-access off --account-name <your-storage-account>
   

   Quando o comando for concluído com êxito, a saída exibirá "created": true.

Inicializar o ambiente do 3D Scenes Studio

Agora que todos os recursos estão configurados, você poderá usá-los para criar um ambiente no 3D Scenes Studio. Nesta seção, você criará uma cena e a personalizará para o grafo de exemplo que está na instância dos Gêmeos Digitais do Azure.

1. Navegue até o 3D Scenes Studio. O estúdio será aberto, conectado à instância dos Gêmeos Digitais do Azure que você acessou por último no Azure Digital Twins Explorer. Ignore a demonstração de boas-vindas.

   

2. Selecione o ícone Editar ao lado do nome da instância para configurar os detalhes da instância e do contêiner de armazenamento.

   

   1. Para a URL da instância dos Gêmeos Digitais do Azure, preencha o nome do host da instância da etapa Coletar nome do host nesta URL: https://<your-instance-host-name>.

   2. Para a URL da conta do Armazenamento do Azure, preencha o nome da sua conta de armazenamento na etapa Criar recursos de armazenamento nesta URL: https://<your-storage-account>.blob.core.windows.net.

   3. Para o nome do contêiner do Armazenamento do Azure, insira o nome do contêiner de armazenamento na etapa Criar recursos de armazenamento.

   4. Selecione Salvar.

   

Adicionar uma nova cena 3D

Nesta seção, você criará uma cena 3D usando o arquivo de modelo 3D RobotArms.glb que baixou em Pré-requisitos. Uma cena consiste em um arquivo de modelo 3D e um arquivo de configuração que é criado automaticamente.

Esta cena de exemplo contém uma visualização do centro de distribuição e seus braços. Você vai conectar essa visualização aos gêmeos de exemplo criados na etapa Gerar modelos e gêmeos de exemplo e personalizar a exibição controlada por dados em etapas posteriores.

1. Selecione o botão Adicionar cena 3D para começar a criar uma cena. Insira um nome e uma descrição para sua cena e selecione Carregar arquivo.

   

2. Procure o arquivo RobotArms.glb no computador e abra-o. Selecione Criar.

   

   Depois que o arquivo for carregado, ele será listado na tela principal do 3D Scenes Studio.

3. Selecione a cena que será aberta e exibida. A cena será aberta no modo Criação.

   

Criar um elemento de cena

Agora, você vai definir um elemento na visualização 3D e o vincular a um gêmeo no grafo dos Gêmeos Digitais do Azure que já configurou.

1. Selecione qualquer braço robótico na visualização da cena. Serão mostradas as possíveis ações do elemento. Selecione + Criar elemento.

   

2. No painel Novo elemento, a lista suspensa Gêmeo primário contém os nomes de todos os gêmeos na instância conectada dos Gêmeos Digitais do Azure.

   1. Selecione Arm1. A ID do gêmeo digital ($dtId) será aplicada automaticamente como o nome do elemento.

   2. Selecione Criar elemento.

   

Agora, o elemento aparecerá na lista de elementos da cena.

Criar um comportamento

Agora, você vai criar um comportamento para o elemento. Esses comportamentos permitem personalizar os visuais de dados do elemento e a lógica de negócios associada. Depois, você poderá explorar esses visuais de dados para entender o estado do ambiente físico.

1. Mude para a lista Comportamentos e selecione Novo comportamento.

   

2. Em Nome de exibição, insira Eficiência da Linha de Empacotamento. Em Elementos, selecione Arm1.

   

3. Ignore a guia Gêmeos, que não é usada neste início rápido.

4. Regras visuais: as regras visuais são sobreposições controladas por dados em seus elementos que você pode configurar para indicar a integridade ou o status do elemento.

   1. Primeiro, você definirá algumas condições para indicar a eficiência da linha de empacotamento.

      1. Selecione Adicionar Regra.

         

      2. Insira um Nome de exibição de Retiradas por hora. Deixe a Expressão de propriedade em Propriedade individual e abra a lista suspensa de propriedades. Essa lista contém os nomes de todas as propriedades no gêmeo primário do elemento Arm1. Selecione PrimaryTwin.FailedPickupsLastHr. Depois, selecione Adicionar condição.

         

      3. Em seguida, você definirá alguns limites para indicar quando as retiradas por hora estiverem com muitos pacotes faltando. Para esse cenário, digamos que um ARM precise de atenção se perder mais de três retiradas em uma hora. Rotule a condição >3 retiradas perdidas e defina um intervalo de valor entre 4 e Infinito (o valor de intervalo mínimo é inclusivo e o valor máximo é exclusivo). Atribua um Elemento de coloração vermelho. Clique em Salvar.

         

      4. Selecione Adicionar condição novamente e crie uma condição rotulada como 1-3 retiradas perdidas. Defina um intervalo de valor entre 1 e 4 e atribua um Elemento coloração laranja. Salvar a condição.

         Selecione Adicionar condição mais uma vez e crie uma condição rotulada como 0 retiradas perdidas. Defina um intervalo de valor entre 0 e 1 e atribua um Elemento coloração verde. Salvar a condição.

         Depois de criar todas as três condições, Salve a nova regra visual.

         

   2. Em seguida, crie mais uma regra visual para exibir alertas para pacotes perdidos.

      1. Na guia Regras visuais, selecione Adicionar Regra novamente.

         

      2. Insira um Nome de exibição de PickupFailedAlert. Altere a Expressão de propriedade para Personalizada (avançado), insira uma propriedade de PrimaryTwin.PickupFailedAlert e defina o Tipo como booliano. Esta é uma propriedade booleana no ARM gêmeo que é definida como True quando uma retirada de pacote falha. Selecione Adicionar condição.

         

      3. Falha ao inserir um rótulo de ${PrimaryTwin.PickupFailedBoxID}. Posteriormente, na exibição da cena, isso exibirá dinamicamente o valor da propriedade de cadeia de caracteres PickupFailedBoxID do ARM gêmeo, que contém uma ID que representa a caixa que o ARM mais recentemente falhou na retirada. Defina o Valor como True e escolha um Tipo visual de Notificação. Defina a Cor como vermelho e escolha um Ícone. Clique em Salvar.

         

      Agora você deve ver as duas regras listadas na guia Regras visuais.

      

5. Mude para a guia Widgets. Os widgets são visuais controlados por dados que fornecem contexto e dados adicionais, para ajudar você a entender o cenário que o comportamento representa. Aqui, você vai adicionar dois widgets visuais para exibir informações de propriedade ao elemento de braço.

   1. Primeiro, crie um widget para exibir um medidor do valor de pressão hidráulica do braço.

      1. Selecione Adicionar widget.

         

         Na Biblioteca de widgets, selecione o widget Medidor e depois Adicionar widget.

      2. Nas opções do Novo widget, adicione o Nome de exibição da Pressão hidráulica, a Unidade de medidam/s e a Expressão de propriedade de propriedade individual PrimaryTwin.HydraulicPressure.

         Defina três intervalos de valores para que os valores de 0 a 40 apareçam em uma cor, de 40 a 80 apareçam em uma segunda cor e de 80 ao infinito apareçam em uma terceira cor (lembre-se de que o valor de intervalo mínimo é inclusivo e o valor máximo é exclusivo).

         

         Selecione Criar widget.

   2. Depois, crie um widget com um link para um streaming ao vivo da câmera do braço.

      1. Selecione Adicionar widget. Na Biblioteca de widgets, selecione o widget Link e depois Adicionar widget.

      2. Nas opções do Novo widget, insira o RótuloCâmera ao vivo do braço. Para a URL, você pode usar a URL de exemplo http://contoso.armstreams.com/${PrimaryTwin.$dtId}. Não há nenhuma câmera ao vivo hospedada na URL deste exemplo, mas o link representa onde o feed de vídeo pode ser hospedado em um cenário real.

      3. Selecione Criar widget.

         

6. As opções de comportamento agora estão concluídas. Salve o comportamento selecionando Criar comportamento.

   

O comportamento Eficiência da Linha de Empacotamento agora aparecerá na lista de comportamentos da cena.

Exibir cena

Até agora, você trabalhou com o 3D Scenes Studio no modo Criação. Agora, mude para o modo Exibição.

Na lista de Elementos, selecione o elemento Arm1 que você criou. A visualização será ampliada para mostrar o elemento visual e os comportamentos que você configurou para ele.

Aplicar comportamento a elementos adicionais

Às vezes, um ambiente pode conter vários elementos semelhantes, que devem ser exibidos da mesma forma na visualização (como os seis braços robôs diferentes neste exemplo). Agora que você já criou um comportamento para um braço e confirmou a aparência dele no visualizador, esta seção mostrará como adicionar o comportamento rapidamente a outros braços para que todos exibam o mesmo tipo de informação no visualizador.

1. Retorne ao modo Criação. Como você fez em Criar um elemento de cena, selecione um braço diferente na visualização e clique em Criar elemento.

2. Selecione o Gêmeo primário do Arm2 para o novo elemento, depois mude para a guia Comportamentos.

3. Selecione Adicionar comportamento. Escolha o comportamento Eficiência da Linha de Empacotamento que você criou neste guia de início rápido.

4. Selecione Criar elemento para concluir a criação do elemento de braço.

Mude para a guia Exibição para ver o comportamento funcionando no novo elemento de braço. Todas as informações selecionadas ao criar o comportamento agora estão disponíveis para os dois elementos de braço na cena.

Dica

Se desejar, você poderá repetir as etapas nesta seção para criar elementos para os quatro braços restantes e aplicar o comportamento a todos eles a fim de concluir a visualização.

Examinar e contextualizar aprendizados

Este guia de início rápido mostra como criar um painel imersivo para dados dos Gêmeos Digitais do Azure, compartilhá-lo com usuários finais e aumentar o acesso a insights importantes sobre seu ambiente do mundo real.

No guia de início rápido, você criou uma cena 3D de exemplo para representar um centro de distribuição de pacotes com braços robóticos que pegam pacotes. Essa visualização foi conectada a um grafo de gêmeo digital e você vinculou um braço na visualização ao próprio gêmeo digital específico que forneceu dados de backup. Você também criou um comportamento visual para mostrar informações importantes sobre esse braço na exibição da cena completa, incluindo quais caixas esse braço não pegou durante a última hora.

Neste guia de início rápido, os modelos e os gêmeos de exemplo do cenário de fábrica foram criados rapidamente para você usando o simulador de Dados dos Gêmeos Digitais do Azure. Ao usar os Gêmeos Digitais do Azure no seu ambiente, você criará os seus modelos e gêmeos para descrever com precisão os elementos do ambiente em detalhes. Este guia de início rápido também usou o simulador de dados para simular dados "dinâmicos" que geram atualizações de propriedade do gêmeo digital quando pacotes não são pegos. Ao usar os Gêmeos Digitais do Azure no seu ambiente, você vai configurar o processo de ingestão de dados dinâmicos de acordo com os sensores do seu ambiente.

Limpar os recursos

Para limpar os recursos após este guia de início rápido, escolha quais recursos dos Gêmeos Digitais do Azure você removerá considerando o que fará em seguida.

• Se planejar continuar com os tutoriais dos Gêmeos Digitais do Azure, você poderá reutilizar a instância neste início rápido para esses artigos e não precisará removê-la.

• Se você quiser continuar usando a instância dos Gêmeos Digitais do Azure deste artigo, mas limpar todos os seus modelos, gêmeos e relações, execute o seguinte comando da CLI az dt job deletion:

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  Se quiser apenas excluir alguns desses elementos, você poderá usar os comandos az dt twin relationship delete, az dt twin delete e az dt model delete para excluir seletivamente apenas os elementos que você deseja remover.

• Se você não precisar mais da instância dos Gêmeos Digitais do Azure, poderá excluí-la usando o portal do Azure.

  Navegue de volta para a página de Visão geral da instância no Portal. (Se você já fechou essa guia, pode encontrar a instância novamente pesquisando seu nome na barra de pesquisa portal do Azure e selecionando-a nos resultados da pesquisa.)

  Selecione excluir para excluir a instância, incluindo todos os seus modelos e gêmeos.

  

Você pode excluir os recursos de armazenamento acessando a página Visão geral da sua conta de armazenamento no portal do Azure e selecionando Excluir. Isso excluirá a conta de armazenamento e o contêiner que ela contém, juntamente com os arquivos de cena 3D no contêiner.

Você também pode excluir do computador local o arquivo 3D de exemplo que foi baixado.

Próximas etapas

Agora, continue com os tutoriais dos Gêmeos Digitais do Azure para desenvolver o seu ambiente dos Gêmeos Digitais do Azure.

Codificar um aplicativo cliente