Table of Contents

Configuration easyar

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

alt text

Elle contient toutes les configurations globales pour le plugin EasyAR Sense Unity.

alt text

Initialize on startup

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

Si vous désactivez cette option, vous devez initialiser manuellement EasyAR Sense. Pour plus de détails, reportez-vous à Initialisation d'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.

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 autorisations 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 d'autorisation ne peuvent pas être modifiées et sont déterminées par les configurations d'autres fonctionnalités.

Autorisation Modifiable Condition d'activation Description
Camera Oui Autorisation de la caméra, requise pour utiliser le périphérique de caméra
AndroidMicrophone Non Variant est VideoRecording Autorisation du microphone, requise pour utiliser la fonctionnalité d'enregistrement vidéo
Location Non Importation du package de 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

Interrupteur de support AR Foundation, il est recommandé de le laisser activé.

Dans de très rares cas, par exemple lorsque vous devez utiliser AR Foundation 4 ou qu'une mise à jour d'AR Foundation provoque des erreurs de compilation, vous pouvez désactiver cette option, mais toutes les fonctionnalités liées à AR Foundation dans le plugin seront désactivées simultanément.

Note

Après avoir modifié cette option, les scripts seront automatiquement recompilés.

Unity xr auto switch

Configuration de la fonctionnalité de commutation automatique des objets Unity XR (par exemple AR Foundation).

  • Editor : Options du mode Édition
    • Disable AR Session : Lorsqu'un ARSession existe, désactive l'ARSession d'AR Foundation en mode édition.
  • Player : Options du mode Exécution
    • Enable : Active le contrôle à l'exécution. Remarque : si cette option est désactivée, les composants désactivés en mode édition ne seront pas restaurés à l'exécution.
    • Enable If Desktop : Active sur Windows/Mac.
    • Enable If Mobile AR On Startup : Active au démarrage du commutateur si le loader AR mobile (ARKit/ARCore) est actif. Cette option nécessite généralement que Initialize XR on Startup dans XR Plug-in Management soit coché.
    • Disable If Non Mobile AR Post Startup : Désactive au démarrage du commutateur s'il existe d'autres loaders que AR mobile (ARKit/ARCore), mais qu'aucun d'entre eux n'est actif. Cette option est généralement utilisée lorsque Initialize XR on Startup dans XR Plug-in Management n'est pas coché.
    • Restore AR Session When Disabled : Lorsque la fonctionnalité est désactivée, restaure (active) toutes les ARSession d'AR Foundation qui ont été désactivées (qu'elles aient été désactivées par EasyAR ou non). Cette option est généralement utilisée pour restaurer les composants désactivés pendant l'édition.

Pour une description détaillée de la fonctionnalité, reportez-vous à Commutation automatique Unity XR.

Mega

Configuration de la fonctionnalité EasyAR Mega.

Mega block/landmark support

Indique s'il faut activer la prise en charge de Mega Block/Landmark.

Cette option est activée par défaut après l'importation de com.easyar.mega et désactivée par défaut si elle n'est pas importée.

Inertialcameradevice support

Option en lecture seule indiquant si la fonctionnalité de navigation inertielle est disponible dans la configuration actuelle.

Si les informations affichées ne correspondent pas à vos besoins, vous devez modifier l'option Lib Variants en conséquence.

Onnx support

Option en lecture seule affichant les informations d'exécution ONNX pour la configuration actuelle.

Si les informations affichées ne correspondent pas à vos besoins, vous devez modifier les options Lib Variants et ONNX Runtime (Bundled) en conséquence.

Mega block > Localization service access [global]

Configuration globale du serveur de localisation Mega Block.

Mega landmark > Localization service access [global]

Configuration globale du serveur de localisation Mega Landmark.

Spatial map

Configuration de la fonctionnalité de carte spatiale EasyAR.

Service access [global]

Configuration globale du serveur de carte clairsemée.

Image tracking

Configuration de la fonctionnalité de suivi d'image EasyAR.

Target gizmo

Configuration des Gizmos pour ImageTarget dans l'éditeur.

Activer ces options affichera les gizmos correspondants dans l'éditeur Unity. Si la scène contient un grand nombre de ce type de cibles, cela peut affecter les performances de démarrage dans l'éditeur. Les performances lors de l'exécution sur un appareil ne seront pas affectées.

Cloud recognition (crs) > Service access [global]

Configuration globale du serveur de reconnaissance dans le cloud.

Object tracking

Configuration de la fonctionnalité 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 bugs 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.