Configuration et utilisation des scènes AR Foundation dans les projets EasyAR
L'utilisation d'AR Foundation dans Unity nécessite souvent de s'appuyer sur EasyAR pour contourner les limitations matérielles d'AR Foundation. Ce qui suit explique comment configurer et utiliser correctement AR Foundation dans les scènes EasyAR, et comment activer dynamiquement AR Foundation en fonction de la prise en charge matérielle.
Avant de commencer
- Lisez Prise en charge des frameworks XR Unity par EasyAR pour comprendre la prise en charge d'EasyAR des frameworks XR Unity et dans quels cas envisager d'utiliser AR Foundation.
- Lisez Activer AR Foundation dans les projets EasyAR pour apprendre comment installer et configurer AR Foundation dans les projets EasyAR.
Ajouter des composants AR Foundation
Ajoutez la session AR et le XR Origin d'AR Foundation dans la scène EasyAR.
Ajouter une session AR
Dans la vue Hierarchy, faites un clic droit sur un espace vide, puis via le menu XR > AR Session ajoutez la ARSession d'Unity à la scène.
Note
Cette session AR est différente de la session AR d'EasyAR ; elles doivent coexister dans la scène.
Ajouter le XR Origin
Dans la vue Hierarchy, faites un clic droit sur un espace vide, puis via le menu XR > XR Origin (Mobile AR) ajoutez le XROrigin d'Unity à la scène.
Note
Ce XR Origin chevauche la fonctionnalité du XR Origin d'EasyAR ; vous devez utiliser le XR Origin d'Unity plutôt que celui d'EasyAR.
Si la scène contenait précédemment le XR Origin d'EasyAR, généralement nommé XR Origin (EasyAR), déplacez ses enfants sous le nouveau XR Origin, puis supprimez XR Origin (EasyAR).
Si le nouveau XR Origin ne contient pas de XR Origin Child, ajoutez-le manuellement.
Dans la vue Hierarchy, sélectionnez XR Origin, faites un clic droit, puis via le menu EasyAR Sense > Origin > Origin : XR Origin Child ajoutez un XR Origin Child sous le XR Origin.
Configurer la caméra
Si la scène contenait une Camera pour la RA, vous constaterez la présence d'une caméra principale supplémentaire ; supprimez la caméra originale.
Sélectionnez ensuite la Main Camera sous le XR Origin et configurez-la selon les instructions de Configuration de la caméra.
Enfin, une scène EasyAR complète avec AR Foundation ajoutée devrait ressembler à ceci :
Attention
Si vous devez modifier la configuration d'AR Foundation via ARCameraManager.currentConfiguration, notez que certains téléphones (comme le Xiaomi 10) présentent des problèmes : après modification, ils ne peuvent plus récupérer d'images, rendant EasyAR inutilisable (l'application a un fond d'image mais aucune fonctionnalité EasyAR ne réagit). Il est donc généralement déconseillé de modifier cette configuration ; si nécessaire, prévoyez une solution de repli lorsque EasyAR ne fonctionne pas.
Compatibilité matérielle et activation dynamique d'AR Foundation
EasyAR est compatible avec bien plus d'appareils qu'AR Foundation. Il faut donc configurer l'application pour n'activer AR Foundation que lorsque nécessaire, et le désactiver complètement dans les autres cas.
Vérifier les composants frame source
Généralement, les sessions créées via le menu EasyAR ajoutent automatiquement ARCoreARFoundationFrameSource et ARKitARFoundationFrameSource (sauf pour certaines fonctionnalités comme le suivi d'image sans SLAM).
Important
ARCoreARFoundationFrameSource et ARKitARFoundationFrameSource sont des frame sources fournis par EasyAR pour activer les fonctionnalités AR Foundation sur les appareils compatibles. Si la session de la scène ne contient pas ces frame sources, les fonctionnalités AR Foundation ne pourront pas être activées.
Si la session de la scène ne contient pas ces frame sources, ajoutez-les manuellement via le menu.
Pour fonctionner sur les téléphones ne prenant pas en charge AR Foundation, assurez-vous que la session contient également des frame sources autres qu'AR Foundation. Une ARSession typique devrait ressembler à ceci :
Astuce
Vous pouvez trier les frame sources selon vos besoins. Au lancement de l'application, la session sélectionnera le premier frame source disponible selon l'ordre de transformation, en fonction de la prise en charge matérielle.
Activer AR Foundation uniquement lorsque nécessaire
Comme AR Foundation repose sous Android sur ARCore et ARKit, il ne fonctionne que sur un nombre limité d'appareils, notamment sur de nombreux téléphones Android chinois. Il est donc recommandé de n'activer AR Foundation et ses scripts associés que sur les appareils pris en charge.
EasyAR peut automatiser cette opération via l'option Unity XR Auto Switch dans Project Settings > EasyAR > Sense > Unity XR. Pour plus de détails, consultez Activation/désactivation automatique des objets Unity XR.
Scènes conservant la compatibilité AR Foundation
Les scènes correctement configurées avec les composants AR Foundation fonctionneront correctement, que le package AR Foundation soit installé ou non.
Lorsqu'AR Foundation n'est pas installé, ses fonctionnalités et les frame sources correspondants sont indisponibles, et certains scripts seront manquants dans la scène, ce qui est normal.
Astuce
De nombreux exemples fonctionnent avec ou sans le package AR Foundation installé. Pour activer la prise en charge d'AR Foundation dans ces exemples, il suffit de Activer AR Foundation dans les projets EasyAR.
Prochaines étapes
- Apprenez à basculer automatiquement vers AR Foundation en fonction de la prise en charge matérielle.
Sujets connexes
- Composants RA mentionnés :
- AR Foundation fournit des capacités de suivi des mouvements sur certains appareils. Pour comprendre la relation entre le suivi des mouvements et les fonctionnalités d'EasyAR, consultez :
- Pour plus d'informations sur la configuration des scènes AR Foundation, consultez la documentation officielle d'AR Foundation (choisissez la version appropriée) :