Table of Contents

Utiliser des exemples pour démarrer rapidement avec le développement easyar unity

Ce tutoriel explique comment configurer et exécuter les exemples easyar unity pour démarrer rapidement avec le développement ar.

Préparer un projet Unity vide

Assurez-vous d'avoir installé une version compatible d'Unity (Unity 2021.3 ou ultérieure). Il est recommandé d'utiliser la dernière version d'Unity 2022.3 ou d'Unity 6.3.

Créez un projet Unity vide en utilisant le modèle 3D (Built-in Render Pipeline) :

Note

Il n'est pas recommandé d'utiliser URP lors de la première utilisation.

Si vous utilisez Unity 6, vous devez télécharger et utiliser manuellement le modèle 3D (Built-In Render Pipeline) Template. Par défaut, il se trouve vers le bas de la liste des modèles.

Important

Pour utiliser URP, vous devez effectuer une configuration supplémentaire comme indiqué dans Universal Render Pipeline (URP), sinon l'image de la caméra ne s'affichera pas.

Importer EasyAR Sense Unity Plugin

  • Télécharger le package du plugin
    • Téléchargez la dernière version de EasyAR Sense Unity Plugin, qui inclut des exemples (sample).
    • Après avoir décompressé le fichier zip, vous verrez un readme et des fichiers .tgz. Les fichiers .tgz peuvent être importés directement dans Unity, ne les décompressez pas.
    • Placez le fichier .tgz dans le dossier Packages de votre projet Unity.
  • Importer le package du plugin
    • Dans la barre de menu, cliquez sur Window puis sélectionnez Package Manager.
    • Dans la fenêtre qui s'ouvre, cliquez sur le + en haut à gauche et choisissez Install Package from tarball ....
    • Dans la boîte de dialogue, sélectionnez le fichier .tgz mentionné précédemment.

ImportUnityPlugin

Note

Le fichier .tgz ne doit pas être supprimé ou déplacé après son importation dans Unity. Placez-le à un emplacement approprié avant l'importation. Il est généralement recommandé de le placer dans le dossier Packages du projet Unity pour faciliter la gestion de version.

Importer un exemple

Utilisez le menu Window > Package Manager pour ouvrir le Package Manager, sélectionnez EasyAR Sense Unity Plugin, puis choisissez **All Samples** à droite pour importer tous les exemples en une seule fois.

ImportSample

Attention

**All Samples** et les autres exemples ne peuvent pas être importés simultanément, sinon des doublons apparaîtront, entraînant la perte de certaines ressources de scène. Si des fichiers en double ont été accidentellement importés, supprimez-les et réimportez.

Modifier la liste des scènes

Ouvrez Build Settings (ou Build Profiles),

Ajoutez les scènes d'exemple du projet Unity à la Scene List de Build Settings ou Build Profiles, et déplacez la scène du lanceur d'exemples (AllSamplesLauncher) en première position de toutes les scènes.

Attention

Attention à ne pas ajouter ces scènes pour casques, sinon la compilation pourrait échouer :

  • Combination_BasedOn_AppleVisionPro.rst
  • Combination_BasedOn_Xreal.rst

Remplir la licence (License Key)

Depuis le menu Unity, sélectionnez EasyAR > Sense > Configuration pour afficher l'interface de configuration d'EasyAR Sense.

FillInKey

Dans le champ de texte sous Licence EasyAR Sense, entrez la licence EasyAR Sense.

FillInKey2

Astuce

La licence EasyAR Sense peut être créée depuis le centre de développement EasyAR (中文, 英文). Pour une première utilisation, suivez ces étapes :

  • Créez EasyAR Sense 4.x Édition personnelle
  • Pour la carte spatiale éparse, sélectionnez Oui, et entrez un nom quelconque
  • Le nom de l'application est libre, pour Bundle ID et Package Name, entrez com.mycompany.myproject
  • Sélectionnez la licence nouvellement créée, puis cliquez sur le bouton de copie à droite

copykey

Note

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

La création de l'édition personnelle n'a pas de limite de nombre. Les autres types peuvent être créés selon les besoins lors d'une utilisation formelle.

Exécution dans l'éditeur

L'exécution dans l'éditeur nécessite que votre ordinateur soit connecté à une caméra.

Confirmer le bon fonctionnement de la caméra système

Ouvrir l'application caméra du système :

Confirmer que la caméra fonctionne normalement :

Enfin, veillez à fermer l'application caméra pour éviter tout conflit lors de l'exécution des exemples.

Note

EasyAR utilise uniquement l'interface fournie par le système pour accéder à la caméra. Assurez-vous que l'application caméra du système peut ouvrir la caméra et afficher correctement l'image.

Exemple d'exécution

Le contenu suivant prend l'exemple de suivi d'image ImageTracking_Targets comme exemple, les autres exemples s'exécutent de manière similaire.

Ouvrez la scène du lanceur d'exemple et cliquez sur le bouton Play en haut de l'éditeur Unity.

Entrez dans la scène ImageTracking_Targets.

Astuce

Vous pouvez aussi ouvrir directement la scène ImageTracking_Targets et l'exécuter.

Pointez la caméra vers l'image cible suivante :

namecard

Lien de téléchargement : 🔗 namecard

EasyAR reconnaîtra et suivra cette image, et superposera des objets virtuels.

Note

Certaines fonctionnalités ne peuvent pas être exécutées avec la caméra connectée dans l'éditeur, mais fonctionnent sur mobile. Les exemples inutilisables dans l'éditeur afficheront une fenêtre d'échec au démarrage.

Un message d'erreur et un log seront également affichés.

Exécution sur téléphone mobile

Pour exécuter sur téléphone mobile, un packaging est nécessaire. Avant le packaging, modifiez la configuration du Player.

Modifier la configuration du player

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

switchtoandroid

  • Modifiez le Package Name avec le Package Name affiché sur la page de la License Key

    androidPackageName

    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 définir le Package Name ici comme com.mycompany.myproject, sinon l'application ne fonctionnera pas.

  • Modifiez le Minimum API Level en API Level 21 ou version ultérieure

    androidAPILevel

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

    androidarm64

Empaquetage de l'application

Sélectionnez File > Build Settings, choisissez la plateforme cible (Android/iOS), puis sélectionnez switch platform.

switchplatform

Sélectionnez Build ou Build And Run pour compiler le projet et l'installer sur le téléphone. Lors de l'exécution, autorisez les permissions nécessaires.

buildandrun

Exemple d'exécution

Le contenu suivant prend comme exemple le suivi d'image ImageTracking_Targets. Les autres exemples s'exécutent de manière similaire.

Après l'exécution, la scène du lanceur d'exemples doit démarrer.

Astuce

Si vous n'arrivez pas dans la scène du lanceur d'exemples après l'ouverture, vérifiez que vous avez correctement configuré la liste des scènes dans Build Settings ou Build Profiles, et déplacez AllSamplesLauncher en première position.

Accédez à la scène ImageTracking_Targets.

Dirigez l'appareil photo du téléphone vers l'image de reconnaissance suivante :

namecard

Lien de téléchargement : 🔗 namecard

EasyAR reconnaîtra et suivra cette image, puis superposera des objets virtuels.

Prochaines étapes

Vous avez exécuté avec succès l'exemple Unity AR et vous vous demandez peut-être comment la scène AR présentée dans l'exemple a été créée. Vous pouvez lire les guides de démarrage suivants dans l'ordre :

Pour le lanceur d'exemples, consultez les instructions détaillées :

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

Si vous souhaitez approfondir votre compréhension de l'utilisation d'EasyAR, commencez ici :