Introduction du modèle de package d'extension pour casque

Le package com.easyar.sense.ext.hmdtemplate est un exemple et un modèle fourni pour le développement d'extensions pour casques. Il s'agit d'une implémentation SDK et contient des exemples pour les développeurs d'applications.

Contenu du modèle

La structure de package suit la disposition de fichiers recommandée par Unity :

.
├── CHANGELOG.md
├── Documentation~
├── Editor
├── LICENSE.md
├── package.json
├── Runtime
└── Samples~
    └── Combination_BasedOn_HMD

Parmi les contenus importants :

• Runtime : Dossier contenant les ressources de plateforme d'exécution. C'est le dossier le plus important du modèle.
• Samples~ : Dossier contenant tous les exemples du package. Il contient des exemples pour une utilisation en aval, pouvant servir de démo pour tester l'extension. Pour développer cet exemple en local, renommez le dossier en Samples. Utiliser la méthode Client.Pack le renommera automatiquement en Samples~ lors de l'empaquetage d'une nouvelle version.
• Editor : Dossier contenant les ressources de plateforme d'édition. Les scripts de ce dossier servent principalement à créer des éléments de menu.
• package.json : Fichier manifeste du package.

Processus de création de l'exemple de modèle

1. Ajouter une session AR

   Dans la vue Hierarchy :

   • Cliquez droit dans un espace vide, ajoutez ARSession via le menu EasyAR Sense > Mega > AR Session (Mega Block Default Preset).
   • Sélectionnez AR Session (EasyAR), cliquez droit, ajoutez un ImageTrackerFrameFilter à la session via EasyAR Sense > Image Tracking > Frame Filter : Image Tracker.
   • Sélectionnez AR Session (EasyAR), cliquez droit, ajoutez un DenseSpatialMapBuilderFrameFilter via EasyAR Sense > SpatialMap > Frame Filter : Dense SpatialMap Builder.
   • Sélectionnez AR Session (EasyAR), cliquez droit, ajoutez un SparseSpatialMapBuilderFrameFilter via EasyAR Sense > SpatialMap > Frame Filter : Sparse SpatialMap Builder.
   • Sélectionnez AR Session (EasyAR), cliquez droit, ajoutez et conservez uniquement FrameSource via EasyAR Sense > Extensions > Frame Source : HMD Template (keep it only).

   

2. Ajouter ImageTargetController

   Dans la vue Hierarchy, cliquez droit dans un espace vide, ajoutez un ImageTargetController via EasyAR Sense > Image Tracking > Target : Image Target.

   Configurez ImageTargetController :

   

   Après cette configuration, l'image affichée dans la vue Scene est un gizmo. Cet exemple utilise un quad pour afficher le même objet virtuel.

   Ajoutez l'objet virtuel à afficher sur la cible :

   

3. Ajouter un modèle comme référence d'origine pour le suivi de mouvement

   Ce modèle est important pour les développeurs et utilisateurs en aval, servant à découpler le suivi de mouvement de l'appareil des algorithmes EasyAR.

   

4. Ajouter l'interface utilisateur de sélection de fonctionnalité

   

5. Désactiver les fonctionnalités EasyAR au démarrage et les activer via l'interface utilisateur

   Par exemple, désactivez le suivi d'image au démarrage en définissant enable sur false pour le composant correspondant :

   

   Ajoutez ensuite la gestion des interrupteurs d'interface utilisateur :

   

Sujets connexes

• Activer la prise en charge d'EasyAR pour les casques explique comment utiliser ce modèle pour créer un nouveau package d'extension pour casque
• Validation de fonctionnement (bring-up) explique comment utiliser l'exemple fourni par ce modèle pour vérifier la correction de l'extension d'entrée
• Publier le package d'extension explique comment finaliser l'empaquetage et la distribution basés sur ce modèle