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

Aquí se incluyen todas las configuraciones globales del Plugin de Unity de EasyAR Sense

alt text

Inicializar al inicio

Inicializar EasyAR al inicio. Por lo general, se recomienda mantener esta opción activada.

Si se desactiva esta opción, se debe inicializar EasyAR Sense manualmente. Para obtener más detalles, consulte Inicializar 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 la biblioteca

Configuración de las variantes de la biblioteca de EasyAR Sense.

EasyAR Sense suele tener varias variantes, con diferencias de funcionalidad entre ellas. Aquí se presenta una comparación de las variantes de biblioteca integradas en el plugin.

Variant Nombre de variante de EasyAR Sense Diferencia de funcionalidad Otras particularidades
Normal Community/Enterprise No incluye grabación de pantalla ni navegación inercial
Full CommunityFull/EnterpriseFull Incluye navegación inercial y otras funciones de Mega El tamaño del archivo de biblioteca es mayor
VideoRecording CommunityR Incluye función de grabación de pantalla (solo Android)
Consejo

Algunas variantes que no se pueden usar en Unity no están incluidas en la lista, por ejemplo, la variante CommunityR para iOS.

Valor predeterminado:

  • Sin importar el paquete de soporte de EasyAR Mega: Normal
  • Con el paquete de soporte de EasyAR Mega importado: Full

Configuración recomendada:

  • Full : para usar EasyAR Mega o la función de navegación inercial
  • Normal : para buscar el tamaño de paquete mínimo, y no usar EasyAR Mega ni el soporte de navegación inercial
  • VideoRecording : necesita usar la función de grabación de pantalla (solo Android)

Permisos

Configuración de los permisos de la aplicación. Por lo general, se recomienda mantener los valores predeterminados.

Excepto el permiso de cámara, las otras configuraciones de permisos no se pueden modificar y se determinan por otras configuraciones de funciones.

Permiso ¿Se puede modificar? Condiciones de activación Descripción del permiso
Cámara Sí Permiso de cámara, necesario para utilizar el dispositivo de cámara
AndroidMicrophone No Variant es VideoRecording Permiso de micrófono, necesario para utilizar la función de grabación de pantalla
Ubicación No Importar el paquete de soporte Mega Permiso de localización (detallada), necesario para utilizar EasyAR Mega

Unity XR

Configuraciones relacionadas con el marco de Unity XR (AR Foundation, etc.).

Soporte para AR Foundation

Interruptor de soporte para AR Foundation. Se recomienda mantenerlo activado.

En casos muy excepcionales, como cuando se necesita utilizar AR Foundation 4 o una actualización de AR Foundation causa errores de compilación, se puede desactivar esta opción, pero todas las funciones relacionadas con AR Foundation en el plugin se deshabilitarán al mismo tiempo.

Nota

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

Cambio automático de Unity XR

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

  • Editor: Opciones del modo de edición
    • Deshabilitar sesión AR: Cuando existe ARSession, deshabilitar la sesión AR de AR Foundation durante la edición.
  • Player: Opciones del modo de ejecución
    • Habilitar: Habilitar el control en tiempo de ejecución. Nota: Si se desactiva esta opción, los componentes deshabilitados en el modo de edición no se restaurarán en tiempo de ejecución.
    • Habilitar si es de escritorio: Habilitar en Windows/Mac.
    • Habilitar si el AR móvil está activado al inicio: Si el cargador de AR móvil (ARKit/ARCore) está activado al inicio del switcher, habilitar. Por lo general, esta opción requiere que Inicializar XR al inicio en XR Plug-in Management esté seleccionado.
    • Deshabilitar si no hay ningún cargador de AR móvil después del inicio: Si existe un cargador diferente al de AR móvil (ARKit/ARCore) después del inicio del switcher, pero ningún cargador está activado, deshabilitar. Por lo general, esta opción se utiliza cuando Inicializar XR al inicio en XR Plug-in Management no está seleccionado.
    • Restablecer la sesión AR cuando se deshabilita: Cuando la función está deshabilitada, restaurar (habilitar) todas las sesiones AR de AR Foundation deshabilitadas (independientemente de si se han deshabilitado por EasyAR). Esta opción se utiliza generalmente para restaurar los componentes deshabilitados durante la edición.

Para obtener una descripción detallada de la función, consulte Cambio automático de Unity XR.

Mega

Configuración de la función de EasyAR Mega.

Soporte para Bloque/Límite Mega

¿Activar el soporte para Bloque/Límite Mega?

Esta opción se activará automáticamente después de importar com.easyar.mega y estará desactivada por defecto si no se ha importado.

Soporte para InertialCameraDevice

Opción de solo lectura que muestra si la función de inercia es disponible en la configuración actual.

Si la información mostrada no es la deseada, es necesario modificar la opción Variantes de la biblioteca según sea necesario.

Soporte para ONNX

Opción de solo lectura que muestra la información de tiempo de ejecución de ONNX en la configuración actual.

Si la información mostrada no es la deseada, es necesario modificar las opciones Variantes de la biblioteca y ONNX Runtime (Integrado) según sea necesario.

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

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

Mega Límite > Acceso al servicio de localización [Global]

Configuración del servidor de localización de Mega Límite global.

Mapa espacial

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

Acceso al servicio [Global]

Configuración del servidor de mapa esparso global.

Seguimiento de imágenes

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

Gizmo del objetivo

Configuración de los Gizmos de ImageTarget en el editor.

Activar estas opciones mostrará el gizmo correspondiente en el Unity Editor. Si hay demasiados objetivos de este tipo en la escena, puede afectar al rendimiento de arranque en el editor. El rendimiento en el dispositivo durante la ejecución no se ve afectado.

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

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

Seguimiento de objetos

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

Gizmo del objetivo

Configuración de los Gizmos de ObjectTarget en el editor.

  • Activar: Activar los Gizmos.

Bibliotecas de terceros

Configuración de bibliotecas de terceros.

ARCore SDK

Configuración del SDK de ARCore.

ARCore proporciona la capacidad de seguimiento de movimiento en algunos dispositivos Android. Puedes leer Seguimiento de movimiento y funciones de EasyAR para conocer la relación entre las funciones de EasyAR y el seguimiento de movimiento, así como si es necesario y cuándo 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 del complemento XR de ARCore. En general, se recomienda usar esta opción, ya que manejará automáticamente la situación de AR Foundation.
  • Optional: La función de ARCore estará disponible en dispositivos que admitan ARCore y tengan instalados Google Play Services for AR.
  • Required: La aplicación solo se podrá ejecutar en dispositivos que admitan ARCore y tengan instalados Google Play Services for AR.
  • External: Si estás usando AR Foundation u otra distribución del SDK de ARCore, puedes usar esta opción. De este modo, el SDK de ARCore distribuido con EasyAR no se utilizará. También puedes usar esta opción para excluir por completo el uso del SDK de ARCore en la aplicación.
Precaución

Si se configura ARCore SDK como Required, o se establece Requirement como Required en la configuración de ARCore de AR Foundation, y se instala la aplicación empaquetada en un dispositivo que no admita ARCore, el dispositivo informará erróneamente que ARCore está disponible y se ejecutará con ARCore. Esto creará una falsa impresión de que estos dispositivos están ejecutando ARCore y no funcionan correctamente (pantalla negra u otros problemas anómalos), pero esto es incorrecto.

Este fenómeno se debe a que la Tienda Google Play impide la instalación de aplicaciones que marcan ARCore como necesario en dispositivos no admitidos, por lo que estas aplicaciones siempre asumen que se están ejecutando en dispositivos compatibles.

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

Para obtener una descripción detallada de Optional y Required, así como otras configuraciones necesarias para publicar una aplicación en la Tienda Google Play, consulta la documentación de Google (China continental, Internacional).

Nota

En el complemento de Unity de EasyAR Sense, los archivos de biblioteca y la configuración necesarios para el soporte de ARCore ya se encuentran en el paquete del complemento, pero para ejecutarlo en un teléfono, aún es necesario instalar Google Play Services for AR en el teléfono.

Hay tres fuentes diferentes de SDK de ARCore disponibles:

  • Usar el SDK de ARCore distribuido con el complemento

    El complemento integra una versión del SDK de ARCore. Puedes consultar Compatibilidad de versiones de ARCore y AR Engine para obtener información detallada. Al usar la encapsulación de ARCore de EasyAR, no es necesario importar adicionalmente AR Foundation.

  • Usar el SDK de ARCore de AR Foundation

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

  • Usar otro SDK de ARCore

    Si tienes otros complementos de terceros o un proyecto con una distribución del SDK de ARCore, también puedes usar estos SDK de ARCore. En este caso, la opción ARCore SDK debe ser External, y debes configurarlo según los requisitos específicos del complemento o proyecto.

Warn 32-bit-only ARCore-enabled build

Según la documentación de Google, ARCore no funcionará correctamente en dispositivos arm64 si se ejecuta un programa con solo archivos de biblioteca armv7. Si no se selecciona ARM64 al empaquetar, se mostrará una advertencia:

alt text

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

alt text

Precaución

Si es necesario, puedes seleccionar Continue and don't warn me again o desactivar esta opción, lo que deshabilitará la comprobación al empaquetar. Deshabilitar la comprobación solo evita que se muestre la advertencia al empaquetar, pero en tiempo de ejecución puede haber problemas en algunos dispositivos, como bloqueos o pantallas negras.

AR Engine SDK

Configuración del SDK de AR Engine.

AR Engine proporciona la capacidad de seguimiento de movimiento en algunos dispositivos Android. Puedes leer Seguimiento de movimiento y funciones de EasyAR para conocer la relación entre las funciones de EasyAR y el seguimiento de movimiento, así como si es necesario y cuándo 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 deshabilitarán.

ONNX Runtime (Bundled)

Indica si se debe usar el tiempo de ejecución de ONNX incorporado. Solo es válido cuando Lib Variant es Full.

Si necesitas usar una versión diferente de ONNX, puedes obtener una versión más reciente del sitio oficial de ONNX y desactivar esta opción. Usar una versión binaria de ONNX que no sea compatible con la compilación propia puede causar errores desconocidos.

Solución de problemas para Unity

Soluciones para errores o comportamientos no deseados 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.