Utiliser des exemples pour démarrer rapidement avec le développement EasyAR Mega Unity

Ce tutoriel présente comment configurer et exécuter l'exemple EasyAR Mega Unity pour démarrer rapidement avec le développement EasyAR Mega.

Avant de commencer

Avant de lire cet article, assurez-vous d'avoir effectué les étapes suivantes :

• Avoir une bibliothèque de localisation cloud valide.
• Installer Unity (2021.3.30 LTS ou version ultérieure), il est recommandé d'utiliser la dernière version d'Unity 2022.3 ou Unity 6.3.
• Importer les paquets com.easyar.sense-**.tgz et com.easyar.mega-**.tgz selon la méthode Activer Mega.

Exemples d'utilisation (en six étapes)

Ci-dessous, la configuration et l'exécution de l'exemple central MegaBlock_Basic d'EasyAR Mega seront expliquées en six étapes.

Étape 1 : importer l'exemple

Note

Si tous les exemples ont été importés via **All Samples**, cette étape peut être ignorée.

1. Utilisez le menu Window > Package Manager pour ouvrir le gestionnaire de packages, sélectionnez EasyAR Sense Unity Plugin. Dans la section Samples à droite, développez tous les exemples.
2. Choisissez un exemple (par exemple MegaBlock_Basic), cliquez sur Import.

Note

• Ce tutoriel ne s'applique pas directement aux casques VR, mais il est nécessaire de comprendre le flux de travail en développant d'abord pour mobile avant de développer pour un casque.
• Si vous avez précédemment importé des exemples d'une ancienne version du SDK, après la mise à niveau du SDK, supprimez d'abord les anciens exemples avant de les réimporter.

Étape 2 : Remplir la licence key et configurer le service de localisation cloud mega

1. Dans la barre de menu, sélectionnez EasyAR > Sense > Configuration ;
   
2. Collez votre License Key dans le panneau Project Settings ouvert ;
   

Astuce

La licence EasyAR Sense peut être créée sur le Centre de développement EasyAR. Pour une première utilisation, suivez ces étapes :

• Créez EasyAR Sense 4.x Édition personnelle
• Sélectionnez Non pour la carte spatiale éparse
• Remplissez librement le nom de l'application. Pour Bundle ID et Package Name, saisissez com.mycompany.myproject
• Sélectionnez la licence créée, puis cliquez sur le bouton de copie à droite

Note

Bundle ID et Package Name peuvent être modifiés ultérieurement, mais le nombre de modifications est limité. Si vous avez un nom de package d'application défini, vous pouvez également saisir le vôtre.

La création de l'édition personnelle n'est pas limitée en nombre. Les autres types peuvent être créés selon les besoins lors d'une utilisation officielle.

3. Configurez les informations de votre bibliothèque de localisation cloud Mega dans l'élément Mega Block du panneau Project Settings ;
   

Astuce

La configuration de la bibliothèque de localisation cloud Mega peut être obtenue sur le Centre de développement EasyAR.

Assurez-vous que votre API Key dispose des autorisations pour Mega Block. Modifiez-la ou recréez-la si nécessaire.

Étape 3 : Placer le contenu 3D

1. Faites un clic droit dans une zone vide du panneau Hierarchy et ajoutez l'outil de visualisation de Block (développement Unity) ;
   

2. Accédez au service de localisation Mega ;

   1. Sélectionnez le nœud EasyAR.Mega.BlockViewer (Dev), dans le panneau Inspector, remplissez les informations de votre compte EasyAR et connectez-vous ;
      
   2. Cliquez sur le bouton à droite de Mega Cloud Service ;
      
   3. Sélectionnez le Service de localisation Mega que vous souhaitez utiliser, puis cliquez sur OK.
      

3. Charger le Block

   Après avoir sélectionné le service, la liste des Blocks de la bibliothèque actuelle s'affiche sous le nœud MegaBlocks et dans le panneau de l'outil. Cliquez sur Charger pour charger le Block sélectionné :
   

   Une fois le chargement terminé, le Block s'affiche dans la fenêtre Scene. Vous pouvez manipuler la fenêtre Scene pour ajuster l'angle de vue et la position. Vérifiez également si le fichier Block est utilisable (par exemple, si le système de coordonnées du Block est normal, s'il y a des couches, s'il est trop flou, s'il présente des défauts empêchant de trouver un emplacement pour placer les ressources RA, etc.).
   

4. Placer le contenu 3D

   À ce stade, vous pouvez placer des objets 3D en vous référant au Block.
   

   Note

   • Les objets 3D doivent être placés sous le nœud MegaBlocks > Block_* généré automatiquement par l'outil, pour garantir que le rendu du contenu virtuel soit correct lors de l'exécution.
   • Ne modifiez pas le nom du nœud Block_* ni son transform local, il est géré automatiquement par l'outil.

Étape 4 : Configurer MegaTracker

1. Configurer Block Root ;

   Développez AR Session, sélectionnez Mega Block Tracker et définissez Block Root sur le nœud MegaBlocks généré par l'outil.
   

Étape 5 : Modifier la configuration du player

• Android
• iOS

Accédez à File > Build Settings > Player Settings dans le menu Unity, cliquez sur l'icône Android pour afficher les paramètres spécifiques à la plateforme Android.

• Modifiez Package Name pour correspondre au Package Name affiché sur la page de la clé de licence

  

  Astuce

  Par exemple, si le Package Name saisi lors de la création de la clé de licence est com.mycompany.myproject, vous devez impérativement définir le Package Name ici sur com.mycompany.myproject, sinon l'exécution échouera.

• Modifiez Minimum API Level à API Level 21 ou une version ultérieure

  

• Modifiez Scripting Backend en IL2CPP et cochez ARM64 dans Target Architecture

  

Étape six : Construire et exécuter

1. Ajoutez la scène actuelle à File > Build Settings ou Build Profiles > Scene List ;
2. Basculez vers la plateforme cible (par ex. Android / iOS), vérifiez que le nom du package (Bundle ID) et la clé de licence correspondent ;
   
3. Cliquez sur Build And Run.
   

L'effet d'exécution filmé sur place est le suivant :

À propos du texte jaune à l'écran

Durant l'exécution, vous pourriez voir deux zones de texte jaune affichées à l'écran.

1. Message d'avertissement lors d'une simulation

   Il se situe en bas de l'écran :

   

   Cet avertissement apparaît car, avec la configuration par défaut, l'application peut fonctionner hors-site. Cela a un léger impact sur les performances. Si vous l'utilisez sur site, vous pouvez modifier la configuration du MegaTracker avant la compilation.

2. Informations de diagnostic

   Situé en haut de l'écran, il permet de comprendre l'état de la session et d'identifier les problèmes. Il est recommandé de le laisser affiché pendant les phases de développement et de test :

   

   Consultez Informations de diagnostic dans la scène pour comprendre rapidement comment configurer et utiliser ces données.

Prochaines étapes : de l'initiation à la maîtrise

Félicitations ! Grâce aux étapes ci-dessus, vous avez réussi à exécuter l'exemple principal d'EasyAR Mega en 10 minutes, expérimentant personnellement le charme du positionnement spatial et de la superposition de contenu AR.

Maintenant que vous maîtrisez les bases. Si vous souhaitez :

• Construire des applications AR plus stables et plus efficaces
• Mettre en œuvre des effets complexes comme l'occlusion réelle-virtuelle et l'alignement du contenu
• Déboguer sans équipement ou lorsque vous ne pouvez pas vous rendre sur site

Consultez les guides approfondis ci-dessous. Ils vous aideront à résoudre les problèmes pratiques rencontrés lors du développement.

Développement avancé

Si vous souhaitez comprendre la configuration complète du projet, vous pouvez vous référer aux éléments suivants:

• Utilisation du pipeline de rendu universel (URP)
• Configuration du player
• Configuration d'EasyAR

Si vous souhaitez approfondir l'utilisation d'EasyAR, commencez ici:

• Bases des applications Unity pilotées par AR

Nous vous recommandons également de lire les contenus suivants pour vous aider dans le développement et le débogage:

• Diagnostic et signalement des problèmes dans le développement Unity
• Simulation d'exécution AR dans Unity

Contrôle précis des fonctionnalités Mega

Les contenus suivants vous aideront à mieux utiliser Mega dans votre application :

• Utilisation sur site et simulation
• Bonnes pratiques pour les sessions AR
• Ajout de cibles de suivi
• Création de contenus 3D alignés avec le monde réel
• Occlusion environnementale
• Contrôle du processus de suivi

Les contenus suivants vous permettent de valider les fonctionnalités Mega sans vous déplacer :

• Validation rapide avec caméra PC
• Simulation avec l'outil de vérification de session

Thèmes avancés

Le contenu ci-dessous est plus adapté après avoir acquis une certaine expérience avec EasyAR.

Si vous souhaitez exécuter EasyAR Mega sur un casque, vous pouvez consulter les éléments suivants :

• Prise en charge des casques par EasyAR dans Unity
• Utiliser les exemples EasyAR sur un casque XR ou des lunettes

Si vous souhaitez utiliser AR Foundation, vous pouvez commencer ici :

• Prise en charge d'Unity XR par EasyAR