4. Integrar as Âncoras Espaciais do Azure4. Integrating Azure Spatial Anchors

Neste tutorial, você aprenderá a usar as Âncoras Espaciais do Azure.In this tutorial, you will learn how to use Azure Spatial Anchors. Você armazenará o local de um Objeto Rastreado como uma Âncora Espacial do Azure.You will store the location of a Tracked Object as an Azure Spatial Anchor. Quando você consultar a âncora, uma seta será exibida para guiar você em direção ao local.Once you query for the anchor, an arrow will appear to guide you toward the location.

ObjetivosObjectives

  • Aprender os conceitos básicos das Âncoras Espaciais do Azure.Learn the basics of Azure Spatial Anchors.
  • Saber como configurar a cena para usar as Âncoras Espaciais do Azure neste projeto.Learn how to set up the scene to use Azure Spatial Anchors in this project.
  • Saber como integrar de locais de armazenamento e consulta.Learn how to integrate storing and querying locations.

Noções básicas sobre Âncoras Espaciais do AzureUnderstanding Azure Spatial Anchors

As Âncoras Espaciais do Azure fazem parte da família de Serviços de Nuvem do Azure e são usadas para salvar locais de âncora.Azure Spatial Anchors is part of the Azure Cloud Services family and is used to save anchor locations. Os locais de âncora salvos podem ser recuperados com base na ID da âncora na nuvem.The saved anchor locations can be retrieved based on the anchor ID from the cloud. Esse local de âncora pode ser compartilhado e acessado por dispositivos de várias plataformas, como dispositivos HoloLens, iOS e Android.This anchor location can be shared and accessed by multi-platform devices like HoloLens, iOS, and Android devices.

Saiba mais sobre as Âncoras Espaciais do Azure.Learn more about Azure Spatial Anchors.

Preparar as Âncoras Espaciais do AzurePreparing Azure Spatial Anchors

Para começar, crie um recurso de âncora espacial no portal do Azure.Before you can start, you have to create a spatial anchor resource in your Azure portal. Saiba como criar um recurso de âncora espacial.Learn how to make a spatial anchor resource.

Preparando a cenaPreparing the scene

Nesta seção, você aprenderá a configurar a cena e a fazer as alterações necessárias.In this section, you will learn how to configure the scene and make the necessary changes.

Na janela Projeto, navegue até Ativos > MRTK.Tutorials.AzureCloudServices > Pré-fabricados > GerenciadorIn the Project window, navigate to the Assets > MRTK.Tutorials.AzureCloudServices > Prefabs > Manager

Unity com o pré-fabricado AnchorManager selecionado

Na pasta Gerenciador, arraste e solte o pré-fabricadp Gerenciador de Âncora na Hierarquia de cena.From the Manager folder, drag and drop the prefab Anchor Manager into the scene Hierarchy.

Selecione o GameObject Gerenciador de Âncora na Hierarquia e, na seção Inspetor, você encontrará o Gerenciador de Âncora Espacial (Script).Select Anchor Manager GameObject in the Hierarchy, and in the Inspector section, you will find Spatial Anchor Manager (Script). Localize a ID da conta e o campo de chave e adicione as credenciais que você criou no pré-requisito no estágio anterior.Find account ID and key field and add the credentials which you had created in the prerequisite in the earlier stage.

Unity com o pré-fabricado AnchorManager recém-adicionado ainda selecionado

Agora, localize o objeto Controlador de Cena na Hierarquia de cena e selecione-o.Now find the Scene Controller object in your scene Hierarchy and select it. Você verá o Inspetor do Controlador de Cena.You will see the Scene Controller Inspector.

Unity com o componente de script de SceneController configurado

Você observará que o campo do Gerenciador de Âncora no componente Controlador de Cena está vazio; arraste o Gerenciador de Âncora da Hierarquia e solte-o na cena desse campo e salve a cena.You will observe that the Anchor Manager field in the Scene Controller component is empty, drag and drop the Anchor Manager from the Hierarchy in the scene into that field and save the scene.

Compilar e Implantar o aplicativo no HoloLens 2Build and Deploy the app to your HoloLens 2

As Âncoras Espaciais do Azure não podem ser executadas no Unity, portanto, para testar a funcionalidade delas, você precisa implantar o projeto em seu dispositivo.Azure Spatial Anchors can not run in Unity, so to test the Azure Spatial Anchors functionality, you need to deploy the project to your device.

Dica

Para obter um lembrete sobre como criar e implantar o seu projeto do Unity no HoloLens 2, confira as instruções em Como criar o aplicativo no seu HoloLens 2.For a reminder on how to build and deploy your Unity project to HoloLens 2, you can refer to the [Building your application to your HoloLens 2]((mr-learning-base-02.md#building-and-deploying-to-your-hololens-2) instructions.

Execute o aplicativo no seu HoloLens 2 e siga as instruções no aplicativoRun the app on your HoloLens 2 and follow the in-app instructions

Criar uma âncora para armazenar um localCreate an anchor to store a location

Nesta seção, você verá como salvar o local do objeto.In this section you will see how to save the object location.

Execute o aplicativo e clique em Definir Objeto no menu principal da experiência.Run the application and click on Set Object in the main menu of the experience.

Forneça o nome do objeto que você deseja salvar e clique em Definir Objeto para continuar.Give the name of the object you want to save and click on Set Object to continue. Para adicionar mais informações sobre o objeto, selecione a imagem e descreva o objeto.To add more information about the object, select the image, and describe the object.

Para salvar o local, clique em Salvar LocalTo save the location, click on Save Location

Você verá um ponteiro de âncora que poderá mover e posicionar no local que deseja salvar.You will see an anchor pointer that you can move and place on the location you want to save. Depois disso, você verá um pop-up de confirmação.After that, you will get a confirmation popup. Se você quiser confirmar e salvar o local, clique em Sim; caso contrário, altere o local clicando em Não e selecionando o local novamente.If you want to confirm and save the location, click on Yes; otherwise, you can change the location by clicking on No and selecting the location again.

Depois de confirmar o local clicando em Sim, o local e a ID da Âncora serão salvos no armazenamento em nuvem do Azure.Once you confirm the location by clicking on Yes, the location and the Anchor ID will be saved in the Azure cloud storage. Depois de salvar, você verá a Marca de objeto na âncora com o nome do objeto.Once it is saved, you will see the Object tag in the anchor with the object's name.

Agora o local do objeto foi salvo com êxito.Now the object location is saved successfully.

Consultar para localizar um local de âncoraQuery for finding an anchor location

Depois de salvar com êxito o local de âncora, agora você pode encontrar o local da âncora selecionando Pesquisar Objeto no menu principal.Once after you successfully saved the anchor location, now you can find the anchor location by selecting Search Object in the main menu.

Depois de clicar em Pesquisar Objeto, uma nova janela será exibida, na qual você deverá dar o nome do objeto que deseja pesquisar.After clicking on Search Object, a new window will pop up in which you should give the name of the object you want to search.

Insira o nome do objeto e clique em Pesquisar Objeto.Enter the name of the object and click on Search Object. Se o objeto foi salvo anteriormente e for encontrado no banco de dados, você obterá o cartão de objeto com todos os detalhes do objeto que você salvou anteriormente.If the object is saved previously and is found in the database, you will get the object card with all the details of the object you would have saved earlier.

Agora você pode clicar em Mostrar Local para localizar o objeto.Now you can click on Show Location to find the object. Ao clicar em Mostrar Local, o sistema consultará o endereço do objeto no armazenamento em nuvem.Once you click on Show Location, the system will query the object address from the cloud storage.

Depois de recuperar o local com êxito, uma seta vai direcioná-lo para o local do objeto.After successfully retrieving the location, an arrow will direct you towards the location of the object. Siga a marca de seta até encontrar o local do objeto.Follow the arrow mark until you find the location of the object.

Ao encontrar o objeto, o nome do objeto aparecerá na parte superior e a marca de seta desaparecerá e agora você poderá clicar na marca de objeto para ver os detalhes do objeto.Once you find the object, the object name will appear at the top, and the arrow mark will disappear, and now you can click on the object tag to see the details of the object.

ParabénsCongratulations

Neste tutorial, você aprendeu como as Âncoras Espaciais do Azure podem salvar e recuperar o local do objeto no Hololense 2.In this tutorial, you learned how Azure Spatial Anchors could save and retrieve the object location on Hololense 2.

No tutorial final, você aprenderá a usar o Serviço de Bot do Azure para adicionar linguagem natural como um novo método de interação para o aplicativo.In the final tutorial, you will learn how to use the Azure Bot Service to add natural language as a new interaction method for our application.