Table of Contents

Utiliser l'exemple EasyAR sur un casque XR ou des lunettes

EasyAR fournit un exemple unifié pour tous les casques, sans aucun code, entièrement configuré dans la scène. L'utilisation des fonctionnalités peut se référer à leur implémentation dans les exemples pour téléphones Android/iOS.

Les exemples pour casques sont nommés Combination_BasedOn_*, par exemple Combination_BasedOn_Pico pour Pico. Cet exemple démontre la plupart des fonctionnalités d'EasyAR dans une seule scène. Elles peuvent être activées/désactivées dynamiquement, utilisées individuellement ou simultanément.

Préparatifs

  • Vérifiez que votre casque ou lunettes figure dans la liste des appareils pris en charge par EasyAR
  • Téléchargez et importez le package du plugin Unity EasyAR
  • Téléchargez et importez le package d'extension pour appareils XR Unity EasyAR
  • Obtenez une licence EasyAR adaptée aux casques ou lunettes XR. Les types de licences disponibles incluent:
    • Licence XR d'essai EasyAR Sense 4.x (essai, activable sur le site web EasyAR)
    • Licence XR commerciale EasyAR Sense 4.x (payante, contactez le service commercial)
    • Licence XR entreprise EasyAR Sense 4.x (pour le SDK Entreprise)
Attention

Seule la licence XR est autorisée sur les casques et lunettes. Une licence standard ne fonctionnera pas.

Importer les exemples officiels

  1. Les exemples pour les appareils intégrés sont inclus dans le package du plugin Unity EasyAR. Importez l'exemple spécifique à votre appareil. xr-samples-location

  2. Les exemples pour les appareils pris en charge par extension sont fournis avec l'extension du casque correspondante. Importez-les dans votre projet Unity via l'éditeur. Exemple pour Pico: xr-pico-extension

Générer et exécuter l'exemple

Suivez la configuration du projet pour le casque et les instructions d'utilisation de l'exemple.

Instructions d'utilisation

L'exemple comprend plusieurs boutons dont les fonctions sont décrites ci-dessous. xr-sample-usage-7

  • Bouton 1 HUD : Bascule le mode d'affichage de l'UI. Par défaut, l'UI est fixe dans le monde réel. Activer HUD l'affiche constamment devant les yeux.
  • Bouton 2 Record : Active/désactive l'enregistrement EIF. L'enregistrement doit être arrêté (OFF) pour obtenir un fichier EIF valide. Sinon, le fichier sera inutilisable.
  • Bouton 3 Image : Active/désactive le suivi d'image.
  • Bouton 4 Image Fusion : Active/désactive le mode suivi d'image + fusion de mouvement.
  • Bouton 5 Dense : Active/désactive la cartographie spatiale dense.
  • Bouton 6 Sparse : Active/désactive la cartographie spatiale clairsemée.
  • Bouton 7 Mega : Active/désactive Mega.

Détails des fonctionnalités

  • Activation par défaut des fonctionnalités

    Toutes les fonctionnalités sont désactivées par défaut au démarrage. Ceci est réalisé en désactivant les scripts correspondants dans l'éditeur. Les boutons activent/désactivent ces scripts. Vous pouvez configurer les fonctionnalités activées par défaut selon vos besoins.

    hmd-default-disable

  • Référence de l'origine du système de coordonnées

    Un modèle de panda statique est placé à l'origine du système de coordonnées du suivi de mouvement pour vérifier son état. Ce modèle aide au diagnostic, par exemple pour détecter une dérive rapide lors de l'utilisation de Mega (problème de suivi du périphérique). Le panda dérivera alors également. Vous pouvez ajuster ou supprimer ce modèle selon vos besoins.

  • Utilisation de l'image intégrée pour le suivi

    • L'exemple préconfigure la taille de l'image utilisée pour le suivi planaire. Imprimez namecard.jpg sur du papier A4 sans étirement, ni recadrage, en remplissant la page autant que possible (voir ci-dessous). namecard

    • Mesurez la longueur réelle de l'image imprimée sur le papier. Dans la scène Unity, définissez l'échelle (Scale) de la Image Target sur la taille physique réelle mesurée (en mètres). set-the-actual-size

    • Lorsque la Fusion de mouvement EasyAR est activée, seule une image en position fixe (immobile) peut être suivie. Si la fusion de mouvement est désactivée, le suivi est perdu lorsque l'image sort du champ de vision.

    • Parfois, le champ de vision des lunettes ne reflète pas bien la taille de l'image. Si la détection échoue, rapprochez l'appareil de l'image. Pour un usage réel, privilégiez le suivi de grandes images (ex: 5m x 5m).

Note

Sur les casques, que la fonction de fusion de mouvement EasyAR soit activée ou non, le paramètre échelle (Scale) de la image target doit être défini sur sa taille physique réelle. Sinon, le placement affiché sera incorrect.