Création et téléchargement d'annotations à l'aide de l'éditeur Unity

Cet article explique comment créer et télécharger des annotations à l'aide de Mega Studio dans l'éditeur Unity.

Avant de commencer

Savoir utiliser Mega Studio dans Unity
Préparer le modèle : Utilisez le modèle présent dans l'exemple de projet (un panda adorable), ou le modèle de petit robot utilisé dans la démo officielle de xr-frame, ou préparez un fichier de modèle conforme aux exigences de xr-frame en vous référant aux formats GLTF chargeables par XRFame et extensions prises en charge.
Importez le fichier du modèle dans Unity.

Astuce

La dépendance à com.unity.cloud.gltfast a déjà été ajoutée au plugin Mega, vous pouvez donc glisser-déposer directement le fichier du modèle dans les Assets d'Unity.

Pourquoi des annotations sont nécessaires

EasyAR Mega Annotation (EMA) permet de synchroniser des positions spatiales multiplateformes (définitions de systèmes de coordonnées différentes).

Unity

Système de coordonnées local des annotations dans l'environnement Unity : L'axe X pointe vers l'arrière, Y vers le haut et Z vers la droite.

xr-frame

Système de coordonnées local des annotations dans l'environnement xr-frame : L'axe X pointe vers l'arrière, Y vers le haut et Z vers la gauche.

Ces différences d'orientation proviennent des définitions de systèmes de coordonnées différents (gaucher/droitier) utilisés par Unity et xr-frame.

L'utilisation d'EMA pour synchroniser les positions spatiales présente des avantages significatifs :

Simplifie le flux de développement : Traite automatiquement les conversions de coordonnées multiplateformes, évitant une logique manuelle fastidieuse et sujette aux erreurs.
Améliore l'efficacité du débogage : Permet un chargement direct sur MegaToolbox, facilitant les tests rapides sur appareil et la validation des données.

Étapes de fonctionnement

Créer l'outil d'annotation

Dans le panneau Hierarchy d'Unity, cliquez droit et sélectionnez : EasyAR Mega > Tool > Annotation Tool (Edit Mode).

Après la création, deux nœuds sont générés dans la scène : EasyAR.Mega.Annotation et MegaBlocks.

Sélectionnez le nœud EasyAR.Mega.Annotation. Dans son panneau Inspector, des champs pour le nom d'utilisateur/e-mail et le mot de passe apparaissent.
Connecter le compte

Entrez le compte et le mot de passe EasyAR, puis cliquez sur Login. Si la connexion réussit, les outils Studio s'affichent dans le panneau Inspector.
Sélectionner la bibliothèque de localisation Mega Cloud

Cliquez sur l'icône à droite de Mega Cloud Service.

Sélectionnez la bibliothèque à utiliser.

Une fois la bibliothèque et les informations Mega Blocks chargées, le panneau des outils Studio apparaît comme suit :
Charger le modèle dense d'un Block

Cliquez sur Load à droite du nom du Block pour charger dynamiquement son modèle dense.

Le modèle chargé apparaît dans la vue Scene. Notez que lorsque l'icône suivante s'affiche en bas à gauche, le modèle dans le champ de vision n'est pas encore entièrement chargé. Attendez que cette icône disparaisse pour indiquer que le chargement est terminé.
Créer une annotation

Maintenez la touche Ctrl (Windows) ou Command (Mac) enfoncée dans la scène, puis cliquez avec le bouton gauche de la souris à l'endroit souhaité.
Utiliser un modèle

Glissez-déposez le modèle importé dans la scène en tant qu'enfant du nœud d'annotation.

Dans le panneau Inspector du modèle, définissez Position et Rotation sur 0. Ajustez Scale selon les besoins.

Note

L'EMA gère toute la logique de conversion des coordonnées. Définir Position et Rotation du modèle sur 0 permet d'aligner son centre géométrique avec le point d'annotation. Tous les ajustements de position et d'orientation doivent être effectués via son nœud parent (le nœud d'annotation).
[Optionnel] Ajuster précisément la position du modèle

Pour un ajustement précis de la position et de l'orientation du modèle, consultez Comment aligner précisément du contenu 3D avec le monde réel à l'aide de l'éditeur Unity.
Créer un nouveau package de données d'annotation

Cliquez sur l'icône à droite du champ Annotation package dans le panneau Inspector.

Entrez le nom du package de données d'annotation dans la zone et cliquez sur la coche à droite.

Après création réussie, l'affichage doit être comme suit. Cliquez ensuite sur OK en bas.

Cliquez sur l'icône de téléversement pour lancer l'envoi.

Une notification s'affiche après un téléversement réussi.
Enregistrer l'ID de l'annotation

Vous devez noter le nom ou l'ID des données d'annotation pour charger les données correspondantes dans xr-frame.

Après téléversement réussi, vous pouvez également voir les informations correspondantes dans la bibliothèque de localisation cloud.

Vous pouvez aussi consulter ici le nom et l'ID des données d'annotation téléversées.