Habilitar AR Foundation en proyectos EasyAR
Si necesitas habilitar la compatibilidad de AR Foundation en EasyAR o utilizar otras funciones de AR Foundation, debes instalar y configurar correctamente AR Foundation. A continuación se explica cómo realizar estas operaciones.
Antes de comenzar
- Lee Compatibilidad de EasyAR con el marco XR de Unity para conocer la compatibilidad de EasyAR con el marco XR de Unity y en qué casos puedes considerar usar AR Foundation.
Compatibilidad de versiones de AR Foundation
EasyAR admite AR Foundation 5 o versiones más recientes.
Importante
La compatibilidad con AR Foundation se implementa mediante una cámara personalizada.
Al usar productos de prueba (licencia personal, licencia XR de prueba o servicio Mega de prueba, etc.) en cámaras personalizadas o dispositivos de visualización, EasyAR Sense dejará de responder después de 100 segundos (los usuarios de Mega pueden ajustar la duración después de la aprobación a través del equipo comercial de EasyAR) cada vez que se inicie. No existe esta limitación al usar versiones pagadas de EasyAR Sense y el servicio EasyAR Mega pagado.
Instalar AR Foundation
Se recomienda consultar la documentación oficial de AR Foundation para instalar AR Foundation. Antes de leer, asegúrate de seleccionar la versión correspondiente de la documentación.
Unity 2022 y versiones más recientes
Si no se han instalado complementos XR en el proyecto, debes ir a Project Settings > XR Plug-in Management y hacer clic en el botón Install XR Plugin Management para instalar XR Plug-in Management. Espera a que se complete la instalación.
Si necesitas usar AR Foundation en la plataforma Android, marca Google ARCore en la pestaña Android y espera a que se complete la instalación.
Si necesitas usar AR Foundation en la plataforma iOS, marca Apple ARKit en la pestaña iOS y espera a que se complete la instalación.
Si necesitas usar AR Foundation en la plataforma visionOS, debes leer Configuración del proyecto para Vision Pro.
Consejo
Se recomienda mantener Initialize XR On Startup marcado para garantizar que AR Foundation se inicialice en el momento predeterminado.
Una vez completada la instalación, abre la ventana Package Manager. Verás que AR Foundation y los complementos de las plataformas correspondientes aparecen en la lista de paquetes instalados. Asegúrate de que los números de versión coincidan exactamente.
Importante
Al instalar o actualizar AR Foundation, asegúrate de que las versiones de Google ARCore XR Plugin y Apple ARKit XR Plugin coincidan exactamente con la versión de AR Foundation. Las versiones incompatibles pueden causar errores en tiempo de ejecución o funcionamiento anómalo.
Unity 2021
En Unity 2021, debes editar manualmente el archivo Packages/manifest.json para especificar la versión. Consulta la documentación oficial.
Por ejemplo, para instalar la versión 5.2.0 de AR Foundation y usarla en las plataformas Android e iOS, asegúrate de que el archivo Packages/manifest.json contenga lo siguiente:
{
"dependencies": {
...
"com.unity.xr.arcore": "5.2.0",
"com.unity.xr.arfoundation": "5.2.0",
"com.unity.xr.arkit": "5.2.0",
...
}
}
Configurar XR Plug-in
Al usar EasyAR, generalmente ARCore no es esencial. Por lo tanto, configura ARCore como opcional para evitar que la aplicación no funcione en dispositivos no compatibles con ARCore.
En Project Settings > XR Plug-in Management > ARCore, establece Requirement y Depth en Optional.
Precaución
Si estableces Requirement en Required e instalas la aplicación compilada en un dispositivo no compatible con ARCore, el dispositivo informará erróneamente que ARCore está disponible y se ejecutará con ARCore. Esto creará la ilusión de que estos dispositivos ejecutan ARCore pero funcionan mal (pantalla negra u otros problemas), pero es incorrecto.
Este fenómeno ocurre porque Google Play Store impide la instalación de aplicaciones que marcan ARCore como obligatorio en dispositivos no compatibles. Por lo tanto, estas aplicaciones siempre asumen que se ejecutan en dispositivos compatibles.
En una configuración normal, estos dispositivos determinarán durante el ensamblaje de la sesión que ARCore no es compatible y usarán las funciones de EasyAR.
Si es necesario, también puedes consultar la documentación oficial para configurar ARCore y ARKit. Antes de leer, selecciona la versión correspondiente de la documentación.
Configurar Universal Render Pipeline
Si el proyecto actual utiliza URP, debes configurar los activos URP. Si no se configuran correctamente, la imagen de fondo de la cámara de AR Foundation podría no renderizarse correctamente.
Primero, asegúrate de haber configurado correctamente el Renderer Feature de URP de EasyAR. Consulta Configuración de Universal Render Pipeline para EasyAR.
Luego, en la lista de Renderer Features, agrega ARBackgroundRendererFeature.
Al igual que con la configuración del Renderer Feature de URP de EasyAR, debes prestar atención a la configuración en Project Settings > Quality para diferentes plataformas. Asegúrate de que todas las plataformas que necesitan usar AR Foundation utilicen activos URP configurados correctamente con ARBackgroundRendererFeature.
También puedes consultar la documentación oficial de configuración URP de AR Foundation. Antes de leer, selecciona la versión correspondiente de la documentación.
Nota
La Configuración de Universal Render Pipeline para EasyAR sigue siendo necesaria para garantizar que las funciones relacionadas con la interfaz de EasyAR se rendericen correctamente en dispositivos no compatibles con AR Foundation.
Habilitar la compatibilidad de AR Foundation en EasyAR
En Project Settings > EasyAR > Sense, asegúrate de que la opción Unity XR > AR Foundation Support esté habilitada. Esta opción está habilitada por defecto.
Modificar esta opción desencadenará una recompilación de scripts. Debes esperar a que se complete la compilación para que los cambios surtan efecto. Si Unity no desencadena la compilación correctamente por algún motivo, puedes cerrar Unity y eliminar la carpeta Library/ScriptAssemblies para forzar a Unity a recompilar los scripts.
Consejo
Si EasyAR es incompatible con AR Foundation en el proyecto y no necesitas usar ambos simultáneamente, puedes desactivar esta opción.
Pasos siguientes
- Aprende sobre Configuración y uso de escenas de AR Foundation en proyectos EasyAR
- Aprende cómo Cambiar automáticamente a AR Foundation según la compatibilidad del dispositivo