Configuración y uso de escenas de ar foundation en proyectos easyar
En Unity, el uso de AR Foundation a menudo requiere depender de EasyAR para superar las limitaciones de dispositivos de AR Foundation. A continuación se explica cómo configurar y usar correctamente AR Foundation en escenas de EasyAR, y cómo habilitarlo dinámicamente según la compatibilidad del dispositivo.
Antes de comenzar
- Lee Soporte de easyar para el marco de trabajo xr de Unity para comprender el soporte de EasyAR para el marco de trabajo XR de Unity, y cuándo se puede considerar usar AR Foundation.
- Lee Habilitar ar foundation en proyectos easyar para aprender cómo instalar y configurar AR Foundation en proyectos de EasyAR.
Agregar componentes de ar foundation
Agregar AR Session de AR Foundation y XR Origin a escenas de EasyAR.
Agregar ar session
En la vista Hierarchy, haz clic derecho en un espacio vacío, luego selecciona XR > AR Session en el menú para agregar ARSession de Unity a la escena.
Nota
Esta AR Session es diferente a la AR Session de EasyAR; ambas deben coexistir en la escena.
Agregar xr origin
En la vista Hierarchy, haz clic derecho en un espacio vacío, luego selecciona XR > XR Origin (Mobile AR) en el menú para agregar XROrigin de Unity a la escena.
Nota
Este XR Origin se superpone funcionalmente con el XR Origin de EasyAR; se debe usar el XR Origin de Unity en lugar del de EasyAR.
Si la escena tenía previamente el XR Origin de EasyAR (generalmente llamado XR Origin (EasyAR)), mueve sus objetos hijos al nuevo XR Origin, luego elimina XR Origin (EasyAR).
Si el nuevo XR Origin no tiene un XR Origin Child, agrégalo manualmente.
En la vista Hierarchy, selecciona XR Origin, haz clic derecho y selecciona EasyAR Sense > Origin > Origin : XR Origin Child en el menú para agregar XR Origin Child bajo XR Origin.
Configurar cámara
Si la escena tenía una Camera para AR, ahora habrá una cámara principal adicional; elimina la cámara original.
Luego selecciona Main Camera bajo XR Origin y configúrala según las instrucciones en Configuraciones de cámara.
Finalmente, una escena de EasyAR completa con AR Foundation debería tener una estructura similar a esta:
Precaución
Si necesitas modificar la configuración de AR Foundation mediante ARCameraManager.currentConfiguration, ten en cuenta que algunos teléfonos (como el Xiaomi 10) tienen problemas: después de modificar la configuración no se pueden obtener imágenes, y EasyAR dejará de funcionar (la app muestra fondo pero sin funcionalidades de EasyAR). Por lo tanto, generalmente no se recomienda modificar; si es necesario, prepara un plan de contingencia para cuando EasyAR no funcione.
Compatibilidad de dispositivos y habilitación dinámica de ar foundation
EasyAR es compatible con más dispositivos que AR Foundation, por lo que se debe configurar para habilitar AR Foundation solo cuando sea necesario, y desactivarlo completamente en otros casos.
Verificar componentes de frame source
Generalmente, las sesiones creadas mediante el menú de EasyAR agregarán automáticamente ARCoreARFoundationFrameSource y ARKitARFoundationFrameSource (excepto para funciones como seguimiento de imágenes que no requieren SLAM).
Importante
ARCoreARFoundationFrameSource y ARKitARFoundationFrameSource son frame sources proporcionados por EasyAR para habilitar funciones de AR Foundation en dispositivos compatibles. Si la sesión en la escena no contiene estos frame sources, no se podrán habilitar las funciones de AR Foundation.
Si la sesión en la escena no tiene estos frame sources, agrégalos manualmente mediante el menú.
Para ejecutar en teléfonos no compatibles con AR Foundation, asegúrate de que la sesión también incluya frame sources distintos de AR Foundation. Una ARSession típica debería verse así:
Consejo
Puedes ordenar los frame sources según sea necesario. Durante la ejecución, la sesión seleccionará el primer frame source disponible según el orden de transformación y la compatibilidad del dispositivo.
Habilitar ar foundation solo cuando sea necesario
Dado que AR Foundation en teléfonos se implementa mediante ARCore y ARKit, solo funciona en dispositivos limitados, especialmente en muchos teléfonos Android chinos. Por lo tanto, generalmente se recomienda habilitar AR Foundation y los scripts de funcionalidad relacionados solo en dispositivos compatibles.
EasyAR puede automatizar esto mediante la opción Unity XR Auto Switch en Project Settings > EasyAR > Sense > Unity XR. Para más detalles, consulta Cambiar automáticamente objetos de unity xr.
Escenas que mantienen compatibilidad con ar foundation
Las escenas correctamente configuradas con componentes de AR Foundation funcionarán tanto con el paquete de AR Foundation instalado como sin él.
Sin AR Foundation instalado, las funciones de AR Foundation y sus frame sources correspondientes no estarán disponibles, y algunos scripts faltarán en la escena, lo cual es normal.
Consejo
Muchos samples funcionan tanto con como sin el paquete de AR Foundation instalado. Para habilitar soporte de AR Foundation en estos samples, solo necesitas Habilitar ar foundation en proyectos easyar.
Pasos siguientes
- Aprende a Cambiar automáticamente a ar foundation según la compatibilidad del dispositivo.
Temas relacionados
- Componentes de AR mencionados:
- AR Foundation proporciona capacidades de seguimiento de movimiento en algunos dispositivos. Para la relación entre seguimiento de movimiento y funciones de EasyAR, consulta:
- Para más información sobre configuración de escenas de AR Foundation, consulta la documentación oficial (selecciona la versión correspondiente):