5. Âncoras Espaciais do Azure para o Android e o iOS5. Azure Spatial Anchors for Android and iOS

Neste tutorial, você aprenderá a criar seu projeto para dispositivos Android e iOS usando o AR Foundation, o Plug-in ARCore XR e o Plug-in ARKit XR.In this tutorial, you will learn how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.

ObjetivosObjectives

  • Saiba como criar o projeto para seu dispositivo Android usando o Plug-in ARCore XR e o AR Foundation do UnityLearn how to build your project to your Android device using Unity's AR Foundation and ARCore XR Plugin
  • Saiba como criar o projeto para seu dispositivo iOS usando o Plug-in ARKit XR e o AR Foundation do UnityLearn how to build your project to your iOS device using Unity's AR Foundation and ARKit XR Plugin

Instalar pacotes internos do UnityInstalling inbuilt Unity packages

Nesta seção, você atualizará e instalará os seguintes pacotes embutidos:In this section, you will upgrade and install the following inbuilt packages:

  • AR Foundation 3.1.3AR Foundation 3.1.3
  • Auxiliares de entrada herdados 2.1.4Legacy Input Helpers 2.1.4
  • Plug-in ARCore XR 3.1.3 para suporte ao AndroidARCore XR Plugin 3.1.3 for Android support
  • Plug-in ARKit XR 3.1.3 para suporte a iOSARKit XR plugin 3.1.3 for iOS support

Cuidado

Nem todas as versões são compatíveis com o MRTK e apenas determinadas versões funcionam em conjunto, portanto, instale as versões exatas listadas acima.Not all version are compatible with MRTK and only certain version works together, so make sure you install the exact versions listed above.

No menu do Unity, selecione Janela > Gerenciador de Pacotes para abrir a janela Gerenciador de Pacotes e selecione AR Foundation > 3.1.3 e clique no botão Atualizar para 3.1.3 para atualizar o pacote:In the Unity menu, select Window > Package Manager to open the Package Manager window, then select AR Foundation > 3.1.3 and click the Update to 3.1.3 button to update the package:

mr-learning-asa

Siga o mesmo processo para importar os pacotes restantes, conforme necessário.Follow the same process to import the remaining packages as needed.

Observação

Se você estiver desenvolvendo esse projeto para Android, não será necessário instalar o pacote Plug-in ARKit XR.If you are developing this project for Android, there is no need to install the ARKit XR Plugin package. Da mesma forma, se você estiver desenvolvendo esse projeto para iOS, não será necessário instalar o Plug-in ARCore XR.Similarly, if you are developing this project for iOS, you do not need to install the ARCore XR Plugin.

Configurar o MRTK para a Câmera do AR FoundationConfigure MRTK for AR Foundation Camera

Nesta seção, você aprenderá a configurar o MRTK para implantação em um dispositivo móvel.In this section, you will learn how to configure MRTK for deploying to a mobile device.

Na janela Hierarquia, selecione o objeto MixedRealityToolkit.In the Hierarchy window, select the MixedRealityToolkit object. Em seguida, na janela Inspetor, selecione a guia Câmera, clone o perfil da câmera e dê a ele um nome adequado, por exemplo, AzureSpatialAnchors_ARCameraProfile:Then in the Inspector window, select the Camera tab, clone the camera profile, and give it a suitable name, for example, AzureSpatialAnchors_ARCameraProfile:

mr-learning-asa

Dica

Para lembrar como clonar perfis de MRTK, consulte as instruções em Configurando os perfis do Kit de Ferramentas de Realidade Misturada.For a reminder on how to clone MRTK profiles, you can refer to the Configuring the Mixed Reality Toolkit profiles instructions.

Com a guia Câmera ainda selecionada na janela Inspetor, expanda os Provedores de Configuração da Câmera e clique no botão + Adicionar Provedor de Configuração de Câmera e, em seguida, expanda o Novo provedor de dados 1 adicionado recentemente:With the Camera tab still selected in the Inspector window, expand the Camera Setting Providers and click the + Add Camera Setting Provider button, then expand the newly added New data provider 1:

mr-learning-asa

Usando a lista suspensa Tipo, altere o tipo para Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:Using the Type dropdown, change the type to Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:

mr-learning-asa

Com o objeto MixedRealityToolkit ainda selecionado na janela Hierarquia, use o botão Adicionar Componente na janela Inspetor para adicionar os seguintes componentes:With the MixedRealityToolkit object still selected in the Hierarchy window, use the Add Component button in the Inspector window to add the following components:

  • AR Anchor Manager (Script)AR Anchor Manager (Script)
  • DisableDiagnosticsSystem (Script)DisableDiagnosticsSystem (Script)

mr-learning-asa

Observação

Quando você adiciona o componente AR Reference Point Manager (Script), o componente AR Session Origin (Script) é adicionado automaticamente, pois é exigido pelo componente AR Reference Point Manager (Script).When you add the AR Reference Point Manager (Script) component, the AR Session Origin (Script) component is automatically added because it is required by the AR Reference Point Manager (Script) component.

Compilar o aplicativo para seu dispositivo AndroidBuilding your application to your Android device

Nesta seção, você aprenderá a configurar seu projeto para compilá-lo e implantá-lo em um dispositivo Android.In this section, you will learn how to configure your project to build and deploy it to an Android device.

No menu do Unity, selecione Arquivo > Configurações de Build... para abrir a janela Configurações de Build e, em seguida, alterne a plataforma para Android:In the Unity menu, select File > Build Settings... to open the Build Settings window and then switch the platform to Android:

mr-learning-asa

Dica

Para lembrar como mudar a plataforma de build, consulte as instruções em Como alternar a plataforma de build.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

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

No menu do Unity, selecione Kit de Ferramentas de Realidade Misturada > Utilitários > Configurar Projeto do Unity para abrir a janela do Configurador de Projeto do MRTK, confirme se todas as opções estão selecionadas e clique no botão Aplicar para aplicar as configurações:In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

mr-learning-asa

No menu do Unity, selecione Editar > Configurações de Projeto... para abrir a janela Configurações do Player, então localize a seção Player > Outras Configurações, selecione Vulkan e remova-o clicando no símbolo de "-" :In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, select Vulkan and remove it by clicking the "-" symbol:

mr-learning-asa

Feche a janela Configurações do Player e abra a janela Configurações de Build novamente.Close the Player Settings window and open the Build Settings window again.

Na janela Configurações de Build, clique no botão Adicionar Cenas Abertas para adicionar a cena atual à lista de Cenas no Build.In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list. Em seguida, use um cabo USB, conecte seu dispositivo Android ao seu computador e selecione-o na lista suspensa Executar Dispositivo:Then, use a USB cable, connect your Android device to your computer and select it from the Run Device dropdown:

mr-learning-asa

Observação

Se o dispositivo não aparecer na lista suspensa Executar Dispositivo, pode ser necessário pressionar o botão Atualizar ao lado do menu suspenso.If your device does not appear in the Run Device dropdown, you might need to press the Refresh button next to the dropdown.

Na janela Configurações de Build, clique no botão Compilar e Executar para abrir a janela Compilar Android.In the Build Settings window, click the Build And Run button to open the Build Android window.

Escolha um local adequado para armazenar o build, por exemplo, D:\MixedRealityLearning\Builds e dê ao APK um nome adequado, por exemplo, MRTKTutorials-AzureSpatialAnchors e clique no botão Salvar para iniciar o processo de build:Choose a suitable location to store your build, for example, D:\MixedRealityLearning\Builds, then give the apk a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and click the Save button to start the build process:

mr-learning-asa

Observação

Se você receber algum erro na janela do Console do Unity relacionado aos módulos SDK, NDK ou JDK do Android, será necessário abrir o Hub do Unity e instalar os módulos de Suporte de Build do Android associados.If you get any error in the Unity Console window related to Android SDK, NDK, or JDK modules, you need to open Unity Hub and install the associated Android Build Support modules.

Quando o processo de build for concluído, os aplicativos deverão ser carregados automaticamente em seu dispositivo Android.When the build process is complete, your apps should automatically load on your Android device.

Compilar o aplicativo para seu dispositivo iOSBuilding your application to your iOS device

Nesta seção, você aprenderá a configurar seu projeto para compilá-lo e implantá-lo em seu dispositivo iOS.In this section, you will learn how to configure your project, to build and deploy it to your iOS device.

No menu do Unity, selecione Arquivo > Configurações de Build... para abrir a janela Configurações de Build e alterne a plataforma para iOS:In the Unity menu, select File > Build Settings... to open the Build Settings window and switch platform to iOS:

mr-learning-asa

Dica

Para lembrar como mudar a plataforma de build, consulte as instruções em Como alternar a plataforma de build.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

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

No menu do Unity, selecione Kit de Ferramentas de Realidade Misturada > Utilitários > Configurar Projeto do Unity para abrir a janela do Configurador de Projeto do MRTK, confirme se todas as opções estão selecionadas e clique no botão Aplicar para aplicar as configurações:In the Unity menu, select Mixed Reality Toolkit > Utilities > Configure Unity Project to open the MRTK Project Configurator window, ensure all options are selected, then click the Apply button to apply the settings:

mr-learning-asa

No menu do Unity, selecione Editar > Configurações de Projeto... para abrir a janela Configurações do Player, então localize a seção Player > Outras Configurações, desmarque a caixa de seleção Remover Código do Mecanismo para desabilitá-la:In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Other Settings section, uncheck the Strip Engine Code checkbox to disable it:

mr-learning-asa

Feche a janela Configurações do Player e abra a janela Configurações de Build novamente.Close the Player Settings window and open the Build Settings window again.

Na janela Configurações de Build, clique no botão Adicionar Cenas Abertas para adicionar a cena atual à lista de Cenas no Build:In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list:

mr-learning-asa

Na janela Configurações de Build, clique no botão Compilar para abrir a janela Compilar iOS.In the Build Settings window, click the Build button to open the Build iOS window.

Escolha um local adequado para armazenar o projeto do Xcode, por exemplo, D:\MixedRealityLearning\Builds, crie uma pasta e dê a ela um nome adequado, por exemplo, MRTKTutorials-AzureSpatialAnchors e, em seguida, clique no botão Selecionar Pasta para iniciar o processo de build:Choose a suitable location to store your Xcode project, for example, D:\MixedRealityLearning\Builds, create a new folder and give it a suitable name, for example, MRTKTutorials-AzureSpatialAnchors, and then click the Select Folder button to start the build process:

mr-learning-asa

Quando o processo de build for concluído, siga as instruções de Exportar o projeto do Xcode para aprender a implantar o projeto do Xcode em seu dispositivo iOS.When the build process is complete, follow the Export the Xcode project instructions to learn to deploy your Xcode project to your iOS device.

ParabénsCongratulations

Neste tutorial, você aprendeu a criar o projeto para dispositivos Android e iOS usando o AR Foundation, o Plug-in ARCore XR e o Plug-in ARKit XR.In this tutorial, you learned how to build your project to Android and iOS devices using AR Foundation, ARCore XR Plugin, and ARKit XR Plugin.