Activer ar foundation dans les projets easyar
Si vous devez activer la prise en charge d'ar foundation par easyar ou utiliser d'autres fonctionnalités d'ar foundation, vous devez installer et configurer correctement ar foundation. Le contenu suivant explique comment effectuer ces opérations.
Avant de commencer
- Lisez Support de easyar pour les frameworks xr unity pour comprendre le support de easyar pour les frameworks xr unity et dans quels cas envisager d'utiliser ar foundation.
Compatibilité des versions d'ar foundation
Easyar supporte ar foundation 5 ou versions ultérieures.
Important
Le support d'ar foundation est implémenté via une caméra personnalisée.
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.
Installer ar foundation
Il est recommandé de se référer à la documentation officielle d'ar foundation pour installer ar foundation. Avant la lecture, veuillez sélectionner la version correspondante de la documentation.
Unity 2022 et versions ultérieures
Si aucun plugin xr n'est installé dans le projet, vous devez dans Project Settings > XR Plug-in Management cliquer sur le bouton Install XR Plugin Management pour installer xr plug-in management et attendre la fin de l'installation.
Si vous avez besoin d'utiliser ar foundation sur la plateforme android, cochez Google ARCore sous l'onglet android et attendez la fin de l'installation.
Si vous avez besoin d'utiliser ar foundation sur la plateforme ios, cochez Apple ARKit sous l'onglet ios et attendez la fin de l'installation.
Si vous avez besoin d'utiliser ar foundation sur la plateforme visionos, veuillez lire Configuration du projet vision pro.
Astuce
Il est recommandé de laisser Initialize XR On Startup coché pour s'assurer qu'ar foundation puisse s'initialiser au moment par défaut.
Une fois l'installation terminée, ouvrez la fenêtre Package Manager, vous pouvez voir qu'AR Foundation ainsi que les plugins pour les plateformes correspondantes apparaîtront dans la liste des packages installés. Notez que les numéros de version de ces packages doivent être exactement les mêmes.
Important
Lors de l'installation et de la mise à jour d'ar foundation, assurez-vous que les versions de Google ARCore XR Plugin et Apple ARKit XR Plugin correspondent exactement à la version d'AR Foundation. Des versions incompatibles peuvent entraîner des erreurs d'exécution ou des dysfonctionnements.
Unity 2021
Dans les versions unity 2021, vous devez éditer manuellement le fichier Packages/manifest.json pour spécifier la version, reportez-vous à la documentation officielle.
Par exemple, si vous devez installer la version 5.2.0 d'ar foundation et l'utiliser sur les plateformes android et ios, assurez-vous que le fichier Packages/manifest.json contient les éléments suivants :
{
"dependencies": {
...
"com.unity.xr.arcore": "5.2.0",
"com.unity.xr.arfoundation": "5.2.0",
"com.unity.xr.arkit": "5.2.0",
...
}
}
Configurer xr plug-in
Lorsque vous utilisez easyar, la présence d'arcore n'est généralement pas obligatoire. Par conséquent, arcore doit être configuré comme optionnel pour éviter que l'application ne fonctionne pas correctement sur les appareils ne supportant pas arcore.
Dans Project Settings > XR Plug-in Management > ARCore, définissez Requirement et Depth sur Optional.
Attention
Si vous définissez Requirement sur Required et installez l'application compilée sur un appareil ne supportant pas arcore, l'appareil signalera à tort qu'arcore est disponible et fonctionnera avec arcore. Cela créera une fausse impression que ces appareils exécutent arcore et fonctionnent anormalement (écran noir ou autres anomalies), mais cela est incorrect.
Ce phénomène se produit car le google play store empêche l'installation d'applications marquant arcore comme obligatoire sur des appareils non supportés, donc ces applications supposent toujours qu'elles s'exécutent sur des appareils supportés.
Dans une configuration normale, ces appareils détermineront lors de l'assemblage de la session qu'arcore n'est pas supporté et utiliseront les fonctionnalités d'easyar.
Si nécessaire, vous pouvez également consulter la documentation officielle suivante pour configurer davantage arcore et arkit. Avant la lecture, veuillez sélectionner la version correspondante de la documentation.
Configurer universal render pipeline
Si le projet actuel utilise urp, vous devez configurer les assets urp. S'ils ne sont pas configurés correctement, l'image de fond de la caméra ar foundation pourrait ne pas s'afficher correctement.
Commencez par vous assurer que le renderer feature urp d'easyar est correctement configuré, reportez-vous à Configuration d'universal render pipeline pour easyar.
Ensuite, ajoutez ARBackgroundRendererFeature à la liste des renderer features.
Comme pour la configuration du renderer feature urp d'easyar, vous devez faire attention aux configurations des différentes plateformes dans Project Settings > Quality, et vous assurer que sur toutes les plateformes où ar foundation sera utilisé, l'asset urp correctement configuré avec ARBackgroundRendererFeature est utilisé.
Vous pouvez également consulter la documentation officielle de configuration urp d'ar foundation pour la configuration. Avant la lecture, veuillez sélectionner la version correspondante de la documentation.
Note
La Configuration d'universal render pipeline pour easyar est toujours nécessaire pour garantir que le rendu des fonctionnalités liées à l'interface easyar fonctionne normalement sur les appareils ne supportant pas ar foundation.
Activer la prise en charge d'ar foundation par easyar
Dans Project Settings > EasyAR > Sense, assurez-vous que l'option Unity XR > AR Foundation Support est activée. Cette option est activée par défaut.
La modification de cette option déclenche une recompilation des scripts, vous devez attendre la fin de la compilation pour que les modifications prennent effet. Si unity ne déclenche pas la compilation correctement pour une raison quelconque, vous pouvez fermer unity, supprimer le dossier Library/ScriptAssemblies pour forcer unity à recompiler les scripts.
Astuce
Si easyar est incompatible avec ar foundation dans le projet et que vous n'avez pas besoin d'utiliser simultanément easyar et ar foundation, vous pouvez désactiver cette option.
Étapes suivantes
- Découvrez Configuration et utilisation de scènes ar foundation dans les projets easyar
- Découvrez comment basculer automatiquement vers ar foundation en fonction du support matériel