Table of Contents

Initialiser EasyAR Sense avec une clé de licence

Pour utiliser EasyAR dans Unity, il est nécessaire d'initialiser EasyAR Sense avec une licence (license key) afin d'activer les fonctionnalités. Il existe deux méthodes d'initialisation : automatique et manuelle.

Après une initialisation réussie, les informations sur la version d'EasyAR Sense et la plateforme d'exécution apparaissent dans la console Unity ou les journaux système, par exemple :

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Avant de commencer

  • La Licence EasyAR Sense décrit comment obtenir une licence EasyAR Sense (license key). Avant d'initialiser EasyAR Sense, il est nécessaire de préparer une licence adaptée en fonction des appareils utilisés et de la phase de développement.

Initialisation automatique

L'initialisation automatique convient à la plupart des scénarios d'utilisation.

Ouvrez les Paramètres globaux EasyAR, cochez l'option Initialize On Startup et renseignez le champ LicenseKey dans EasyAR Sense License.

alt text

L'initialisation automatique est appelée automatiquement au moment BeforeSceneLoad dans Unity.

Note

La licence utilisée dans l'éditeur ne vérifie pas le nom du package de l'application. Par conséquent, une licence qui fonctionne dans l'éditeur peut échouer lors de l'exécution de l'application packagée. Dans ce cas, deux situations doivent être prises en compte :

  1. Le nom du package de la licence doit correspondre au bundle id/package name renseigné dans les Player Settings de Unity.
  2. Si le nom du package est modifié après le build Unity, dans le projet gradle ou XCode. Dans ce cas, utilisez le nom du package présent dans gradle ou XCode dans Unity.

[Optionnel] Initialisation manuelle

L'initialisation manuelle est principalement utilisée pour des flux personnalisés, comme l'affichage d'une politique de confidentialité avant d'appeler les API EasyAR (voir Guide de conformité).

Ouvrez les Paramètres globaux EasyAR et décochez l'option Initialize On Startup.

alt text

Utilisez ensuite l'interface EasyARController.Initialize() pour appeler manuellement l'initialisation.

Il est possible de passer la licence en paramètre :

EasyARController.Initialize("ma-licence");

Ou d'utiliser la licence renseignée dans les Paramètres globaux EasyAR :

EasyARController.Initialize();
Important

EasyARController.Initialize() doit être appelée avant le démarrage de ARSession.

Dans certains cas particuliers, si EasyARController.Initialize() doit être appelée plusieurs fois, il est nécessaire de s'assurer qu'une désinitialisation via EasyARController.Deinitialize() est effectuée après chaque exécution.

Résolution des échecs d'initialisation

Si, après avoir exécuté une scène contenant ARSession, les journaux ne contiennent pas d'information similaire, cela indique un échec d'initialisation.

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Dans l'éditeur Unity, une fenêtre contextuelle similaire peut également apparaître :

alt text

Note

Il est important de lire attentivement le message affiché dans la fenêtre contextuelle, car toutes les fenêtres ne signalent pas un échec d'initialisation.

Les erreurs et causes courantes sont les suivantes :

  • EasyARSettings is not found
    • Le fichier ressource des Paramètres globaux EasyAR n'a pas été créé (fréquent si aucune licence n'est renseignée).
  • License Key is empty
    • La licence n'a pas été renseignée dans les Paramètres globaux EasyAR, ou plusieurs fichiers ressource Paramètres globaux EasyAR existent dans le projet.
  • EasyARController.Initialize is not called (InitializeOnStartup = false)
    • L'initialisation manuelle n'a pas été appelée au bon moment.
  • EasyAR stops after script change in play mode
    • Un script a été modifié pendant l'exécution dans l'éditeur. Il suffit de relancer l'exécution.

Sujets connexes