Table of Contents

EasyAR configuration

La page de configuration d'EasyAR est accessible via le menu Unity EasyAR > Sense > Configuration ou Edit > Project Settings > EasyAR.

alt text

Elle contient toutes les configurations globales pour EasyAR Sense Unity Plugin.

alt text

Initialize on startup

Initialiser EasyAR au démarrage. Il est généralement recommandé de laisser cette option activée.

Si cette option est désactivée, vous devrez initialiser manuellement EasyAR Sense. Consultez Initialiser EasyAR Sense pour plus de détails.

Licence EasyAR Sense

Configuration relative à la licence EasyAR Sense.

License key

Clé de licence EasyAR Sense. Une licence valide est obligatoire pour utiliser les fonctionnalités d'EasyAR.

Peut rester vide uniquement lors de l'initialisation manuelle d'EasyAR Sense via l'interface.

Note

Une licence EasyAR XR est nécessaire lors de l'utilisation sur des appareils de type casque (Vision Pro, XREAL, Pico, Rokid, etc.).

Note

Lors de l'utilisation de produits d'évaluation (par exemple, licence personnelle, licence XR d'évaluation ou service Mega d'évaluation, etc.) sur des caméras ou casques personnalisés, EasyAR Sense cessera de répondre après 100 secondes à chaque démarrage (la durée peut être ajustée par EasyAR Business après approbation pour les utilisateurs Mega). L'utilisation d'EasyAR Sense dans sa version payante et du service Mega payant d'EasyAR n'est pas soumise à cette restriction.

Verify when build

Vérifie la licence lors de la compilation du projet Unity.

Lorsque cette option est activée, le processus de compilation du projet Unity valide la licence. La compilation échouera si la licence est invalide sur la plateforme cible ou si elle ne contient pas le nom de package défini dans les paramètres Unity Player. Désactivez cette option si vous devez configurer la licence ailleurs ou modifier le nom de package après la compilation Unity.

Lib variants

Configuration des variantes de la bibliothèque EasyAR Sense.

Licence EasyAR Sense

Configuration relative à la licence EasyAR Sense.

License key

Clé de licence EasyAR Sense. Une licence valide est obligatoire pour utiliser les fonctionnalités d'EasyAR.

Peut rester vide uniquement lors de l'initialisation manuelle d'EasyAR Sense via l'interface.

Note

Une licence EasyAR XR est nécessaire lors de l'utilisation sur des appareils de type casque (Vision Pro, XREAL, Pico, Rokid, etc.).

Note

Lors de l'utilisation de produits d'évaluation (par exemple, licence personnelle, licence XR d'évaluation ou service Mega d'évaluation, etc.) sur des caméras ou casques personnalisés, EasyAR Sense cessera de répondre après 100 secondes à chaque démarrage (la durée peut être ajustée par EasyAR Business après approbation pour les utilisateurs Mega). L'utilisation d'EasyAR Sense dans sa version payante et du service Mega payant d'EasyAR n'est pas soumise à cette restriction.

Verify when build

Vérifie la licence lors de la compilation du projet Unity.

Lorsque cette option est activée, le processus de compilation du projet Unity valide la licence. La compilation échouera si la licence est invalide sur la plateforme cible ou si elle ne contient pas le nom de package défini dans les paramètres Unity Player. Désactivez cette option si vous devez configurer la licence ailleurs ou modifier le nom de package après la compilation Unity.

Permissions

Configuration des permissions de l'application. Il est généralement recommandé de conserver les paramètres par défaut.

À l'exception de l'autorisation de la caméra, les autres configurations de permissions ne peuvent pas être modifiées et sont déterminées par d'autres paramètres fonctionnels.

Permission Modifiable Condition d'activation Description
Camera Oui Autorisation d'accès à la caméra, requise pour utiliser l'appareil photo
AndroidMicrophone Non Variant = VideoRecording Autorisation d'accès au microphone, requise pour les fonctions d'enregistrement d'écran
Location Non Importation du support Mega Autorisation de localisation (fine), requise pour utiliser EasyAR Mega

Unity XR

Configuration relative au framework Unity XR (AR Foundation, etc.).

AR foundation support

Activer le support d'AR Foundation, recommandé de laisser activé.

Dans de rares cas, comme l'utilisation d'AR Foundation 4 ou des erreurs de compilation dues à des mises à jour, vous pouvez désactiver cette option, mais toutes les fonctionnalités liées à AR Foundation dans le plugin seront désactivées.

Note

Après modification de cette option, les scripts sont automatiquement recompilés.

Unity XR auto switch

Configuration de la fonction de basculement automatique des objets Unity XR (comme AR Foundation).

  • Editor : Options en mode édition
    • Disable AR Session : Désactive ARSession d'AR Foundation lors de l'édition si un ARSession est présent.
  • Player : Options en mode exécution
    • Enable : Active le contrôle à l'exécution. Note: Si désactivé, les composants désactivés en mode édition ne seront pas restaurés.
    • Enable If Desktop : Active sur Windows/Mac.
    • Enable If Mobile AR On Startup : Active si le loader AR mobile (ARKit/ARCore) est actif au démarrage du basculeur. Généralement, cette option nécessite que Initialize XR on Startup soit coché dans XR Plug-in Management.
    • Disable If Non Mobile AR Post Startup : Désactive si d'autres loaders que AR mobile (ARKit/ARCore) existent mais aucun n'est actif au démarrage du basculeur. Utilisé lorsque Initialize XR on Startup n'est pas coché dans XR Plug-in Management.
    • Restore AR Session When Disabled : Lorsque désactivée, restaure (active) toutes les sessions ARSession d'AR Foundation désactivées (même si EasyAR ne les a pas désactivées). Utile pour restaurer les composants désactivés lors de l'édition.

Pour plus de détails, consultez Basculement automatique Unity XR.

Mega

Configuration des fonctionnalités EasyAR Mega.

InertialCameraDevice support

Option en lecture seule indiquant la disponibilité de la fonctionnalité de navigation inertielle et les informations ONNX Runtime.

Si les informations affichées ne correspondent pas aux besoins, modifiez Lib Variants et/ou ONNX Runtime (Bundled) selon le cas.

Mega block > Localization service access [Global]

Configuration globale du serveur de localisation pour Mega Block.

Mega landmark > Localization service access [Global]

Configuration globale du serveur de localisation pour Mega Landmark.

Spatial map

Configuration des fonctionnalités de carte spatiale EasyAR.

Service access [Global]

Configuration globale du serveur de carte clairsemée.

Image tracking

Configuration des fonctionnalités de suivi d'image EasyAR.

Target gizmo

Configuration des Gizmos pour ImageTarget dans l'éditeur.

Activer ces options affichera les gizmos correspondants dans Unity Editor. Un nombre élevé de cibles peut affecter les performances au démarrage de l'éditeur. Les performances en exécution ne sont pas affectées.

Cloud recognition (CRS) > Service access [Global]

Configuration globale du serveur de reconnaissance dans le cloud.

Object tracking

Configuration des fonctionnalités de suivi d'objet EasyAR.

Target gizmo

Configuration des Gizmos pour ObjectTarget dans l'éditeur.

  • Enable: Active les Gizmos.

Third-party libraries

Configuration des bibliothèques tierces.

ARCore SDK

Configuration du SDK ARCore.

ARCore fournit des capacités de suivi des mouvements sur certains appareils Android. Consultez Suivi des mouvements et fonctionnalités EasyAR pour comprendre la relation entre les fonctionnalités EasyAR et le suivi des mouvements, et pour déterminer si et quand utiliser ARCore.

  • AR Foundation Or Optional : Le SDK ARCore distribué avec EasyAR ou AR Foundation sera inclus dans l'application, selon la configuration du ARCore XR Plugin. Cette option est généralement recommandée, elle gère automatiquement les cas avec AR Foundation.
  • Optional : Les fonctionnalités ARCore sont disponibles sur les appareils compatibles ARCore avec Google Play Services for AR installé.
  • Required : L'application ne fonctionnera que sur les appareils compatibles ARCore avec Google Play Services for AR installé.
  • External : Si vous utilisez la distribution du SDK ARCore via AR Foundation ou un autre moyen, utilisez cette option. Le SDK ARCore distribué avec EasyAR ne sera pas utilisé. Cette option permet également d'exclure complètement le SDK ARCore de l'application.
Attention

Si vous définissez ARCore SDK sur Required, ou si vous définissez Requirement sur Required dans la configuration ARCore d'AR Foundation, et que l'application est installée sur un appareil non compatible ARCore, celui-ci signalera incorrectement qu'ARCore est disponible et fonctionnera avec ARCore. Cela crée une fausse impression que ces appareils exécutent ARCore avec des dysfonctionnements (écran noir ou autres anomalies), ce qui est erroné.

Ce phénomène se produit car Google Play Store empêche l'installation d'applications marquant ARCore comme obligatoire sur des appareils non pris en charge. Ces applications supposent donc toujours qu'elles s'exécutent sur un appareil compatible.

Dans une configuration normale, ces appareils détectent l'incompatibilité d'ARCore lors de l'assemblage de la session et utilisent les fonctionnalités EasyAR.

Pour des explications détaillées sur Optional et Required, ainsi que d'autres configurations nécessaires pour publier sur Google Play Store, consultez la documentation Google (Chine continentale, International).

Note

Dans EasyAR Sense Unity Plugin, les bibliothèques et configurations nécessaires à la prise en charge d'ARCore sont incluses dans le package du plugin. Cependant, pour l'exécution sur mobile, l'installation de Google Play Services for AR sur l'appareil reste requise.

Trois sources différentes de SDK ARCore sont utilisables :

  • Utiliser le SDK ARCore distribué avec le plugin

    Le plugin intègre une version du SDK ARCore. Pour plus de détails, consultez Compatibilité des versions ARCore, AR Engine. Lors de l'utilisation de l'encapsulation ARCore d'EasyAR, l'importation supplémentaire d'AR Foundation n'est pas nécessaire.

  • Utiliser le SDK ARCore d'AR Foundation

    Si vous devez utiliser le SDK ARCore d'AR Foundation, consultez la documentation Google (Chine continentale, International) pour la configuration. Dans ce cas, l'option ARCore SDK doit être définie sur AR Foundation Or Optional ou External.

  • Utiliser un autre SDK ARCore

    Si un autre plugin tiers ou le projet distribue un SDK ARCore, celui-ci peut être utilisé. Dans ce cas, définissez l'option ARCore SDK sur External et configurez selon les exigences spécifiques du plugin ou du projet.

Warn 32-bit-only ARCore-enabled build

Selon Google, sur les appareils arm64, ARCore ne fonctionnera pas correctement avec une application compilée uniquement avec des bibliothèques armv7. Un avertissement s'affiche lors de la compilation si ARM64 n'est pas sélectionné :

alt text

Il est alors nécessaire de modifier la configuration du projet, d'utiliser la compilation IL2CPP et de sélectionner la prise en charge ARM64.

alt text

Attention

Si nécessaire, vous pouvez sélectionner Continue and don't warn me again ou désactiver cette option, ce qui désactivera la vérification lors de la compilation. La désactivation supprime uniquement l'avertissement à la compilation, mais peut entraîner des anomalies à l'exécution sur certains appareils, notamment des plantages, des écrans noirs, etc.

AR Engine SDK

Configuration du SDK AR Engine.

AR Engine fournit des capacités de suivi des mouvements sur certains appareils Android. Consultez Suivi des mouvements et fonctionnalités EasyAR pour comprendre la relation entre les fonctionnalités EasyAR et le suivi des mouvements, et pour déterminer si et quand utiliser AR Engine.

  • AREngineInterop : AREngineInterop est disponible. Le SDK AR Engine distribué avec EasyAR sera inclus dans l'application.
  • External : AREngineInterop est disponible. Le SDK AR Engine distribué avec EasyAR ne sera pas utilisé.
  • Disabled : AREngineInterop n'est pas disponible. Le SDK AR Engine distribué avec EasyAR ne sera pas utilisé. Toutes les fonctionnalités liées à AR Engine seront désactivées.

ONNX Runtime (Bundled)

Détermine si le runtime ONNX fourni doit être utilisé. Valide uniquement si Lib Variant est Full.

Pour utiliser une version différente d'ONNX, obtenez une version mise à jour depuis le site officiel d'ONNX et désactivez cette option. L'utilisation d'un binaire ONNX auto-compilé incompatible entraînera des erreurs inconnues.

Workaround for unity

Solutions de contournement pour les bogues ou comportements inappropriés d'Unity.

Générer un document XML

Génère un document XML lors du rechargement du script pour activer l'intelliSense de la documentation API.

URP17RG_DX11_RuinedScene

Contournement pour le rendu de scène détérioré avec URP 17 Render Graph DX11. Désactivé dans Unity 6.2 et versions ultérieures.

URP17RG_IOS_Glitches_Partial

Contournement partiel pour Unity Issue UUM-87787.

Description concise : Lors de l'obtention d'une texture caméra depuis EasyAR (comme dans l'exemple ImageTracking_Coloring3D et l'exemple Flux de travail ARSession (CameraDevice)), des artefacts visuels et des défauts sont observables sur les appareils iOS/Mac. Nous avons reproduit le problème dans un package Unity pur et signalé à Unity : Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Suivez les mises à jour via Unity Issue UUM-87787 et les notes de version futures d'Unity.