Table of Contents

Configuration d'EasyAR

La page de configuration d'EasyAR peut être accédée via le menu Unity EasyAR > Sense > Configuration ou Edit > Project Settings > EasyAR.

alt text

Ici sont incluses toutes les configurations globales du plugin EasyAR Sense Unity.

alt text

Initialiser au démarrage

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 EasyAR Sense manuellement. Pour plus de détails, consultez Initialiser 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.

Variantes de bibliothèque

Configuration des variantes de la bibliothèque EasyAR Sense.

EasyAR Sense a généralement plusieurs variantes, dont les fonctionnalités diffèrent entre elles. Voici la comparaison des variantes de bibliothèque intégrées dans le plugin.

Variant Nom de la variante EasyAR Sense Différence de fonctionnalité Autres particularités
Normal Community/Enterprise ne contient pas l'enregistrement d'écran et la navigation inertielle
Full CommunityFull/EnterpriseFull inclut la navigation inertielle et d'autres fonctionnalités Mega le fichier de bibliothèque a une taille plus grande
VideoRecording CommunityR inclut la fonctionnalité d'enregistrement d'écran (Android uniquement)
Astuce

Certaines variantes qui ne peuvent pas être utilisées dans Unity ne sont pas répertoriées ici, comme la variante CommunityR pour iOS.

Valeur par défaut :

  • pas d'importation du paquet de support EasyAR Mega : Normal
  • importation du paquet de support EasyAR Mega : Full

Configuration recommandée :

  • Full : vous utilisez EasyAR Mega ou la fonctionnalité de navigation inertielle
  • Normal : vous recherchez la taille de paquet la plus petite et n'utilisez pas EasyAR Mega ou la prise en charge de la navigation inertielle
  • VideoRecording : vous avez besoin d'utiliser la fonctionnalité d'enregistrement d'écran (Android uniquement)

Autorisations

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

Toutes les configurations d'autorisation autres que celle de la caméra ne peuvent pas être modifiées et sont déterminées par les autres configurations de fonctionnalités.

Autorisation Modifiable Conditions d'activation Description de l'autorisation
Camera Oui Autorisation de la caméra, nécessaire pour utiliser le dispositif de caméra
AndroidMicrophone Non Variant est VideoRecording Autorisation du micro, nécessaire pour utiliser la fonction d'enregistrement d'écran
Location Non Importation du package de support Mega Autorisation de localisation (fine), nécessaire pour utiliser EasyAR Mega

Unity XR

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

Prise en charge d'AR Foundation

Commutateur de prise en charge d'AR Foundation. Il est recommandé de le laisser activé.

Dans quelques cas très rares, par exemple si vous avez besoin d'utiliser AR Foundation 4 ou si une mise à jour d'AR Foundation entraîne une erreur de compilation, vous pouvez désactiver cette option, mais toutes les fonctionnalités liées à AR Foundation dans le plugin seront également désactivées.

Note

Après avoir modifié cette option, le script sera automatiquement recompilé.

Commutateur automatique Unity XR

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

  • Editor : Options en mode édition
    • Désactiver la session AR : Désactive la session AR d'AR Foundation lors de l'édition lorsqu'un ARSession est présent.
  • Player : Options en mode exécution
    • Activer : Active le contrôle en mode exécution. Attention : si cette option est désactivée, les composants désactivés en mode édition ne seront pas restaurés en mode exécution.
    • Activer si bureau : Active sur Windows/Mac.
    • Activer si mobile AR au démarrage : Active lorsque le chargeur d'AR mobile (ARKit/ARCore) est activé au démarrage du commutateur. Généralement, cette option nécessite que Initialiser XR au démarrage dans la gestionnaire de plug-ins XR soit coché.
    • Désactiver si autre AR non mobile après le démarrage : Désactive lorsque le chargeur d'AR mobile (ARKit/ARCore) n'est pas présent et aucun chargeur n'est activé au démarrage du commutateur. Généralement, cette option est utilisée lorsque Initialiser XR au démarrage dans la gestionnaire de plug-ins XR n'est pas coché.
    • Restaurer la session AR lorsqu'elle est désactivée : Active (restaure) toutes les sessions AR d'AR Foundation désactivées (que ce soit par EasyAR ou non) lorsque la fonction est désactivée. Cette option est généralement utilisée pour restaurer les composants désactivés en mode édition.

Pour plus de détails sur les fonctionnalités, consultez Commutation automatique Unity XR.

Mega

Configuration des fonctionnalités EasyAR Mega.

Prise en charge de Mega Block/Landmark

Activation ou non de 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.

Prise en charge du dispositif de caméra inertielle

Option de lecture seule, indiquant si la fonction d'inertie est disponible dans la configuration actuelle.

Si l'information affichée ne correspond pas aux besoins, vous devrez modifier les options de Variantes de bibliothèque selon les cas.

Prise en charge d'ONNX

Option de lecture seule, affichant les informations sur l'exécution ONNX dans la configuration actuelle.

Si l'information affichée ne correspond pas aux besoins, vous devrez modifier les options de Variantes de bibliothèque et ONNX Runtime (Bundled) selon les cas.

Accès au service de localisation Mega Block > [Global]

Configuration du serveur de localisation de Mega Block au niveau global.

Accès au service de localisation Mega Landmark > [Global]

Configuration du serveur de localisation de Mega Landmark au niveau global.

Carte spatiale

Configuration des fonctionnalités de carte spatiale d'EasyAR.

Accès au service [Global]

Configuration du serveur de carte spatiale sparse au niveau global.

Suivi d'images

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

Gizmo de la cible

Configuration des Gizmos des ImageTarget dans l'éditeur.

Activation de ces options affichera les gizmos correspondants dans l'éditeur Unity. Si le nombre de cibles de ce type dans la scène est trop élevé, cela peut affecter les performances de démarrage dans l'éditeur. Les performances lors de l'exécution sur le dispositif ne seront pas affectées.

Reconnaissance cloud (CRS) > Accès au service [Global]

Configuration du serveur de reconnaissance cloud au niveau global.

Suivi d'objets

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

Gizmo de la cible

Configuration des Gizmos des ObjectTarget dans l'éditeur.

  • Activer : Active les gizmos.

Bibliothèques tierces

Configuration des bibliothèques tierces.

ARCore SDK

Configuration de l'ARCore SDK.

L'ARCore offre la capacité de suivi du mouvement sur certains appareils Android. Vous pouvez lire Motion Tracking and EasyAR Features pour comprendre la relation entre les fonctionnalités d'EasyAR et le suivi du mouvement, ainsi que si et quand il est nécessaire d'utiliser l'ARCore.

  • AR Foundation Or Optional : L'ARCore SDK distribué avec EasyAR ou AR Foundation sera inclus dans l'application, selon les paramètres du plugin XR d'ARCore. Dans la plupart des cas, cette option est recommandée car elle gère automatiquement le cas de AR Foundation.
  • Optional : Les fonctionnalités d'ARCore sont disponibles sur les appareils qui prennent en charge l'ARCore et ont installé Google Play Services for AR.
  • Required : L'application ne pourra s'exécuter que sur les appareils qui prennent en charge l'ARCore et ont installé Google Play Services for AR.
  • External : Si vous utilisez AR Foundation ou une autre distribution de l'ARCore SDK, vous pouvez utiliser cette option. Ainsi, l'ARCore SDK distribué avec EasyAR ne sera pas utilisé. Vous pouvez également utiliser cette option pour exclure complètement l'utilisation de l'ARCore SDK dans l'application.
Attention

Si vous définissez ARCore SDK sur Required, ou si vous définissez Requirement sur Required dans la configuration d'ARCore d'AR Foundation, et que vous installez l'application empaquetée sur un appareil qui ne prend pas en charge l'ARCore, l'appareil signalera à tort que l'ARCore est disponible et l'exécutera avec l'ARCore. Cela créera l'illusion que ces appareils exécutent l'ARCore et que cela ne fonctionne pas correctement (écran noir ou autres anomalies), mais c'est faux.

Ce phénomène est dû au fait que le Google Play Store empêche l'installation d'applications marquant l'ARCore comme requis sur les appareils non pris en charge. Par conséquent, ces applications supposent toujours qu'elles s'exécutent sur des appareils pris en charge.

Dans une configuration normale, ces appareils détermineront que l'ARCore n'est pas pris en charge lors de l'assemblage de la session et utiliseront les fonctionnalités d'EasyAR.

Pour plus de détails sur Optional et Required ainsi que les autres configurations nécessaires pour publier une application sur le Google Play Store, vous pouvez consulter la documentation de Google (Chine continentale, Internationale).

Note

Dans le plugin Unity d'EasyAR Sense, les fichiers de bibliothèque et la configuration nécessaires pour la prise en charge de l'ARCore sont déjà inclus dans le paquet du plugin. Cependant, pour exécuter l'application sur un téléphone, il est encore nécessaire d'installer Google Play Services for AR sur le téléphone.

Il existe trois sources différentes d'ARCore SDK que vous pouvez utiliser :

  • Utiliser l'ARCore SDK distribué avec le plugin

    Un version de l'ARCore SDK est intégrée au plugin. Pour plus de détails, vous pouvez consulter Compatibilité des versions d'ARCore et d'AR Engine. Lorsque vous utilisez l'encapsulation d'ARCore d'EasyAR, vous n'avez pas besoin d'importer séparément AR Foundation.

  • Utiliser l'ARCore SDK d'AR Foundation

    Si vous avez besoin d'utiliser l'ARCore SDK d'AR Foundation, vous pouvez consulter la documentation de Google (Chine continentale, Internationale) pour la configuration. Dans ce cas, l'option ARCore SDK doit être définie sur AR Foundation Or Optional ou External.

  • Utiliser un autre ARCore SDK

    Si vous avez une autre distribution d'ARCore SDK dans un plugin tiers ou dans votre projet, vous pouvez également utiliser cet ARCore SDK. Dans ce cas, l'option ARCore SDK doit être définie sur External, et vous devez configurer selon les exigences du plugin ou du projet spécifique.

Warn 32-bit-only ARCore-enabled build

Selon la documentation de Google, lorsque vous exécutez un programme avec seulement des fichiers de bibliothèque armv7 sur un appareil arm64, l'ARCore ne fonctionnera pas correctement. Lors de l'empaquetage, si vous n'avez pas sélectionné ARM64, un avertissement s'affichera :

alt text

Dans ce cas, vous devez modifier la configuration du projet, utiliser la compilation IL2CPP et sélectionner la prise en charge d'ARM64.

alt text

Attention

Si vous avez réellement besoin, vous pouvez sélectionner Continue and don't warn me again ou désactiver cette option. Cela désactivera la vérification lors de l'empaquetage. Désactiver la vérification signifie simplement que l'avertissement ne s'affichera pas lors de l'empaquetage, mais des anomalies peuvent survenir lors de l'exécution sur certains appareils, y compris mais sans s'y limiter des plantages ou des écrans noirs.

AR Engine SDK

Configuration de l'AR Engine SDK.

L'AR Engine offre la capacité de suivi du mouvement sur certains appareils Android. Vous pouvez lire Motion Tracking and EasyAR Features pour comprendre la relation entre les fonctionnalités d'EasyAR et le suivi du mouvement, ainsi que si et quand il est nécessaire d'utiliser l'AR Engine.

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

ONNX Runtime (Bundled)

Utiliser ou non le runtime ONNX intégré. Cela n'est valide que lorsque Lib Variant est défini sur Full.

Si vous avez besoin d'utiliser une version différente d'ONNX, vous pouvez obtenir une version mise à jour sur le site officiel d'ONNX et désactiver cette option. L'utilisation d'un ONNX binaire non compatible compilé par vous-même entraînera des erreurs inconnues.

Solution de contournement pour Unity

Solutions de contournement pour les bogues ou les comportements non logiques de 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.