Table of Contents

Configuración de easyar

La página de configuración de EasyAR se puede acceder desde el menú de Unity EasyAR > Sense > Configuration o Edit > Project Settings > EasyAR.

alt text

Contiene todas las configuraciones globales para EasyAR Sense Unity Plugin

alt text

Initialize on startup

Inicializa EasyAR al inicio. Generalmente se recomienda mantener esta opción activada.

Si se desactiva esta opción, se debe inicializar EasyAR Sense manualmente, como se describe en Inicialización de EasyAR Sense.

EasyAR Sense License

Configuración relacionada con la licencia de EasyAR Sense.

LicenseKey

Clave de licencia de EasyAR Sense. Es obligatorio proporcionar una licencia válida para utilizar las funciones de EasyAR.

Solo se puede dejar vacío si se inicializa EasyAR Sense manualmente mediante la interfaz.

Nota

Al usar dispositivos de auriculares (Vision Pro, XREAL, Pico, Rokid, etc.), se requiere una licencia EasyAR XR.

Nota

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.

Verify When Build

Verificar la clave de licencia al compilar el proyecto de Unity.

Cuando esta opción está activada, el proceso de compilación del proyecto Unity verificará la clave de licencia. Si la licencia no es válida para la plataforma de compilación o no incluye el nombre del paquete configurado en Unity Player Settings, el proceso de compilación fallará. Desactiva esta opción si necesitas usar una clave de licencia configurada en otro lugar o si necesitas modificar el nombre del paquete después del proceso de compilación de Unity.

Variantes de lib

Configuración de variantes de biblioteca de EasyAR Sense.

EasyAR Sense License

Configuración relacionada con la licencia de EasyAR Sense.

LicenseKey

Clave de licencia de EasyAR Sense. Es obligatorio proporcionar una licencia válida para utilizar las funciones de EasyAR.

Solo se puede dejar vacío si se inicializa EasyAR Sense manualmente mediante la interfaz.

Nota

Al usar dispositivos de auriculares (Vision Pro, XREAL, Pico, Rokid, etc.), se requiere una licencia EasyAR XR.

Nota

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.

Verify When Build

Verificar la clave de licencia al compilar el proyecto de Unity.

Cuando esta opción está activada, el proceso de compilación del proyecto Unity verificará la clave de licencia. Si la licencia no es válida para la plataforma de compilación o no incluye el nombre del paquete configurado en Unity Player Settings, el proceso de compilación fallará. Desactiva esta opción si necesitas usar una clave de licencia configurada en otro lugar o si necesitas modificar el nombre del paquete después del proceso de compilación de Unity.

Permisos

Configuración de permisos de la aplicación. Generalmente se recomienda mantener los valores predeterminados.

Excepto el permiso de cámara, las demás configuraciones de permisos no se pueden modificar y están determinadas por otras configuraciones de funcionalidad.

Permiso Modificable Condición de activación Descripción del permiso
Cámara Sí Permiso de cámara, necesario para usar dispositivos de cámara
AndroidMicrophone No Variante es VideoRecording Permiso de micrófono, necesario para la función de grabación de pantalla
Ubicación No Paquete de soporte Mega importado Permiso de ubicación (precisa), necesario para usar EasyAR Mega

Unity XR

Configuración relacionada con el framework Unity XR (AR Foundation, etc.).

Soporte para AR foundation

Interruptor de soporte para AR Foundation, se recomienda mantenerlo activado.

En casos muy específicos, como al necesitar AR Foundation 4 o si una actualización causa errores de compilación, se puede desactivar esta opción, pero todas las funciones relacionadas con AR Foundation en el plugin quedarán deshabilitadas simultáneamente.

Nota

Después de modificar esta opción, los scripts se recompilarán automáticamente.

Cambio automático de Unity XR

Configuración de la función de cambio automático de objetos Unity XR (como AR Foundation).

  • Editor : Opciones en modo edición
    • Deshabilitar sesión AR : Cuando existe ARSession, deshabilita ARSession de AR Foundation durante la edición.
  • Reproductor : Opciones en modo ejecución
    • Habilitar : Activa el control en tiempo de ejecución. Nota: al desactivar esta opción, los componentes deshabilitados en modo edición no se restaurarán durante la ejecución.
    • Habilitar si es escritorio : Se activa en Windows/Mac.
    • Habilitar si móvil AR al inicio : Si, al iniciar el conmutador, el loader de AR móvil (ARKit/ARCore) está activo, se habilita. Normalmente, esta opción requiere que Initialize XR on Startup en XR Plug-in Management esté seleccionado.
    • Deshabilitar si no es AR móvil post-inicio : Si, al iniciar el conmutador, existen otros loaders además de AR móvil (ARKit/ARCore), pero ninguno está activo, se deshabilita. Normalmente, esta opción se usa cuando Initialize XR on Startup en XR Plug-in Management no está seleccionado.
    • Restaurar sesión AR cuando esté deshabilitada : Cuando la función está deshabilitada, restaura (habilita) todas las sesiones AR de AR Foundation que fueron deshabilitadas (independientemente de si fueron deshabilitadas por EasyAR). Esta opción se usa normalmente para restaurar componentes deshabilitados durante la edición.

Para una explicación detallada, consulta Cambio automático de Unity XR.

Mega

Configuración de la función EasyAR Mega.

Soporte para InertialCameraDevice

Opción de solo lectura, muestra si la funcionalidad de navegación inercial está disponible y la información del entorno de ejecución ONNX.

Si la información mostrada no cumple con los requisitos, modifique las opciones Lib Variants y ONNX Runtime (Bundled) según sea necesario.

Mega block > Acceso al servicio de localización [Global]

Configuración global del servidor de localización para Mega Block.

Mega landmark > Acceso al servicio de localización [Global]

Configuración global del servidor de localización para Mega Landmark.

Mapa espacial

Configuración de la función de mapa espacial de EasyAR.

Acceso al servicio [Global]

Configuración global del servidor de mapas dispersos.

Seguimiento de imágenes

Configuración de la función de seguimiento de imágenes de EasyAR.

Gizmo de objetivo

Configuración de Gizmos para ImageTarget en el editor.

Activar estas opciones mostrará los gizmos correspondientes en Unity Editor. Si hay demasiados targets de este tipo en la escena, podría afectar el rendimiento de inicio en el editor. El rendimiento durante la ejecución en dispositivos no se verá afectado.

Reconocimiento en nube (CRS) > Acceso al servicio [Global]

Configuración global del servidor de reconocimiento en la nube.

Seguimiento de objetos

Configuración de la función de seguimiento de objetos de EasyAR.

Gizmo de objetivo

Configuración de Gizmos para ObjectTarget en el editor.

  • Habilitar: Activa los Gizmos.

Bibliotecas de terceros

Configuración de bibliotecas de terceros.

Configuración de arcore sdk

ARCore SDK proporciona capacidades de seguimiento de movimiento en algunos dispositivos Android. Puedes leer Seguimiento de movimiento y funciones de EasyAR para comprender la relación entre las funciones de EasyAR y el seguimiento de movimiento, y cuándo es necesario usar ARCore.

  • AR Foundation Or Optional: El SDK de ARCore distribuido con EasyAR o AR Foundation se incluirá en la aplicación, según la configuración de ARCore XR Plugin. Generalmente se recomienda esta opción, ya que maneja automáticamente los casos de AR Foundation.
  • Optional: La funcionalidad de ARCore estará disponible en dispositivos compatibles con ARCore que tengan instalado Google Play Services for AR.
  • Required: La aplicación solo funcionará en dispositivos compatibles con ARCore con Google Play Services for AR instalado.
  • External: Úsalo si estás utilizando la distribución de AR Foundation u otro SDK de ARCore. Así, el SDK de ARCore distribuido con EasyAR no se utilizará. También puedes usar esta opción para excluir completamente el SDK de ARCore de la aplicación.
Precaución

Si configuras ARCore SDK como Required, o en la configuración de ARCore de AR Foundation estableces Requirement como 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 falsa apariencia de que estos dispositivos están ejecutando ARCore y funcionando mal (pantalla negra u otros comportamientos anómalos), lo cual es incorrecto.

Este fenómeno ocurre porque Google Play Store impide la instalación de aplicaciones que marcan ARCore como requerido en dispositivos no compatibles, por lo que estas aplicaciones siempre asumen que se ejecutan en dispositivos compatibles.

En una configuración normal, estos dispositivos determinarán que ARCore no es compatible durante el ensamblaje de la sesión y utilizarán las funciones de EasyAR.

Para una explicación detallada de Optional y Required, y otras configuraciones necesarias para publicar aplicaciones en Google Play Store, consulta la documentación de Google (China continental, Internacional).

Nota

En EasyAR Sense Unity Plugin, los archivos de biblioteca y la configuración necesarios para la compatibilidad con ARCore ya están en el paquete del plugin, pero para ejecutarlo en un teléfono, aún se requiere instalar Google Play Services for AR en el dispositivo.

Hay tres fuentes diferentes de SDK de ARCore disponibles:

  • Usar el SDK de ARCore distribuido con el plugin

    El plugin incluye una versión integrada del SDK de ARCore. Para más detalles, consulta Compatibilidad de versiones de ARCore, AR Engine. Al usar la envoltura de ARCore de EasyAR, no es necesario importar AR Foundation por separado.

  • Usar el SDK de ARCore de AR Foundation

    Si necesitas usar el SDK de ARCore de AR Foundation, consulta la documentación de Google (China continental, Internacional) para configurarlo. En este caso, la opción ARCore SDK debe ser AR Foundation Or Optional o External.

  • Usar otro SDK de ARCore

    Si tienes otro plugin de terceros o una distribución del SDK de ARCore dentro del proyecto, también puedes usar esos SDK de ARCore. En este caso, la opción ARCore SDK debe ser External, y debes configurarlo según los requisitos específicos del plugin o proyecto.

Advertencia: compilación habilitada para ARCore solo de 32 bits

Según la documentación de Google, ARCore no funcionará correctamente en dispositivos arm64 si el programa solo tiene bibliotecas armv7. Al compilar sin seleccionar ARM64, aparecerá una advertencia:

alt text

En este caso, debes modificar la configuración del proyecto, compilar con IL2CPP y seleccionar soporte para ARM64.

alt text

Precaución

Si es realmente necesario, puedes seleccionar Continuar y no advertirme de nuevo, o desactivar esta opción, lo que desactivará la verificación durante la compilación. Desactivar la verificación solo suprime la advertencia al compilar, pero durante la ejecución podrían ocurrir anomalías en algunos dispositivos, incluyendo, entre otros, bloqueos o pantallas negras.

Configuración de ar engine sdk

AR Engine SDK proporciona capacidades de seguimiento de movimiento en algunos dispositivos Android. Puedes leer Seguimiento de movimiento y funciones de EasyAR para comprender la relación entre las funciones de EasyAR y el seguimiento de movimiento, y cuándo es necesario usar AR Engine.

  • AREngineInterop: AREngineInterop está disponible. El SDK de AR Engine distribuido con EasyAR se incluirá en la aplicación.
  • External: AREngineInterop está disponible. El SDK de AR Engine distribuido con EasyAR no se utilizará.
  • Disabled: AREngineInterop no está disponible. El SDK de AR Engine distribuido con EasyAR no se utilizará. Todas las funciones relacionadas con AR Engine se desactivarán.

Onnx runtime (bundled)

Si se usa el entorno de ejecución ONNX empaquetado. Solo es efectivo cuando Lib Variant es Full.

Si necesitas usar una versión diferente de ONNX, puedes obtener una versión actualizada desde el sitio oficial de ONNX y desactivar esta opción. Usar binarios de ONNX compilados por ti mismo que no sean compatibles causará errores desconocidos.

Soluciones alternativas para Unity

Soluciones para bugs o comportamientos irracionales de Unity.

GenerateXMLDoc

Genera documentación XML cuando se recarga el script para que funcione IntelliSense en la documentación de la API.

URP17RG_DX11_RuinedScene

Solución alternativa para URP 17 Render Graph DX11 donde la escena se renderiza corrupta. Esta opción está desactivada en Unity 6.2 y versiones posteriores.

URP17RG_IOS_Glitches_Partial

Solución alternativa parcial para Unity Issue UUM-87787.

Descripción del problema: cuando se obtiene la textura de la cámara desde EasyAR (como se usa en el ejemplo ImageTracking_Coloring3D y en el ejemplo ARSession Workflow (CameraDevice)), se pueden observar fallos visuales y artefactos en dispositivos iOS/Mac. Hemos reproducido el problema en un paquete Unity puro y lo hemos reportado a Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Para el progreso del problema, siga las actualizaciones en Unity Issue UUM-87787 y las notas de lanzamiento de futuras versiones de Unity.