Início Rápido - Comece com o 3D Scenes Studio (visualização) para Azure Digital Twins

O Azure Digital Twins 3D Scenes Studio (pré-visualização) é um ambiente 3D imersivo, onde os trabalhadores empresariais e da linha da frente podem consumir e investigar dados operacionais das suas soluções Azure Digital Twins com contexto visual.

Neste artigo, você configura todos os recursos necessários para usar o 3D Scenes Studio, incluindo uma instância do Azure Digital Twins com dados de exemplo e recursos de armazenamento do Azure. Em seguida, você cria uma cena no estúdio que se conecta ao ambiente de exemplo do Azure Digital Twins.

Esta cena de exemplo usada neste guia de início rápido monitora a eficiência de transporte de braços robóticos em uma fábrica. Os braços robóticos pegam algumas caixas a cada hora, enquanto câmeras de vídeo monitoram cada um dos braços para detetar se o braço não conseguiu pegar uma 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 dados sempre que um braço perde uma caixa. Dado 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 cada vez que uma caixa é perdida.

A cena tem esta aparência:

Pré-requisitos

Você precisa de uma assinatura do Azure para concluir este início rápido. Se você ainda não tem um, crie um gratuitamente agora.

Você também precisa baixar um exemplo de arquivo 3D glTF (Graphics Language Transmission Format) para usar na cena neste início rápido. Baixe o seguinte arquivo de exemplo do GitHub: RobotArms.glb.

Configurar Azure Digital Twins e 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ê pode vincular a instância a uma visualização do 3D Scenes Studio posteriormente no início rápido.

O restante desta seção orienta você pela criação da instância. Se você já tiver uma instância do Azure Digital Twins configurada a partir de um início rápido anterior, poderá pular para a próxima seção.

Criar uma instância do Azure Digital Twins

Nesta seção, cria-se uma nova instância de Azure Digital Twins usando o portal Azure. Navegue até ao portal e inicie sessão com as suas credenciais.

1. Uma vez no portal, comece selecionando Criar um recurso no menu da home page dos serviços do Azure.

   

2. Pesquise Azure Digital Twins na caixa de pesquisa e escolha o serviço Azure Digital Twins nos resultados.

   Deixe o campo Plano definido como Azure Digital Twins e 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 sua assinatura, grupo de recursos, um nome de recurso para sua nova instância e região. Marque a caixa Atribuir Função de Proprietário de Dados do Azure Digital Twins para conceder a si mesmo permissões para gerenciar dados na instância.

   

   Observação

   Se a caixa Atribuir Função de Proprietário de Dados do Azure Digital Twins estiver acinzentada, isso significa 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, em seguida, deve ter alguém com as permissões necessárias para lhe atribuir essa função na instância antes de concluir o restante deste início rápido.

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

4. Selecione Rever e criar para concluir a criação da instância.

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

Essa ação leva você a uma página Visão geral que acompanha o status de implantação da instância.

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

Coletar 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.

Em seguida, anote o valor do nome do host da instância para usar mais tarde.

Gerar modelos de amostra e gêmeos

Nesta seção, você usa a ferramenta de simulador de dados do Azure Digital Twins para gerar modelos de exemplo e gêmeos para preencher sua instância. Em seguida, você usa o simulador para transmitir dados de amostra para os gêmeos no gráfico.

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 os IDs das caixas perdidas.

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

2. No espaço URL da instância , insira o nome do host da sua instância do Azure Digital Twins na seção anterior. Defina o tipo de simulação como Braços robóticos.

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 em sua instância, essa ação não os exclui, apenas adicionará mais.)

   

4. Role para baixo e selecione Iniciar simulação para começar a enviar dados simulados para sua instância do Azure Digital Twins. A simulação é executada enquanto esta janela está aberta e a opção Iniciar simulação está ativa.

Você pode exibir os modelos e o gráfico criados usando a ferramenta Azure Digital Twins Explorer Graph . Para alternar para essa ferramenta, selecione o ícone Gráfico no menu à esquerda.

Em seguida, use o botão Executar consulta para consultar todos os gêmeos e relacionamentos criados na instância.

Você pode selecionar cada gêmeo para visualizá-los com mais detalhes.

Para ver os modelos que são carregados e como eles se relacionam entre si, selecione Gráfico de modelo.

Criar recursos de armazenamento

Em seguida, crie uma nova conta de armazenamento e um contêiner na conta de armazenamento. O 3D Scenes Studio usa esse contêiner de armazenamento para armazenar seu arquivo 3D e informações de configuração.

Você também configura permissões de leitura e gravação para a conta de armazenamento. Para configurar esses recursos de suporte rapidamente, esta seção usa o Azure Cloud Shell.

1. Navegue até o Cloud Shell em seu navegador.

   Execute o seguinte comando para definir o contexto da CLI para sua assinatura para esta sessão.

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

2. Execute o seguinte comando para criar uma conta de armazenamento na sua subscrição. O comando contém espaços reservados para você inserir um nome e escolher uma região para sua conta de armazenamento e 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á os detalhes da sua nova conta de armazenamento na saída. Procure o ID valor na saída e copie-o para usar no próximo comando.

   

3. Execute o seguinte comando para conceder a si próprio a função de Proprietário de Dados de Blob de Armazenamento na conta de armazenamento. Este nível de acesso permite-lhe executar operações de leitura e escrita 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 seguinte comando para configurar o CORS para sua conta de armazenamento. Essa configuração é necessária para que o 3D Scenes Studio acesse seu 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>
   

   Este comando não tem nenhuma saída.

5. Execute o seguinte comando para criar um contêiner privado na conta de armazenamento. Os seus ficheiros 3D Scenes Studio são armazenados aqui. O comando contém um espaço reservado para você inserir um nome para seu contêiner de armazenamento e um espaço reservado para o nome de sua conta de armazenamento.

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

   Quando o comando é concluído com êxito, a saída mostra "created": true.

Inicialize o ambiente do 3D Scenes Studio

Agora que todos os seus recursos estão configurados, você pode usá-los para criar um ambiente no 3D Scenes Studio. Nesta seção, você cria uma cena e personaliza-a para o gráfico de exemplo que está em sua instância do Azure Digital Twins.

1. Navegue até o Estúdio de Cenas 3D. O estúdio é aberto, conectado à instância do Azure Digital Twins que você acessou por último no Azure Digital Twins Explorer. Dispense 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 do Azure Digital Twins, preencha o nome do host da sua instância na etapa Coletar nome do host nesta URL: https://<your-instance-host-name>.

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

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

   4. Selecione Guardar.

   

Adicionar uma nova cena 3D

Nesta seção, você cria uma nova cena 3D usando o arquivo de modelo 3D RobotArms.glb baixado anteriormente em Pré-requisitos. Uma cena consiste em um arquivo de modelo 3D e um arquivo de configuração criado para você automaticamente.

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

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

   

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

   

   Uma vez que o arquivo é carregado, você vê-lo listado de volta na tela principal do 3D Scenes Studio.

3. Selecione a cena para visualizar e abrir. A cena começa no modo Build.

   

Criar um elemento de cena

Em seguida, defina um elemento na visualização 3D e vincule-o a um gêmeo no gráfico de Gêmeos Digitais do Azure configurado anteriormente.

1. Selecione qualquer braço robótico na visualização da cena. Esta seleção apresenta as possíveis ações dos elementos. Selecione + Criar novo elemento.

   

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

   1. Selecione Arm1. Esta seleção aplica automaticamente o ID do gêmeo digital ($dtId) como o nome do elemento.

   2. Selecione Criar elemento.

   

O elemento agora aparece na lista de elementos da cena.

Criar um comportamento

Em seguida, você cria um comportamento para o elemento . Esses comportamentos permitem personalizar os visuais de dados do elemento e a lógica de negócios associada. Em seguida, você pode explorar esses visuais de dados para entender o estado do ambiente físico.

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

   

2. Em Nome para exibição, insira Eficiência da linha de embalagem. Em Elementos, selecione Arm1.

   

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

4. Mude para o separador Regras visuais. As regras visuais são sobreposições baseadas em dados nos elementos que pode configurar para indicar a integridade ou o estado do elemento.

   1. Primeiro, você define algumas condições para indicar a eficiência da linha de embalagem.

      1. Selecione Adicionar Regra.

         

      2. Insira um Nome para exibição das coletas por hora. Deixe a expressão de propriedade em Propriedade única e abra a lista suspensa de propriedades. Ele contém nomes de todas as propriedades no gêmeo primário para o elemento Arm1 . Selecione PrimaryTwin.FailedPickupsLastHr. Em seguida, selecione Adicionar condição.

         

      3. Em seguida, você define alguns limites para indicar quando as coletas horárias estão faltando muitos pacotes. Para este cenário, digamos que um braço precisa de atenção se perder mais de três captadores em uma hora. Rotule a condição >3 captações perdidas e defina um intervalo de valores entre 4 e Infinito (o valor do intervalo mínimo é inclusivo e o valor máximo é exclusivo). Atribua uma coloração ao elemento a vermelho. Selecione Guardar.

         

      4. Selecione Adicionar condição novamente e crie uma condição rotulada de 1 a 3 recolhas falhadas. Defina um intervalo de valores entre 1 e 4 e atribua uma coloração Elemento de laranja. Salve a condição.

         Selecione Adicionar condição mais uma vez e crie uma condição rotulada como 0 captadores perdidos. Defina um intervalo de valores entre 0 e 1 e atribua uma coloração Elemento de verde. Salve a condição.

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

         

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

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

         

      2. Insira um nome para exibição de PickupFailedAlert. Altere a expressão de propriedade para (Personalizado) avançado, insira uma propriedade de PrimaryTwin.PickupFailedAlert e defina o tipo como booleano. Esta seleção de propriedades faz referência a uma propriedade booleana no gêmeo braço que é definida como True quando uma coleta de pacote falha. Selecione Adicionar condição.

         

      3. Insira um rótulo para falha de ${PrimaryTwin.PickupFailedBoxID}. Mais tarde, na vista da cena, esse rótulo exibe dinamicamente o valor da propriedade string do gêmeo do braço PickupFailedBoxID, que contém um ID que representa a caixa que o braço mais recentemente não conseguiu pegar. Defina o Valor como True e escolha um tipo Visual de Selo. Defina a cor como vermelho e escolha um ícone. Selecione Salvar para adicionar a condição e, em seguida, selecione Salvar para salvar a regra visual.

         

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

      

5. Alterne para o separador Widgets. Os widgets são visuais guiados por dados que fornecem mais contexto e informação, ajudando-o a compreender o cenário que o comportamento representa. Aqui, adicionam-se dois widgets visuais para exibir informações de propriedade para o elemento do braço.

   1. Primeiro, crie um widget para exibir um manômetro do valor da pressão hidráulica do braço.

      1. Selecione Adicionar widget.

         

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

      2. Nas opções do Novo widget, adicione um Nome de exibição de Pressão hidráulica, uma Unidade de medida de m/s e uma expressão de propriedade única de PrimaryTwin.HydraulicPressure.

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

         

         Selecione Criar widget.

   2. Em seguida, crie um widget com um link para um fluxo de câmera ao vivo do braço.

      1. Selecione Adicionar widget. Na biblioteca de widgets, selecione o widget Link e, em seguida, Adicionar widget.

      2. Nas opções Novo widget , insira um Rótulo da câmera de braço ao vivo. Para o URL, você pode usar o URL http://contoso.armstreams.com/${PrimaryTwin.$dtId}de exemplo . Não há nenhuma câmera ao vivo hospedada na URL para este 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 estão concluídas. Salve o comportamento selecionando Criar comportamento.

   

O comportamento Eficiência da Linha de Embalagem agora aparece na lista de comportamentos na cena.

Ver cena

Até agora, você tem trabalhado com o 3D Scenes Studio no modo de construção . Agora, mude o modo para Exibir.

Na lista de elementos, selecione o elemento Arm1 que você criou. A visualização aumenta o zoom para mostrar o elemento visual e exibe os comportamentos configurados para ele.

Aplicar comportamento a outros elementos

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

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

2. Selecione um gêmeo primário de Arm2 para o novo elemento e alterne para a guia Comportamentos .

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

4. Selecione Criar elemento para concluir a criação do novo elemento arm.

Alterne para a guia Exibir para ver o comportamento trabalhando no novo elemento arm. Todas as informações selecionadas ao criar o comportamento agora estão disponíveis para os dois elementos do braço na cena.

Rever e contextualizar aprendizagens

Este guia de início rápido mostra como criar um painel imersivo para dados do Azure Digital Twins, para compartilhar com usuários finais e aumentar o acesso a informações importantes sobre seu ambiente do mundo real.

No 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 gráfico de gêmeo digital, e você vinculou um braço na visualização ao seu próprio gêmeo digital específico que fornecia dados de suporte. Você também criou um comportamento visual para exibir informações importantes sobre esse braço robótico ao visualizar a cena por completo, incluindo informações sobre quaisquer caixas que o braço não conseguiu pegar na última hora.

Neste início rápido, os modelos de exemplo e os gêmeos para o cenário de fábrica foram rapidamente criados para você, usando o simulador de Dados de Gêmeos Digitais do Azure. Ao usar os Gêmeos Digitais do Azure com seu próprio ambiente, você cria seus próprios modelos e gêmeos para descrever com precisão os elementos do seu ambiente em detalhes. Este guia de início rápido também usou o simulador de dados para simular dados em tempo real impulsionando atualizações de propriedade de gêmeos digitais quando ocorriam falhas nos pacotes. Quando você usa os Gêmeos Digitais do Azure com seu próprio ambiente, a ingestão de dados ao vivo é um processo que você mesmo configura de acordo com seus próprios sensores de ambiente.

Limpeza de recursos

Para limpar após este início rápido, escolha quais recursos do Azure Digital Twins você deseja remover, com base no que deseja fazer em seguida.

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

• Se quiser continuar a usar a instância do Azure Digital Twins deste artigo, mas limpar todos os seus modelos, gémeos e relacionamentos, execute o comando CLI seguinte: az dt job deletion.

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

  Se você quiser excluir apenas alguns desses elementos, 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 deseja remover.

• Se você não precisar mais de sua instância do Azure Digital Twins, poderá excluí-la usando o portal do Azure.

  Navegue de volta para a página Visão geral da instância no portal. (Se você já fechou essa guia, poderá encontrar a instância novamente pesquisando seu nome na barra de pesquisa do 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 seus recursos de armazenamento navegando até a página Visão geral da sua conta de armazenamento no portal do Azure e selecionando Excluir. Essa ação exclui a conta de armazenamento e o contêiner dentro dela, juntamente com os arquivos de cena 3D que estavam no contêiner.

Você também pode querer excluir o arquivo 3D de exemplo baixado de sua máquina local.

Próximos passos

Em seguida, continue para os tutoriais de Gêmeos Digitais do Azure para criar seu próprio ambiente de Gêmeos Digitais do Azure.