Executar o aplicativo de amostra: HoloLens - Visual Studio (C++/WinRT)

Este quickstart cobre como executar a aplicação de amostra de Âncoras Espaciais Azure para HoloLens usando Visual Studio (C++/WinRT e DirectX). Azure Spatial Anchors é um serviço de desenvolvedores de plataformas cruzadas que permite criar experiências de realidade mista usando objetos que persistem a sua localização através dos dispositivos ao longo do tempo. Quando terminar, terá uma aplicação HoloLens que pode guardar e recordar uma âncora espacial.

Vai aprender a:

  • Criar uma conta de Âncoras Espaciais
  • Configure o identificador de conta Spatial Anchors e a chave de conta
  • Implementar e executar num dispositivo HoloLens

Se não tiver uma subscrição do Azure, crie uma conta Azure gratuita antes de começar.

Pré-requisitos

Para concluir este início rápido, certifique-se de que tem:

Criar um recurso de âncoras espaciais

Aceda ao Portal do Azure.

No painel esquerdo, selecione Criar um recurso.

Use a caixa de pesquisa para procurar âncoras espaciais.

Screenshot mostrando os resultados de uma pesquisa de Âncoras Espaciais.

Selecione Âncoras Espaciais e, em seguida, selecione Criar.

No painel de contas das âncoras espaciais , faça o seguinte:

  • Introduza um nome de recurso único utilizando caracteres alfanuméricos regulares.

  • Selecione a subscrição a que pretende anexar o recurso.

  • Criar um grupo de recursos selecionando Criar novo. Nomeie-o no myResourceGroup e, em seguida, selecione OK.

    Um grupo de recursos é um recipiente lógico no qual os recursos da Azure, tais como aplicações web, bases de dados e contas de armazenamento, são implantados e geridos. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

  • Selecione uma localização (região) na qual coloque o recurso.

  • Selecione Criar para começar a criar o recurso.

Screenshot do painel de âncoras espaciais para criar um recurso.

Após a criação do recurso, o portal do Azure mostra que a sua implantação está completa.

Screenshot mostrando que a implementação do recurso está completa.

Selecione Ir para recurso. Agora pode ver as propriedades dos recursos.

Copie o valor de ID da conta do recurso num editor de texto para posterior utilização.

Screenshot do painel de propriedades de recursos.

Também copie o valor do Domínio da Conta do recurso num editor de texto para posterior utilização.

Screenshot mostrando o valor do domínio da conta do recurso.

Em Definições, selecione A Tecla de acesso. Copie o valor da chave principal , Chave de Conta, num editor de texto para posterior utilização.

Screenshot do painel keys para a conta.

Abra o projeto de amostra

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

Aberto HoloLens\DirectX\SampleHoloLens.sln no Estúdio Visual.

Configure identificador de conta e chave

O próximo passo é configurar a app para usar o identificador de conta e a chave da conta. Copiou-os para um editor de texto ao configurar o recurso "Âncoras Espaciais".

Abra HoloLens\DirectX\SampleHoloLens\ViewController.cpp.

Localize o SpatialAnchorsAccountKey campo e substitua-o Set me pela chave de conta.

Localize o SpatialAnchorsAccountId campo e substitua-o Set me pelo identificador de conta.

Localize o SpatialAnchorsAccountDomain campo e substitua-o Set me pelo domínio da conta.

Implemente a aplicação para os seus HoloLens

Altere a Configuração da Solução para soltar, altere a Plataforma de Solução para x86 e selecione o Dispositivo a partir das opções-alvo de implementação.

Se utilizar hololens 2, utilize o ARM64 como Plataforma de Solução, em vez de x86.

Configuração visual do estúdio

Ligue o dispositivo HoloLens, inscreva-se e conecte-o ao PC utilizando um cabo USB.

Selecione Debug>Comece a depurar para implementar a sua aplicação e comece a depurar.

Siga as instruções na aplicação para colocar e lembre-se de uma âncora.

No Visual Studio, pare a aplicação selecionando Stop Debugging ou pressionandoShift + F5.

Limpar os 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.

A partir do menu portal do Azure ou página inicial, selecione grupos de Recursos. Em seguida, na página de grupos de recursos , selecione myResourceGroup.

Na página myResourceGroup , certifique-se de que os recursos listados são os que pretende eliminar.

Selecione Eliminar o grupo de recursos, digite o myResourceGroup na caixa de texto para confirmar e, em seguida, selecione Delete.

Passos seguintes

Neste arranque rápido, criaste uma conta espacial. Em seguida, configuraste e implementou uma aplicação para guardar e recordar âncoras espaciais. Para saber mais sobre como melhorar a app para que possa partilhar âncoras espaciais com outros dispositivos, continue para o próximo tutorial.