Activer la prise en charge des casques dans un projet EasyAR
Ce document explique comment activer la prise en charge des casques dans une scène Unity EasyAR existante.
Avant de commencer
- Lisez Prise en charge des casques par EasyAR pour connaître les types de casques pris en charge par EasyAR et les fonctionnalités EasyAR exécutables sur casque.
- Lisez Prise en charge des casques EasyAR dans Unity pour comprendre l'architecture globale de la prise en charge des casques EasyAR dans Unity.
Cet article suppose que vous disposez déjà d'une scène fonctionnelle avec EasyAR. Si vous avez besoin de créer une telle scène ou d'ajouter des composants EasyAR à une scène pour casque, reportez-vous aux documents suivants :
Ajouter des composants de casque à la scène
Avant d'ajouter des composants de casque à la scène, il est généralement nécessaire de supprimer la caméra et l'origine XR existantes.
Supprimer la caméra et l'origine XR
Supprimez la caméra existante dans la scène.
Si la scène contient déjà une XR Origin, qu'elle provienne d'EasyAR ou du framework XR Unity, il faut dans la plupart des cas la supprimer.
Astuce
Dans certains usages avancés, vous pouvez décider de la conserver ou non selon vos besoins.
Ajouter des composants de casque
Suivez les instructions officielles du casque pour ajouter ses composants. Prenons l'exemple du casque Pico ; en cas de conflit avec les instructions officielles, suivez ces dernières.
Utilisez le menu pour ajouter un XR Interaction Manager :
Utilisez le menu pour ajouter une XR Origin :
Avant d'exécuter, assurez-vous de lire les instructions officielles du casque pour comprendre comment configurer et exécuter une scène avec un SDK de casque.
Configurer la source d'images
Appareils pris en charge nativement
Sélectionnez AR Session (EasyAR), faites un clic droit et utilisez le menu EasyAR Sense > Head Mounted Display (Built-in) > Frame Source : [Name] (keep it only) pour créer une source d'images [Name] et ne conserver qu'elle.
Par exemple, pour configurer la source d'images pour Apple Vision Pro :
Après cette opération, la source d'images de la session deviendra :
Astuce
Si la session contient déjà la source d'images correspondant à l'appareil et qu'elle est la première source d'images disponible sur cet appareil (par exemple, dans l'image ci-dessus, sur visionOS, VisionOS ARKit est la première source d'images disponible), aucune modification n'est nécessaire. C'est le cas par défaut pour certaines sessions créées via le menu.
Appareils pris en charge par extension
Sélectionnez AR Session (EasyAR), faites un clic droit et utilisez le menu EasyAR Sense > Extensions > Frame Source : [Name] (keep it only) pour créer une source d'images [Name] et ne conserver qu'elle.
Par exemple, pour configurer la source d'images pour le casque Pico :
Après cette opération, la source d'images de la session deviendra :
Prise en charge multi-appareils
Si vous souhaitez que la scène fonctionne sur différents appareils, conservez les autres sources d'images et assurez-vous que la source d'images actuelle de l'appareil peut être sélectionnée.
Utilisez les éléments de menu sans (keep it only) pour ajouter uniquement la source d'images sans supprimer les autres. Par exemple, EasyAR Sense > Extensions > Frame Source : Pico créera une source d'images compatible Pico à la fin de toutes les sources d'images de la session. Généralement, après avoir ajouté la source d'images de cette manière, vous devrez la déplacer à la position appropriée.
Astuce
Dans certains usages avancés, vous pouvez ajuster la position de la source d'images selon vos besoins ou la modifier via du code.
Étapes suivantes
- Configuration de projet Vision Pro
- Configuration de projet XREAL
- Configuration de projet pour d'autres appareils Android