Guia de início rápido: criar um aplicativo HoloLens com âncoras de objeto do Azure, em C++/WinRT e DirectX
Este guia de início rápido aborda como criar um aplicativo HoloLens usando as Âncoras de Objeto do Azure em C++/WinRT e DirectX. O Object Anchors é um serviço de nuvem gerenciado que converte ativos 3D em modelos de IA que permitem experiências de realidade mista com reconhecimento de objeto para o HoloLens. Quando terminar, você terá um aplicativo HoloLens que pode detetar um objeto e sua pose em um aplicativo Holográfico DirectX 11 (Universal Windows).
Saberá como:
- Criar e fazer sideload de um aplicativo HoloLens
- Detetar um objeto e visualizar seu modelo
Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
Pré-requisitos
Para concluir este início rápido, certifique-se de que tem:
- Um objeto físico em seu ambiente e seu modelo 3D, CAD ou digitalizado.
- Um computador Windows com o seguinte instalado:
- Git para Windows
- Visual Studio 2019 com a carga de trabalho de desenvolvimento da Plataforma Universal do Windows e o componente SDK do Windows 10 (10.0.18362.0 ou mais recente)
- Um dispositivo HoloLens 2 que está atualizado e tem o modo de desenvolvedor ativado.
- Para atualizar para a versão mais recente no HoloLens, abra o aplicativo Configurações , vá para Atualizar & Segurança e selecione Verificar se há atualizações.
Criar uma conta Object Anchors
Primeiro, você precisa criar uma conta com o serviço Object Anchors.
Vá para o portal do Azure e selecione Criar um recurso.
Procure o recurso Âncoras de objeto.
Procure por "Âncoras de objeto".
No recurso Âncoras de objeto nos resultados da pesquisa, selecione Criar -> Âncoras de objeto.
Na caixa de diálogo Conta de âncoras de objeto:
- Insira um nome de recurso exclusivo.
- Selecione a assinatura à qual deseja anexar o recurso.
- Crie ou use um grupo de recursos existente.
- Selecione a região na qual você deseja que seu recurso exista.
Selecione Criar para começar a criar o recurso.
Depois de criar o recurso, selecione Aceder ao recurso.
Na página de visão geral:
Tome nota do Domínio da Conta. Precisará dele mais tarde.
Anote o ID da conta. Precisará dele mais tarde.
Vá para a página Chaves de Acesso e tome nota da chave primária. Precisará dele mais tarde.
Carregue o seu modelo
Antes de executar o aplicativo, você precisará disponibilizar seus modelos para o aplicativo. Se você ainda não tiver um modelo de Âncoras de Objeto, siga as instruções em Criar um modelo para criar um. Então, volte aqui.
Com o HoloLens ligado e conectado ao dispositivo de desenvolvimento (PC), siga estas etapas para carregar um modelo para a pasta Objetos 3D no HoloLens:
Selecione e copie os modelos com os quais deseja trabalhar pressionando a tecla Ctrl e C juntos (Ctrl + C).
Pressione a tecla do logotipo do Windows e E juntos (Win + E) para iniciar o Explorador de Arquivos. Você deve ver seu HoloLens listado com outras unidades e pastas no painel esquerdo.
Toque no link HoloLens para mostrar o armazenamento no dispositivo HoloLens no painel direito.
No Explorador de Ficheiros, aceda a Objetos 3D de Armazenamento > Interno. Agora, você pode colar seus modelos na pasta Objetos 3D pressionando a tecla Ctrl e V juntos (Ctrl + V).
Abrir o projeto de exemplo
Clone o repositório de amostras executando os seguintes comandos:
git clone https://github.com/Azure/azure-object-anchors.git
cd ./azure-object-anchors
Abra inícios rápidos/apps/directx/DirectXAoaSampleApp.sln no Visual Studio.
Altere a Configuração da Solução para Lançamento, altere a Plataforma da Solução para ARM64, selecione Dispositivo nas opções de destino da implantação.
Configurar as informações da conta
A próxima etapa é configurar o aplicativo para usar as informações da sua conta. Você anotou os valores de Chave de Conta, ID da Conta e Domínio da Conta, na seção "Criar uma conta de âncoras de objeto".
Abra Assets\ObjectAnchorsConfig.json.
Localize o campo e substitua Set me
pelo ID da AccountId
sua conta.
Localize o campo e substitua AccountKey
Set me
pela sua Chave de Conta.
Localize o campo e substitua Set me
pelo seu Domínio da AccountDomain
Conta.
Agora, crie o projeto AoaSampleApp clicando com o botão direito do mouse no projeto e selecionando Construir.
Implantar o aplicativo no HoloLens
Depois de compilar o projeto de exemplo com êxito, você pode implantar o aplicativo no HoloLens.
Certifique-se de que o dispositivo HoloLens está ligado e ligado ao PC através de um cabo USB. Certifique-se de que Device é o destino de implantação escolhido, conforme acima.
Clique com o botão direito do mouse no projeto AoaSampleApp e selecione Implantar no menu de contexto para instalar o aplicativo. Se nenhum erro aparecer na janela de saída do Visual Studio, o aplicativo será instalado no HoloLens.
Antes de iniciar o aplicativo, você deve ter carregado um modelo de objeto, chair.ou, por exemplo, para a pasta Objetos 3D no seu HoloLens. Se ainda não o fez, siga as instruções na secção Carregue o seu modelo .
Para iniciar e depurar o aplicativo, selecione Depurar Iniciar depuração>.
Ingerir modelo de objeto e detetar sua instância
O aplicativo AoaSampleApp agora está sendo executado em seu dispositivo HoloLens. Aproxime-se, a uma distância de 2 metros, do objeto alvo (cadeira) e digitalize-o olhando-o de várias perspetivas. Você deve ver uma caixa delimitadora rosa ao redor do objeto com alguns pontos amarelos renderizados perto da superfície do objeto, o que indica que ele foi detetado. Você também verá uma caixa amarela que indica a área de pesquisa.
Você pode definir um espaço de pesquisa para o objeto no aplicativo clicando com o dedo no ar com a mão direita ou esquerda. O espaço de busca alternará entre uma esfera de 2 metros de raio, uma caixa delimitadora de 4 m^3 e um frustum de visão. Para objetos maiores, como carros, a melhor escolha geralmente é usar a seleção de frustum de visão enquanto está de frente para um canto do objeto a cerca de 2 metros de distância. Cada vez que a área de pesquisa é alterada, o aplicativo remove instâncias que estão sendo rastreadas no momento. Em seguida, tenta encontrá-los novamente na nova área de pesquisa.
Este aplicativo pode rastrear vários objetos ao mesmo tempo. Para fazer isso, carregue vários modelos para a pasta Objetos 3D do seu dispositivo e defina uma área de pesquisa que cubra todos os objetos de destino. Pode levar mais tempo para detetar e rastrear vários objetos.
O aplicativo alinha um modelo 3D à sua contraparte física de perto. Um usuário pode tocar no ar usando a mão esquerda para ativar o modo de rastreamento de alta precisão, que calcula uma pose mais precisa. Este recurso ainda é experimental. Ele consome mais recursos do sistema e pode resultar em maior desvio na pose estimada. Toque novamente com a mão esquerda para voltar ao modo de rastreamento normal.