Execute o aplicativo de exemplo: HoloLens - Visual Studio (C++/WinRT)
Artigo
Este guia de início rápido aborda como executar o aplicativo de exemplo Azure Spatial Anchors para HoloLens usando o Visual Studio (C++/WinRT e DirectX). O Azure Spatial Anchors é um serviço de desenvolvedor multiplataforma que permite criar experiências de realidade mista usando objetos que persistem sua localização entre dispositivos ao longo do tempo. Quando terminar, você terá um aplicativo HoloLens que pode salvar e recuperar uma âncora espacial.
Saberá como:
Criar uma conta de Âncoras Espaciais
Configurar o identificador de conta e a chave de conta das Âncoras Espaciais
Para concluir este início rápido, certifique-se de que tem:
Uma máquina Windows com o Visual Studio 2019 instalado 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). Você também deve instalar o Git para Windows e o Git LFS.
Um dispositivo HoloLens com o modo de desenvolvedor ativado. Este artigo requer um dispositivo HoloLens com a Atualização de maio de 2020 do Windows 10. Para atualizar para a versão mais recente no HoloLens, abra o aplicativo Configurações, vá para Atualizar & Segurança e selecione o botão Verificar se há atualizações.
Seu aplicativo deve definir o recurso spatialPerception em seu manifesto do AppX.
Use a caixa de pesquisa para procurar Âncoras Espaciais.
Selecione Âncoras espaciais e, em seguida, selecione Criar.
No painel Conta de Âncoras Espaciais, faça o seguinte:
Insira um nome de recurso exclusivo usando caracteres alfanuméricos regulares.
Selecione a subscrição à qual pretende anexar o recurso.
Crie um grupo de recursos selecionando Criar novo. Nomeie-o myResourceGroup e selecione OK.
Um grupo de recursos é um contêiner lógico no qual os recursos do Azure, como aplicativos Web, bancos de dados e contas de armazenamento, são implantados e gerenciados. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.
Selecione um local (região) no qual colocar o recurso.
Selecione Criar para começar a criar o recurso.
Depois que o recurso é criado, o portal do Azure mostra que sua implantação foi concluída.
Selecione Ir para recurso. Agora você pode exibir as propriedades do recurso.
Copie o valor de ID de conta do recurso em um editor de texto para uso posterior.
Copie também o valor Domínio da Conta do recurso em um editor de texto para uso posterior.
Em Configurações, selecione Chave de acesso. Copie o valor da chave primária, Chave de conta, em um editor de texto para uso posterior.
Comece por preparar o seu ambiente para a CLI do Azure:
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.
Depois de entrar, use o comando az account set para selecionar a assinatura na qual configurar a conta de âncoras espaciais:
az account set --subscription 00000000-0000-0000-0000-000000000000
Execute o comando az group create para criar um grupo de recursos ou use um grupo de recursos existente:
az group create --name myResourceGroup --location eastus2
Um grupo de recursos é um contêiner lógico no qual os recursos do Azure, como aplicativos Web, bancos de dados e contas de armazenamento, são implantados e gerenciados. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
Enquanto o módulo Az.MixedReality PowerShell estiver em visualização, você deve instalá-lo separadamente usando o Install-Module cmdlet. Quando este módulo do PowerShell entrar em disponibilidade geral, fará parte das versões futuras do módulo Az PowerShell e estará disponível por predefinição a partir do Azure Cloud Shell.
Install-Module -Name Az.MixedReality
Depois de entrar, use o cmdlet Set-AzContext para selecionar a assinatura na qual configurar a conta de âncoras espaciais:
Um grupo de recursos é um contêiner lógico no qual os recursos do Azure, como aplicativos Web, bancos de dados e contas de armazenamento, são implantados e gerenciados. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.
Clone o repositório de amostras executando os seguintes comandos:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Abra HoloLens\DirectX\SampleHoloLens.sln no Visual Studio.
Configurar identificador de conta e chave
A próxima etapa é configurar o aplicativo para usar seu identificador de conta e chave de conta. Você os copiou em um editor de texto ao configurar o recurso Âncoras espaciais.
Localize o SpatialAnchorsAccountKey campo e substitua Set me pela chave da conta.
Localize o SpatialAnchorsAccountId campo e substitua Set me pelo identificador da conta.
Localize o SpatialAnchorsAccountDomain campo e substitua Set me pelo domínio da conta.
Implante o aplicativo em seu HoloLens
Altere a Configuração da Solução para Release, altere a Plataforma da Solução para x86 e selecione Dispositivo nas opções de destino de implantação.
Se estiver usando o HoloLens 2, use ARM64 como a plataforma de solução, em vez de x86.
Ligue o dispositivo HoloLens, inicie sessão e ligue-o ao PC utilizando um cabo USB.
Selecione Depurar Iniciar depuração para implantar seu aplicativo e iniciar a depuração>.
Siga as instruções no aplicativo para colocar e recuperar uma âncora.
No Visual Studio, pare o aplicativo selecionando Parar Depuração ou pressionando Shift + F5.
Clean up resources (Limpar recursos)
Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.
No menu do portal do Azure ou na página inicial , selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.
Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que você deseja excluir.
Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.
Próximos passos
Neste início rápido, você criou uma conta de Âncoras Espaciais. Em seguida, você configurou e implantou um aplicativo para salvar e recuperar âncoras espaciais. Para saber mais sobre como melhorar o aplicativo para que ele possa compartilhar âncoras espaciais com outros dispositivos, continue para o próximo tutorial.