Table of Contents

Utilizzo della license key per inizializzare EasyAR Sense

In Unity con EasyAR, è necessario inizializzare EasyAR Sense con una license key per garantire l'attivazione delle funzionalità. Sono disponibili due metodi di inizializzazione: automatica e manuale.

Dopo un'inizializzazione riuscita, è possibile vedere la versione di EasyAR Sense e le informazioni sulla piattaforma nella console Unity o nei log del sistema operativo, ad esempio:

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Prima di iniziare

  • EasyAR Sense License descrive come ottenere una licenza EasyAR Sense (license key). Prima di inizializzare EasyAR Sense, preparare una licenza appropriata in base ai dispositivi effettivamente utilizzati e alla fase di sviluppo.

Inizializzazione automatica

L'inizializzazione automatica è adatta per la maggior parte degli scenari d'uso.

Aprire EasyAR Global Settings, selezionare l'opzione Initialize On Startup e compilare EasyAR Sense License > LicenseKey

alt text

L'inizializzazione automatica viene chiamata automaticamente al momento BeforeSceneLoad di Unity.

Nota

La license utilizzata nell'editor non verifica il nome del pacchetto dell'app, quindi una license che funziona nell'editor potrebbe comunque fallire quando integrata in un'app o durante l'esecuzione su piattaforma. Prestare attenzione a due casi:

  1. Il nome del pacchetto specificato nella license deve corrispondere al bundle id/package name inserito in Unity Player Settings.
  2. Se il nome del pacchetto viene modificato nel progetto gradle o XCode dopo la build di Unity. In questo caso, utilizzare il nome del pacchetto da gradle o XCode all'interno di Unity.

[Opzionale] Inizializzazione manuale

L'inizializzazione manuale è principalmente utilizzata per flussi di inizializzazione personalizzati, come la visualizzazione di note sulla privacy utente prima di chiamare le API EasyAR (vedere Compliance guide).

Aprire EasyAR Global Settings e deselezionare l'opzione Initialize On Startup.

alt text

Quindi utilizzare l'interfaccia EasyARController.Initialize() per chiamare manualmente l'inizializzazione.

È possibile passare la license come parametro,

EasyARController.Initialize("my-license");

Oppure utilizzare la license specificata in EasyAR Global Settings,

EasyARController.Initialize();
Importante

EasyARController.Initialize() deve essere chiamato prima dell'avvio di ARSession.

In alcuni casi particolari, se è necessario chiamare EasyARController.Initialize() più volte, assicurarsi di eseguire la deinizializzazione tramite EasyARController.Deinitialize() dopo ogni chiamata.

Risoluzione dei problemi di inizializzazione

Dopo aver eseguito una scena contenente ARSession, se i log non includono informazioni simili, l'inizializzazione è fallita.

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Nell'editor Unity, potrebbe apparire un popup simile a questo

alt text

Nota

Prestare attenzione al testo visualizzato nel popup, non tutti i popup indicano un fallimento dell'inizializzazione.

Messaggi di errore comuni e relative cause:

  • EasyARSettings is not found
    • Il file risorsa EasyAR Global Settings non è stato creato (comune quando non è specificata alcuna license)
  • License Key is empty
    • La license non è stata specificata in EasyAR Global Settings o sono presenti più file risorsa EasyAR Global Settings nel progetto
  • EasyARController.Initialize is not called (InitializeOnStartup = false)
    • L'inizializzazione manuale non è stata chiamata al momento corretto
  • EasyAR stops after script change in play mode
    • Durante l'esecuzione nell'editor, è stato modificato uno script. Riavviare l'esecuzione per risolvere

Argomenti correlati