5. Azure Spatial Anchors para iOS y Android5. Azure Spatial Anchors for Android and iOS

En este tutorial, aprenderás a compilar un proyecto en dispositivos iOS y Android con AR Foundation, y los complementos ARCore XR y 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

  • Aprender a compilar el proyecto en el dispositivo Android mediante AR Foundation y el complemento ARCore XR de UnityLearn how to build your project to your Android device using Unity's AR Foundation and ARCore XR Plugin
  • Aprender a compilar el proyecto en su dispositivo iOS mediante AR Foundation y el complemento ARKit XR de UnityLearn how to build your project to your iOS device using Unity's AR Foundation and ARKit XR Plugin

Instalación de paquetes de Unity integradosInstalling inbuilt Unity packages

En esta sección, actualizará e instalará los siguientes paquetes integrados:In this section, you will upgrade and install the following inbuilt packages:

  • AR Foundation 3.1.3AR Foundation 3.1.3
  • XR Legacy Input Helpers 2.1.4XR Legacy Input Helpers 2.1.4
  • Complemento de ARCore XR 3.1.3 para la compatibilidad con AndroidARCore XR Plugin 3.1.3 for Android support
  • Complemento de ARKit XR 3.1.3 para la compatibilidad con iOSARKit XR plugin 3.1.3 for iOS support

Precaución

No todas las versiones son compatibles con MRTK y solo algunas funcionan juntas, por lo que debe asegurarse de que instala las versiones exactas mencionadas anteriormente.Not all version are compatible with MRTK and only certain version works together, so make sure you install the exact versions listed above.

En el menú de Unity, seleccione Ventana > Administrador de paquetes para abrir la ventana Package Manager (Administrador de paquetes) y, a continuación, seleccione AR Foundation > 3.1.3 y haga clic en el botón Update to 3.1.3 (Actualizar a 3.1.3) para actualizar el paquete: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:

Unity Package Manager con AR Foundation seleccionado

Siga el mismo proceso para importar los paquetes restantes según sea necesario.Follow the same process to import the remaining packages as needed.

Nota

Si desarrollas este proyecto para Android, no es necesario instalar el paquete del complemento ARKit XR.If you are developing this project for Android, there is no need to install the ARKit XR Plugin package. Del mismo modo, si desarrollas este proyecto para iOS, no es necesario que instales el complemento de ARCore XR.Similarly, if you are developing this project for iOS, you do not need to install the ARCore XR Plugin.

Configuración de MRTK para la cámara de AR FoundationConfigure MRTK for AR Foundation Camera

En esta sección, obtendrá información sobre cómo configurar MRTK para realizar la implementación en un dispositivo móvil.In this section, you will learn how to configure MRTK for deploying to a mobile device.

En la ventana Hierarchy (Jerarquía), seleccione el objeto MixedRealityToolkit.In the Hierarchy window, select the MixedRealityToolkit object. A continuación, en la ventana Inspector, seleccione la pestaña Camera (Cámara), clone el perfil de la cámara y asígnele un nombre adecuado, por ejemplo, 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:

Unity con ARCameraProfile recién creado seleccionado

Sugerencia

Para obtener un recordatorio sobre cómo clonar perfiles de MRTK, puede consultar las instrucciones del artículo Configuración de los perfiles de Mixed Reality Toolkit.For a reminder on how to clone MRTK profiles, you can refer to the Configuring the Mixed Reality Toolkit profiles instructions.

Con la pestaña Camera (Cámara) aún seleccionada en la ventana Inspector, expanda la opción Camera Setting Providers (Proveedores de configuración de la cámara), haga clic en el botón + Add Camera Setting Provider (+ Agregar proveedor de configuración de la cámara) y, luego, expanda la opción New data provider 1 (Nuevo proveedor de datos 1) recién agregada.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:

ARCameraProfile de Unity con un nuevo proveedor de datos agregado

Con la lista desplegable Typo (Tipo), cambie el tipo a Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:Using the Type dropdown, change the type to Microsoft.MixedReality.Toolkit.Experimental.UnityAR > UnityARCameraSettings:

ARCameraProfile de Unity con la ruta de acceso a la selección del tipo de proveedor de datos

En la ventana Hierarchy (Jerarquía), seleccione el objeto RoverExplorer y, a continuación, en la ventana Inspector, use el botón Agregar componente para agregar los componentes siguientes: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) (Administrador de delimitadores de AR [script])AR Anchor Manager (Script)
  • DisableDiagnosticsSystem (Script)DisableDiagnosticsSystem (Script)

Objeto MixedRealityToolkit de Unity con los componentes AR Anchor Manager y DisableDiagnosticsSystem agregadosUnity MixedRealityToolkit object with AR Anchor Manager and DisableDiagnosticsSystem components added

Nota

Cuando se agregue el componente AR Reference Point Manager (Script) (Administrador de puntos de referencia de AR [script]), se agregará automáticamente el componente AR Session Origin (Script) (Origen de la sesión de AR [script]) según lo requiere el componente AR Reference Point Manager (Script) (Administrador de puntos de referencia de AR [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.

Compilación de la aplicación en el dispositivo AndroidBuilding your application to your Android device

En esta sección, aprenderá a configurar el proyecto para compilarlo e implementarlo en un dispositivo Android.In this section, you will learn how to configure your project to build and deploy it to an Android device.

En el menú de Unity, seleccione File > Build Settings... (Archivo > Configuración de compilación) para abrir la ventana Build Settings (Configuración de compilación) y, luego, cambie la plataforma a Android.In the Unity menu, select File > Build Settings... to open the Build Settings window and then switch the platform to Android:

Ventana Build Settings (Configuración de compilación) de Unity con la plataforma Android seleccionada

Sugerencia

Para obtener un recordatorio sobre cómo cambiar la plataforma de compilación, puede consultar las instrucciones del artículo Cambio de la plataforma de compilación.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

Cierre la ventana Build Settings (Configuración de compilación).Close the Build Settings window.

En el menú de Unity, seleccione Mixed Reality Toolkit > Utilities > Configure Unity Project (Mixed Reality Toolkit > Utilidades > Configurar proyecto de Unity) para abrir la ventana MRTK Project Configurator (Configurador del proyecto MRTK). Asegúrese de que todas las opciones estén seleccionadas y, a continuación, haga clic en el botón Apply (Aplicar) para aplicar la configuración: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:

Ventana MRTK Project Configurator (Configurador del proyecto MRTK) de Unity para Android

En el menú de Unity, seleccione Edit > Project Settings... (Editar > Configuración del proyecto...) para abrir la ventana Player Settings (Configuración del jugador). A continuación, busque la sección Player > Other Settings (Jugador > Otra configuración), seleccione Vulkan y quítelo haciendo clic en el símbolo "-" .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:

Other Settings (Otra configuración) de Unity con Vulkan seleccionado

Cierra la ventana Player Settings (Configuración del reproductor) y vuelva a abrir la ventana Build Settings (Configuración de compilación).Close the Player Settings window and open the Build Settings window again.

En la ventana Configuración de compilación, haga clic en el botón Add Open Scenes (Agregar escenas abiertas) para agregar la escena actual a la lista Scenes In Build (Escenas de la compilación).In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list. A continuación, use un cable USB, conecte el dispositivo Android al equipo y selecciónelo en la lista desplegable Run Device (Ejecutar dispositivo):Then, use a USB cable, connect your Android device to your computer and select it from the Run Device dropdown:

Ventana Build Settings (Configuración de compilación) de Unity con escena agregada y Run Device (Ejecutar dispositivo) seleccionado

Nota

Si el dispositivo no aparece en la lista desplegable Run Device (Ejecutar dispositivo), puede que tenga que presionar el botón Refresh (Actualizar) situado junto a dicha lista.If your device does not appear in the Run Device dropdown, you might need to press the Refresh button next to the dropdown.

En la ventana Configuración de compilación, haga clic en el botón Build and Run (Compilar y ejecutar) para abrir la ventana Build Android (Compilar Android).In the Build Settings window, click the Build And Run button to open the Build Android window.

Elija una ubicación adecuada para almacenar la compilación, por ejemplo, D:\MixedRealityLearning\Builds, asigne a apk un nombre adecuado, por ejemplo, MRTKTutorials-AzureSpatialAnchors y haga clic en el botón Save (Guardar) para iniciar el proceso de compilación: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:

Ventana Build Settings (Configuración de compilación) de Unity con la ventana de solicitud Save (Guardar) para Android

Nota

Si se produce algún error en la ventana Console (Consola) de Unity relacionado con los módulos SDK, NDK o JDK de Android, tienes que abrir Unity Hub e instalar los módulos asociados de compatibilidad con la compilación de Android.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.

Una vez que se complete el proceso de compilación, las aplicaciones deberían cargarse automáticamente en el dispositivo Android.When the build process is complete, your apps should automatically load on your Android device.

Compilación de la aplicación en el dispositivo iOSBuilding your application to your iOS device

En esta sección, aprenderá a configurar el proyecto para compilarlo e implementarlo en su dispositivo iOS.In this section, you will learn how to configure your project, to build and deploy it to your iOS device.

En el menú de Unity, seleccione File > Build Settings... (Archivo > Configuración de compilación...) para abrir la ventana Build Settings (Configuración de compilación) y, luego, cambie la plataforma a iOS.In the Unity menu, select File > Build Settings... to open the Build Settings window and switch platform to iOS:

Ventana Build Settings (Configuración de compilación) de Unity con iOS seleccionado

Sugerencia

Para obtener un recordatorio sobre cómo cambiar la plataforma de compilación, puede consultar las instrucciones del artículo Cambio de la plataforma de compilación.For a reminder on how to switch build platform, you can refer to the Switching the build platform instructions.

Cierre la ventana Build Settings (Configuración de compilación).Close the Build Settings window.

En el menú de Unity, seleccione Mixed Reality Toolkit > Utilities > Configure Unity Project (Mixed Reality Toolkit > Utilidades > Configurar proyecto de Unity) para abrir la ventana MRTK Project Configurator (Configurador del proyecto MRTK). Asegúrese de que todas las opciones estén seleccionadas y, a continuación, haga clic en el botón Apply (Aplicar) para aplicar la configuración: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:

Ventana MRTK Project Configurator (Configurador del proyecto MRTK) de Unity para iOS

En el menú de Unity, seleccione Edit > Project Settings... (Editar > Configuración del proyecto...) para abrir la ventana Player Settings (Configuración del jugador). A continuación, busque la sección Player > Other Settings (Jugador > Otra configuración) y desactive la casilla Strip Engine Code (Código del motor de franja).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:

Other Settings (Otra configuración) de Unity con Strip Engine Code (Código del motor de franja) deshabilitado

Cierre la ventana Player Settings (Configuración del reproductor) y vuelva a abrir la ventana Build Settings (Configuración de compilación).Close the Player Settings window and open the Build Settings window again.

En la ventana Configuración de compilación, haga clic en el botón Add Open Scenes (Agregar escenas abiertas) para agregar la escena actual a la lista Scenes In Build (Escenas de la compilación):In the Build Settings window, click the Add Open Scenes button to add your current scene to the Scenes In Build list:

Ventana Build Settings (Configuración de compilación) de Unity con la escena agregada

En la ventana Configuración de compilación, haga clic en el botón Build (Compilar) para abrir la ventana Build iOS (Compilar iOS).In the Build Settings window, click the Build button to open the Build iOS window.

Elija una ubicación adecuada para almacenar el proyecto Xcode, por ejemplo, D:\MixedRealityLearning\Builds, cree una carpeta nueva y asígnale un nombre adecuado, por ejemplo, MRTKTutorials-AzureSpatialAnchors y, luego, haga clic en el botón Select Folder (Seleccionar carpeta) para iniciar el proceso de compilación: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:

Ventana Build Settings (Configuración de compilación) de Unity con la ventana de solicitud Save (Guardar) para iOS

Una vez completado el proceso de compilación, siga las instrucciones del artículo Exportación del proyecto de Xcode para aprender a implementar el proyecto de Xcode en el 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.

EnhorabuenaCongratulations

En este tutorial, ha aprendido a compilar un proyecto en dispositivos iOS y Android con AR Foundation, y los complementos ARCore XR y 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.