Démarrage rapide avec les exemples de développement EasyAR Mega Unity

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

Avant de commencer

Avant de lire cet article, assurez-vous d'avoir terminé :

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

Note

Ce tutoriel ne s'applique qu'aux plugins Unity de version >= 4003. Si vous avez téléchargé une ancienne version mais continuez de lire ce document d'initiation, vous devez d'abord télécharger la dernière version du plugin.

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.

Deuxième étape: configurer le SDK et le service de localisation cloud Mega

1. Sélectionnez EasyAR > Sense > Configuration dans la barre de menus ;
   

2. Collez votre License Key dans le panneau Project Settings qui s'ouvre ;
   

   Astuce

   Une licence EasyAR Sense peut être créée sur le centre de développement EasyAR. Pour la première utilisation, vous pouvez la créer selon les étapes suivantes :

   

   • Créer EasyAR Sense 4.x version personnelle
   • Sélectionnez non pour la carte spatiale sparse
   • Remplissez n'importe quel nom d'application, remplissez com.mycompany.myproject pour le Bundle ID et le Package Name
   • Sélectionnez la licence que vous venez de créer, entrez et cliquez sur le bouton de copie à droite

   

   Note

   Le Bundle ID et le Package Name peuvent être modifiés par la suite, mais le nombre de modifications est limité. Si vous avez un nom de package d'application défini, vous pouvez également remplir votre propre nom de package.

   Il n'y a aucune limite sur le nombre de créations de version personnelle, les autres types peuvent être créés selon les besoins lors de l'utilisation officielle.

3. Vérifiez et activez l'option Mega > Mega Block/Landmark support dans le panneau Project Settings ;
   

4. Configurez les informations de votre base de données de localisation cloud Mega dans l'entrée Mega Block du panneau Project Settings ;
   

   Astuce

   La configuration de la base de données de localisation cloud Mega peut être obtenue depuis le centre de développement EasyAR.
   
   Assurez-vous que votre API Key dispose des droits d'accès Mega Block et SpatialMap, si ce n'est pas le cas, vous devez le modifier ou le recréer.
   
   Si vous ne trouvez pas la base de données de localisation, vous devez d'abord configurer correctement la base de données de localisation, puis vérifier à nouveau que la base de données de localisation cloud est valide.

Étape 3 : Configurer le mega block

1. Configurez le Mega Block;

   Sélectionnez Mega Block et renseignez l'ID et le nom du Block.
   

   Astuce

   L'ID et le nom du Block peuvent être obtenus depuis la bibliothèque de localisation correspondante dans le centre de développement EasyAR.
   
   Si la bibliothèque de localisation ne contient pas de données de Block, il est nécessaire de ajouter les Blocks requis dans la bibliothèque de localisation, puis de vérifier à nouveau que la bibliothèque de localisation cloud est valide.

Quatrième étape : placer le contenu 3d

1. Sélectionnez Mega Block et créez un outil d'éditeur ;

   

2. Vérifiez les informations de service et connectez-vous au service ;

   

   Astuce

   Si vous n'avez pas effectué d'autres modifications, les informations de service doivent être identiques à celles renseignées dans Project Settings.

   Après une connexion normale au service, vous devriez voir l'interface de contrôle pour l'heure de mise à jour et les données de l'éditeur de block.
   

3. Charger les données de l'éditeur de block ;

   Cliquez sur la première case de sélection sous les données de block, cela lancera le processus de chargement des données de l'éditeur de block. Après le chargement, vous pouvez voir le maillage du block actuel dans la fenêtre Scene :
   

   Astuce

   Le maillage de block change de LOD en fonction de la position de la caméra, vous devez rester connecté à internet.

4. Placer le contenu 3d

   À ce stade, vous pouvez placer vos objets 3d en vous référant au maillage du block.
   

   Note

   • Les objets 3d doivent impérativement être placés sous le nœud du block, pour garantir que la position de rendu du contenu virtuel est correcte à l'exécution.
   • Les objets 3d ne peuvent pas être placés sous le nœud EasyAR.Mega.EditorTool : ce nœud est uniquement destiné à l'outil d'éditeur, et il sera automatiquement supprimé ou recréé dans certains cas.

Étape 5 : Modifier la configuration du player

• Android
• iOS

Dans le menu Unity, allez dans File > Build Settings > Player Settings, cliquez sur l'icône Android pour afficher les paramètres correspondants à la plateforme Android.

• Modifiez le Package Name pour qu'il corresponde au Package Name affiché sur la page de la License Key.

  

  Astuce

  Par exemple, si le Package Name que vous avez saisi lors de la création de la License Key est com.mycompany.myproject, vous devez impérativement saisir com.mycompany.myproject ici comme Package Name, sinon l'exécution échouera.

• Modifiez le Minimum API Level en API Level 24 ou une version supérieure.

  

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

  

Étape six: construire et exécuter

1. Ajoutez la scène actuelle dans File > Build Settings ou Build Profiles > Scene List ;
   
2. Basculez vers la plateforme cible (ex. Android / iOS), vérifiez que le nom de paquet (Bundle ID) correspond à la License Key ;
   
3. Cliquez sur Build And Run.
   

L'effet d'exécution pris 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