Table of Contents

Uso de license key para inicializar EasyAR Sense

Para usar EasyAR en Unity, se necesita inicializar EasyAR Sense con una license key para garantizar que las funciones estén activadas. Hay dos formas de inicialización: inicialización automática e inicialización manual.

Después de una inicialización exitosa, se puede ver la versión de EasyAR Sense y la información de la plataforma de ejecución a través de la consola de Unity o del registro del sistema operativo, por ejemplo:

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Antes de comenzar

  • Licencia de EasyAR Sense describe cómo obtener una licencia de EasyAR Sense (license key). Antes de inicializar EasyAR Sense, es necesario preparar una licencia adecuada según los dispositivos reales utilizados y la etapa de desarrollo.

Inicialización automática

La inicialización automática es adecuada para la mayoría de los escenarios de uso.

Abre Configuración global de EasyAR, marca la opción Initialize On Startup y completa EasyAR Sense License > LicenseKey

texto alt

La inicialización automática se llama automáticamente en el punto temporal BeforeSceneLoad de Unity.

Nota

La license utilizada en el editor no verifica el nombre del paquete de la aplicación, por lo que una license que funcione correctamente en el editor aún podría fallar cuando se ejecuta en la aplicación o app de la plataforma empaquetada. En estos casos, hay que prestar atención a dos situaciones:

  1. El nombre del paquete de la license completada debe coincidir con el bundle id/package name completado en Unity Player Settings.
  2. Si Unity empaqueta y luego se modifica el nombre del paquete en el proyecto de gradle o XCode. En este caso, se debe usar el nombre del paquete de gradle o XCode en Unity.

[Opcional] Inicialización manual

La inicialización manual se utiliza principalmente para flujos de inicialización personalizados, como mostrar una declaración de privacidad del usuario antes de llamar a la interfaz de EasyAR (consulta la guía de cumplimiento).

Abre Configuración global de EasyAR y desmarca la opción Initialize On Startup.

texto alt

Luego usa la interfaz EasyARController.Initialize() para llamar manualmente a la inicialización.

Se puede pasar la license como parámetro,

EasyARController.Initialize("my-license");

o usar la license completada en Configuración global de EasyAR,

EasyARController.Initialize();
Importante

EasyARController.Initialize() debe llamarse antes de iniciar ARSession.

En algunos casos especiales, si se necesita llamar EasyARController.Initialize() varias veces, se debe garantizar que después de cada ejecución de EasyARController.Initialize() se realice una desinicialización mediante EasyARController.Deinitialize().

Solución para inicialización fallida

Después de ejecutar una escena que contiene ARSession, si el registro no contiene información similar, significa que la inicialización falló.

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

En el editor de Unity, también se puede ver un cuadro emergente como este

texto alt

Nota

Es importante leer la información de texto mostrada en el cuadro emergente, no todos los cuadros emergentes indican fallo de inicialización.

Los mensajes de error comunes y sus causas son:

  • EasyARSettings is not found
    • No se ha creado el archivo de recursos de Configuración global de EasyAR (común cuando no se completa la license)
  • License Key is empty
    • No se ha completado la license en Configuración global de EasyAR, o existen múltiples archivos de recursos de Configuración global de EasyAR en el proyecto
  • EasyARController.Initialize is not called (InitializeOnStartup = false)
    • La inicialización manual no se llamó en el momento correcto
  • EasyAR stops after script change in play mode
    • Durante la ejecución en el editor, se modificó el script. En este caso, solo se necesita volver a ejecutar

Temas relacionados