Utiliser AllSamplesLauncher pour découvrir rapidement les exemples EasyAR

AllSamplesLauncher est un lanceur d'exemples intégré qui vous aide à vous familiariser rapidement avec les fonctionnalités du SDK EasyAR. Grâce à ce lanceur, vous pouvez basculer et exécuter en un clic toutes les scènes d'exemples officielles dans un seul projet Unity, sans avoir à configurer manuellement plusieurs projets indépendants.

Préparation

Avant de commencer, assurez-vous d'avoir effectué les préparatifs suivants :

1. Unity Hub et l'éditeur Unity sont installés
2. Un nouveau projet Unity a été créé
3. Le plugin EasyAR Sense Unity a été importé et tous les Samples ont été importés

Veuillez vous référer aux instructions étape par étape dans le Guide de démarrage rapide.

Étapes détaillées

1. Ouvrez toutes les scènes des Samples.
   
2. Cliquez sur la barre de menu File > Build Settings ou Build Profiles > Scene List.
3. Glissez-déposez toutes les scènes dans la Scene List.
4. Assurez-vous qu'AllSamplesLauncher est la première scène de la liste. Si ce n'est pas le cas, vous pouvez la faire glisser dans la fenêtre.
   
5. Cliquez sur la barre de menu File > Build And Run pour empaqueter et exécuter.

Note

Lors de l'empaquetage pour exécution sur mobile, n'ajoutez pas les scènes liées aux casques :

• Combination_BasedOn_AppleVisionPro
• Combination_BasedOn_Xreal
  

Problèmes rencontrés lors de l'empaquetage

Lors de la compilation et de l'empaquetage, vous pourriez rencontrer des erreurs. Voici les problèmes courants :

Message d'erreur	Cause	Solution
FileNotFoundException:EasyAR Settings Asset	Licence non renseignée	Cliquez sur EasyAR > Sense > Configuration dans la barre de menu, et remplissez votre License Key dans EasyAR Sense License
Missing Prefab Asset: 'XR Interaction Setup'	Fichiers liés au casque manquants	Supprimez les scènes liées aux casques de la liste des scènes à empaqueter. Si vous êtes sûr de vouloir empaqueter pour un casque, suivez les étapes dans Utiliser les exemples de casques

Utilisation du lanceur

Après l'exécution, vous verrez une interface de lanceur épurée.

Cliquez sur le bouton Samples au milieu en bas de l'interface pour accéder aux exemples de toutes les fonctionnalités.

Sur le côté gauche de l'interface se trouvent les catégories de fonctionnalités, et sur la droite, la liste des exemples de scènes pour chaque fonctionnalité. Cliquez sur différentes scènes d'exemples pour découvrir toutes les différentes fonctionnalités offertes par EasyAR.

De plus, des démonstrations vidéo des fonctionnalités EasyAR Sense et EasyAR Mega sont fournies en bas de l'interface, vous aidant à mieux comprendre ce qu'EasyAR peut vous offrir en termes de fonctionnalités et d'effets.

Lectures essentielles avant d'exécuter les exemples

Avant d'exécuter un exemple spécifique, vous devez effectuer les configurations clés suivantes, sinon l'exemple ne fonctionnera pas correctement :

1. Configurez votre API Key

   • Certains exemples (notamment ceux impliquant la reconnaissance cloud, le positionnement cloud Mega, etc.) nécessitent une API Key valide.
   • Dans la barre de menu EasyAR > Sense > Configuration, trouvez les champs correspondants à remplir pour l'exemple concerné.
   • Insérez-y l'App ID, l'API Key et l'API Secret que vous avez obtenus depuis le Centre Développeur EasyAR.
     
   • Important : Si vous n'avez pas encore d'API Key, certains exemples de fonctionnalités locales (comme le suivi d'image) pourront peut-être s'exécuter, mais les fonctionnalités cloud échoueront. Rendez-vous impérativement sur le Centre Développeur EasyAR pour créer une application et obtenir vos clés.

2. Configurez le support XR/Plateforme :

   • Si vous exécutez des exemples liés à des casques, référez-vous aux instructions dans Utiliser les exemples de casques.
   • Assurez-vous que votre appareil (comme un téléphone ou un casque) est correctement connecté et en mode développeur.

Explorer les exemples en profondeur

Le lanceur d'exemples est votre meilleur point de départ pour apprendre. Nous vous recommandons vivement de :

• Exécuter d'abord, étudier ensuite : Utilisez le lanceur pour découvrir rapidement l'effet de chaque exemple, vous faisant ainsi une idée concrète des capacités d'EasyAR.
• Ouvrir les fichiers source des scènes : Chaque exemple est un fichier de scène Unity indépendant, situé dans le répertoire Assets/Samples/EasyAR Sense Unity Plugin/[version]/__All Samples__/[nom de la fonctionnalité]/[nom de l'exemple]/Scenes.
• Étudier et lire le code des scripts : Dans les scènes d'exemples, ouvrez les scripts *.cs fournis pour voir comment nous appelons les API EasyAR pour implémenter des fonctionnalités spécifiques. C'est le meilleur moyen d'apprendre à utiliser les API.

Grâce au lanceur d'exemples, vous pouvez rapidement acquérir une connaissance des fonctionnalités du SDK EasyAR. Bonne exploration !