Table of Contents

Initialisieren von easyar sense mit lizenzschlüssel

Um easyar in unity zu verwenden, muss easyar sense mit einem lizenzschlüssel initialisiert werden, um die funktionalität zu aktivieren. Es gibt zwei initialisierungsmethoden: automatische initialisierung und manuelle initialisierung.

Nach erfolgreicher initialisierung können die version von easyar sense und plattforminformationen in der unity-konsole oder systemprotokollen angezeigt werden, z. b.:

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Vorbereitung

  • EasyAR Sense-Lizenz beschreibt, wie eine easyar sense-lizenz (lizenzschlüssel) bezogen wird. Vor der initialisierung von easyar sense muss eine geeignete lizenz für die verwendete hardware und entwicklungsphase vorbereitet werden.

Automatische initialisierung

Die automatische initialisierung ist für die meisten anwendungsszenarien geeignet.

Öffnen Sie EasyAR Globale Einstellungen, aktivieren Sie die option Initialize On Startup und füllen Sie EasyAR Sense License > LicenseKey aus

alt text

Die automatische initialisierung erfolgt automatisch zum zeitpunkt von BeforeSceneLoad in unity.

Anmerkung

Die im editor verwendete lizenz überprüft nicht den anwendungspaketnamen. Daher kann eine lizenz, die im editor funktioniert, beim export auf eine plattform oder in einer app fehlschlagen. Beachten Sie folgende punkte:

  1. Der paketname der lizenz muss mit der bundle-id/package-name in den unity player-einstellungen übereinstimmen.
  2. Wenn der paketname nach dem unity-export im gradle- oder xcode-projekt geändert wird, muss in unity der paketname aus gradle oder xcode verwendet werden.

[Optional] Manuelle initialisierung

Die manuelle initialisierung wird hauptsächlich für benutzerdefinierte initialisierungsabläufe verwendet, z. b. zum anzeigen von datenschutzhinweisen vor dem aufruf von easyar-schnittstellen (siehe Compliance-Leitfaden).

Öffnen Sie EasyAR Globale Einstellungen und deaktivieren Sie die option Initialize On Startup.

alt text

Verwenden Sie dann die EasyARController.Initialize()-schnittstelle für die manuelle initialisierung.

Die lizenz kann als parameter übergeben werden:

EasyARController.Initialize("my-license");

Alternativ kann die in EasyAR Globale Einstellungen hinterlegte lizenz verwendet werden:

EasyARController.Initialize();
Wichtig

EasyARController.Initialize() muss aufgerufen werden, bevor eine ARSession gestartet wird.

In sonderfällen, wenn EasyARController.Initialize() mehrfach aufgerufen werden soll, muss nach jedem aufruf eine deinitialisierung mit EasyARController.Deinitialize() erfolgen.

Fehlerbehebung bei initialisierungsfehlern

Wenn nach dem start einer szene mit ARSession keine ähnliche meldung im protokoll erscheint, ist die initialisierung fehlgeschlagen.

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Im unity-editor kann auch ein solches fenster angezeigt werden:

alt text

Anmerkung

Beachten Sie die textinformationen im fenster – nicht alle fenster deuten auf einen initialisierungsfehler hin.

Häufige fehlermeldungen und ursachen:

  • EasyARSettings is not found
    • Die ressourcendatei EasyAR Globale Einstellungen wurde nicht erstellt (häufig bei fehlender lizenz)
  • License Key is empty
    • Keine lizenz in EasyAR Globale Einstellungen eingetragen oder mehrere ressourcendateien im projekt
  • EasyARController.Initialize is not called (InitializeOnStartup = false)
    • Manuelle initialisierung nicht zum richtigen zeitpunkt aufgerufen
  • EasyAR stops after script change in play mode
    • Skriptänderung während der editor-laufzeit. Neustart erforderlich

Verwandte themen