Início Rápido: criar um aplicativo Unity para HoloLens que usa as Âncoras Espaciais do AzureQuickstart: Create a Unity HoloLens app that uses Azure Spatial Anchors

Neste início rápido, você criará um aplicativo Unity para HoloLens que usa as Âncoras Espaciais do Azure.In this quickstart, you'll create a Unity HoloLens app that uses Azure Spatial Anchors. Âncoras Espaciais são um serviço de desenvolvedor de plataforma cruzada que permite criar experiências de realidade misturada com objetos que persistem sua localização em todos os dispositivos ao longo do tempo.Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences with objects that persist their location across devices over time. Quando terminar, você terá um aplicativo HoloLens criado com o Unity que pode salvar e fazer recall de uma âncora espacial.When you're finished, you'll have a HoloLens app built with Unity that can save and recall a spatial anchor.

Você aprenderá a:You'll learn how to:

  • Criar uma conta de Âncoras Espaciais.Create a Spatial Anchors account.
  • Preparar as configurações de criação do Unity.Prepare Unity build settings.
  • Configurar a chave de conta e o identificador da conta das Âncoras Espaciais.Configure the Spatial Anchors account identifier and account key.
  • Exportar o projeto do Visual Studio do HoloLens.Export the HoloLens Visual Studio project.
  • Implantar o aplicativo e executá-lo em um dispositivo HoloLens.Deploy the app and run it on a HoloLens device.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Pré-requisitosPrerequisites

Para concluir este guia de início rápido:To complete this quickstart:

  • É necessário um computador Windows no qual o Unity 2019.1 ou posterior e o Visual Studio 2019 ou posterior estão instalados.You need a Windows computer on which Unity 2019.1 or later and Visual Studio 2019 or later are installed. A instalação do Visual Studio deverá incluir a carga de trabalho de Desenvolvimento com a Plataforma Universal do Windows e o componente SDK do Windows 10 (10.0.18362.0 ou mais recente) .Your Visual Studio installation must include the Universal Windows Platform development workload and the Windows 10 SDK (10.0.18362.0 or newer) component. Além disso, será necessário instalar o Git para Windows.You must also install Git for Windows.
  • Você precisará de um dispositivo do HoloLens com o modo de desenvolvedor habilitado.You need a HoloLens device on which developer mode enabled. A Atualização de outubro de 2018 para o Windows 10 (também conhecida como RS5) deverá ser instalada no dispositivo.Windows 10 October 2018 Update (also known as RS5) must be installed on the device. Para atualizar para a versão mais recente do HoloLens, abra o aplicativo de Configurações, acesse Atualização e Segurança e, em seguida, selecione Verificar atualizações.To update to the latest release on HoloLens, open the Settings app, go to Update & Security, and then select Check for updates.
  • No aplicativo, é necessário habilitar o recurso SpatialPerception.On your app, you need to enable the SpatialPerception capability. Essa configuração está em Configurações de Build > Configurações do Player > Configurações de Publicação > Recursos.This setting is in Build Settings > Player Settings > Publishing Settings > Capabilities.
  • No seu aplicativo, é necessário habilitar Realidade Virtual com Suporte com SDK de Realidade Misturada do Windows.On your app, you need to enable Virtual Reality Supported with Windows Mixed Reality SDK. Esta configuração está em Configurações de Build > Configurações do Player > Configurações XR.This setting is in Build Settings > Player Settings > XR Settings.

Criar um recurso Âncoras EspaciaisCreate a Spatial Anchors resource

Vá para o Portal do Azure.Go to the Azure portal.

No painel de navegação esquerdo do portal do Azure, clique em Criar um recurso.In the left navigation pane in the Azure portal, select Create a resource.

Use a caixa de pesquisa para Âncoras Espaciais.Use the search box to search for Spatial Anchors.

Pesquisar Âncoras Espaciais

Selecione Âncoras Espaciais.Select Spatial Anchors. Na caixa de diálogo, selecione Criar.In the dialog box, select Create.

No caixa de diálogo Conta de Âncoras Espaciais:In the Spatial Anchors Account dialog box:

  • Insira um nome de recurso exclusivos, usando caracteres alfanuméricos regulares.Enter a unique resource name, using regular alphanumeric characters.

  • Selecione a assinatura que você deseja anexar o recurso.Select the subscription that you want to attach the resource to.

  • Crie um grupo de recursos, selecionando Criar novo.Create a resource group by selecting Create new. Denomine-o como myResourceGroup e selecione OK.Name it myResourceGroup and select 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.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Por exemplo, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.For example, you can choose to delete the entire resource group in one simple step later.

  • Selecione um local (região) para criar o recurso.Select a location (region) in which to place the resource.

  • Selecione Novo para começar a criar o recurso.Select New to begin creating the resource.

    Criar um recurso

Depois que o recurso é criado, o portal do Azure mostra que a implantação foi concluída.After the resource is created, Azure Portal will show that your deployment is complete. Clique em Ir para o recurso.Click Go to resource.

Implantação concluída

Em seguida, você pode exibir as propriedades do recurso.Then, you can view the resource properties. Copiar o valor de ID da conta em um editor de texto, pois você precisará dele mais tarde.Copy the resource's Account ID value into a text editor because you'll need it later.

Propriedades de recurso

Em Configurações, selecione Chave.Under Settings, select Key. Cópia do valor de Chave primária em um editor de texto.Copy the Primary key value into a text editor. Esse valor é o Account Key.This value is the Account Key. Você precisará dela mais tarde.You'll need it later.

Chave de conta

Baixe e abra o projeto de exemplo do UnityDownload and open the Unity sample project

Clone o repositório de exemplos executando o seguinte comando:Clone the samples repository by running the following command:

git clone https://github.com/Azure/azure-spatial-anchors-samples.git

No Unity, abra o projeto na pasta Unity.In Unity, open the project in the Unity folder. O Unity pode solicitar uma versão diferente entre o projeto e a versão instalada em seu computador.Unity might prompt you about a different Unity version between the project and the one you've installed on your machine. Esse aviso não é incomum, contanto que sua versão do Editor do Unity seja mais recente do que aquele em que o projeto foi criado.This warning is okay, as long as your version of Unity Editor is newer than the one the project was created with. Nesse caso, clique em Continuar.In that case, just click Continue. Caso sua versão do editor do Unity seja antiga do que a exigida pelo projeto, clique em Saire atualize o editor do Unity.If your Unity Editor version is older than the one the project needs, click Quit, and upgrade your Unity Editor.

Janela do Unity

Abra Configurações de Build selecionando Arquivo > Configurações de Build.Open Build Settings by selecting File > Build Settings.

Na seção Plataforma, selecione Plataforma Universal do Windows.In the Platform section, select Universal Windows Platform. Altere o Dispositivo de Destino para HoloLens.Change the Target Device to HoloLens.

Selecione Alternar Plataforma para alterar a plataforma para a Plataforma Universal do Windows.Select Switch Platform to change the platform to Universal Windows Platform. O Unity poderá solicitar que você instale componentes de suporte UWP, se estiverem faltando.Unity might prompt you to install UWP support components if they're missing.

Janela Configurações de Build do Unity

Feche a janela Configurações de Build.Close the Build Settings window.

Configurar o identificador e a chave da contaConfigure the account identifier and key

No painel Projeto, vá para Assets/AzureSpatialAnchors.Examples/Scenes e abra o arquivo de cena AzureSpatialAnchorsBasicDemo.unity.In the Project pane, go to Assets/AzureSpatialAnchors.Examples/Scenes and open the AzureSpatialAnchorsBasicDemo.unity scene file.

A próxima etapa é configurar o aplicativo para usar o identificador e a chave de conta.The next step is to configure the app to use your account identifier and account key. Você os copiou em um editor de texto ao configurar o recurso Âncoras Espaciais.You copied them into a text editor when setting up the Spatial Anchors resource.

No painel Projeto, navegue até Assets\AzureSpatialAnchors.SDK\Resources.In the Project pane, navigate to Assets\AzureSpatialAnchors.SDK\Resources. Selecione SpatialAnchorConfig.Select SpatialAnchorConfig. Em seguida, no painel Inspetor, insira Account Key como o valor de Spatial Anchors Account Key e Account ID como o valor de Spatial Anchors Account Id.Then, in the Inspector pane, enter the Account Key as the value for Spatial Anchors Account Key and the Account ID as the value for Spatial Anchors Account Id.

Salve a cena selecionando Arquivo > Salvar.Save the scene by selecting File > Save.

Exportar o projeto do Visual Studio do HoloLensExport the HoloLens Visual Studio project

Abra Configurações de Build selecionando Arquivo > Configurações de Build.Open Build Settings by selecting File > Build Settings.

Em Cenas na compilação, verifique se todas as cenas foram selecionadas.Under Scenes In Build, ensure all the scenes have a check mark next to them.

Selecione Compilar.Select Build. Na caixa de diálogo, selecione uma pasta para exportar o projeto do Visual Studio do HoloLens.In the dialog box, select a folder in which to export the HoloLens Visual Studio project.

Quando a exportação estiver concluída, uma pasta contendo o projeto HoloLens exportado será exibida.When the export is complete, a folder containing the exported HoloLens project will appear.

Implantar o aplicativo HoloLensDeploy the HoloLens application

Na pasta, clique duas vezes em HelloAR U3D.sln para abrir o projeto no Visual Studio.In the folder, double-click HelloAR U3D.sln to open the project in Visual Studio.

Altere a Configuração da Solução para Lançamento, altere a Plataforma da Solução para x86 e selecione Dispositivo das opções de destino de implantação.Change the Solution Configuration to Release, change the Solution Platform to x86, and select Device from the deployment target options.

Se estiver usando o HoloLens 2, use o ARM como a Plataforma de Solução, em vez de x86.If using HoloLens 2, use ARM as the Solution Platform, instead of x86.

Configuração do Visual Studio

Ligue o dispositivo do HoloLens, entre e conecte o dispositivo ao computador usando um cabo USB.Turn on the HoloLens device, sign in, and connect the device to the PC by using a USB cable.

Selecione Depurar > Iniciar depuração para implantar seu aplicativo e iniciar a depuração.Select Debug > Start debugging to deploy your app and start debugging.

Siga as instruções no aplicativo para colocar uma âncora e fazer recall dela.Follow the instructions in the app to place and recall an anchor.

No Visual Studio, pare o aplicativo selecionando Parar Depuração ou Shift+F5.In Visual Studio, stop the app by selecting either Stop Debugging or Shift+F5.

Limpar recursosClean up resources

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir o grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

No menu do portal do Azure ou na página Inicial, selecione Grupos de Recursos e, na página Grupos de Recursos, selecione myResourceGroup.From the Azure portal menu or Home page, select Resource groups, and on the Resource groups page, select myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que deseja excluir.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Selecione Excluir, digite myResourceGroup na caixa de texto e selecione Excluir.Select Delete, type myResourceGroup in the text box, and then select Delete.

Próximas etapasNext steps

Neste início rápido, você criou uma conta de Âncoras Espaciais.In this quickstart, you created a Spatial Anchors account. Em seguida, você configurou e implantou um aplicativo para salvar e fazer recall de âncoras espaciais.You then configured and deployed an app to save and recall spatial anchors. Para saber mais sobre como melhorar o aplicativo, de modo que ele possa compartilhar âncoras espaciais com outros dispositivos, continue no próximo tutorial.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.