Premiers pas avec AR Foundation

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

La base de la RA d'Unity est un framework multiplate-forme qui vous permet d'écrire des expériences de réalité augmentée une fois, puis de créer des applications pour des appareils Android ou iOS sans apporter de modifications supplémentaires. Le framework est disponible via le package AR Foundation d'Unity.

Le package facultatif ARCore Extensions for AR Foundation d'ARCore ajoute des fonctionnalités à votre application, comme des ancres cloud, des filtres de configuration de l'appareil photo et l'enregistrement et la lecture.

Migrer ou mettre à niveau des projets existants

  • Pour migrer un projet existant depuis le SDK ARCore pour Unity (obsolète) vers la base AR d'Unity et éventuellement avec les extensions ARCore, consultez le guide de migration.
  • Pour mettre à niveau un projet existant à partir d'une version antérieure d'AR Foundation, consultez les guides de mise à niveau et de migration d'Unity.

Conditions requises

Selon votre plate-forme cible, le package AR Foundation nécessite les éléments suivants:

Android

Matériel

  • Un appareil ou un émulateur Android compatible ARCore
  • Un câble USB pour connecter votre appareil à votre ordinateur de développement

Logiciels

iOS

Matériel

Logiciels

Installer AR Foundation

Procédez comme suit pour installer le package Unity AR Foundation.

  1. Ouvrez un projet Unity existant ou créez-en un en 3D.

  2. Accédez à Window > Package Manager.

  3. À côté de Packages, sélectionnez Unity Registry.

  4. Dans la barre de recherche, saisissez "AR Foundation".

  5. Cliquez sur Install.

Installer et activer des packages de plug-ins spécifiques à la plate-forme

Le package Foundation AR présente une interface destinée aux développeurs Unity, mais ne met en œuvre aucune fonctionnalité de RA. Pour utiliser AR Foundation sur un appareil cible, vous devez également installer des packages distincts et activer le plug-in correspondant pour chaque plate-forme correspondante.

Android

Le package du plug-in ARCore XR vous permet de créer des applications de réalité augmentée pour les appareils Android. Suivez ces étapes pour l'installer dans votre projet Unity si votre application cible les appareils Android. Utilisez la même version que le package AR Foundation pour éviter tout problème de compatibilité.

  1. Dans votre projet, accédez à Window > Package Manager.

  2. À côté de Packages, sélectionnez Unity Registry.

  3. Dans la barre de recherche, saisissez "ARCore XR plugin".

  4. Cliquez sur Install.

  5. Accédez à Edit > Project Settings. Dans XR Plug-in Management, ouvrez l'onglet Android et activez ARCore.

iOS

Le plug-in ARKit XR vous permet de créer des applications de réalité augmentée pour les appareils iOS. Suivez ces étapes pour l'installer dans votre projet Unity si votre application cible des appareils iOS. Utilisez la même version que le package AR Foundation pour éviter tout problème de compatibilité.

  1. Dans votre projet, accédez à Window > Package Manager.

  2. À côté de Packages, sélectionnez Unity Registry.

  3. Dans la barre de recherche, saisissez "ARKit XR plugin".

  4. Cliquez sur Install.

  5. Accédez à Edit > Project Settings. Dans XR Plug-in Management, ouvrez l'onglet iOS et activez ARKit.

Configurez une session de RA et ajoutez des composants AR Foundation à votre scène

Une scène nécessite une session de RA pour activer les processus de RA, comme le suivi des mouvements, la compréhension de l'environnement et l'estimation de l'éclairage. Pour exécuter une session de RA, vous aurez besoin des objets de jeu suivants:

  • AR Session : contrôle le cycle de vie d'une expérience de RA.

  • AR Session Origin : transforme les coordonnées RA en coordonnées Unity dans le monde.

Avant d'ajouter les nouveaux objets de jeu, supprimez le Main Camera par défaut. Elle sera remplacée par une nouvelle valeur AR Camera dans AR Session Origin.

Ajoutez les nouveaux objets de jeu en RA à votre scène: effectuez un clic droit sur le volet Hierarchy et sélectionnez XR. Ajoutez un nouvel objet AR Session et un nouvel objet de jeu AR Session Origin.

Configurer les paramètres du lecteur

Android

  1. Accédez à File > Build Settings pour ouvrir la fenêtre Build Settings.
  2. Sous Platform, choisissez Android et cliquez sur Switch Platform.
  3. Cliquez sur Player Settings.
  4. Appliquez les modifications suivantes:

    Player Settings > … Value
    Other Settings > Rendering Décochez Auto Graphics API.
    Si Vulkan est répertorié sous Graphics APIs, supprimez-le, car Vulkan n'est pas encore compatible avec ARCore.
    Other Settings > Package Name Créez un ID d'application unique en utilisant le format du nom de package Java.
    Par exemple, utilisez com.example.helloAR.
    Other Settings > Minimum API Level Si vous créez une application RA requise, spécifiez Android 7.0 'Nougat' (API Level 24) or higher.
    Si vous créez une application en RA facultative, spécifiez Android API Level 19 or higher.
    Other Settings > Scripting Backend Sélectionnez IL2CPP au lieu de Mono pour autoriser l'activation de la compatibilité ARM64 à l'étape suivante.

    Pendant le développement:

    • Utiliser Mono + 32 bits (ARMv7)
    • Installer un fichier APK FAT (32 bits + 64 bits) APK

    Lors de la livraison sur le Play Store:

    • Utiliser IL2CPP
    • Activez les versions 32 bits (ARMv7) et 64 bits (ARM64) pour répondre aux exigences du Play Store 64 bits
    • Facultatif (disponible à partir de 2018.3): dans Build Settings, activez Android App Bundles
    Other Settings > Target Architectures Pour répondre aux exigences 64 bits de Google Play, activez ARM64 (ARM 64 bits). Laissez l'option ARMv7 (ARM 32 bits) activée pour les appareils 32 bits.

iOS

  1. Accédez à File > Build Settings pour ouvrir la fenêtre Build Settings.
  2. Sous Platform, choisissez iOS et cliquez sur Switch Platform.
  3. Cliquez sur Player Settings.
  4. Configurez les paramètres suivants :

    Player Settings > … Value
    Other Settings > Bundle Identifier Ajoutez le nom de votre application dans un format DNS inverse.
    Par exemple, utilisez com.mycompany.myapp.
    Other Settings > Camera usage description Saisissez une description pour expliquer votre utilisation de la RA (par exemple, ARKit).
    Other Settings > Target minimum iOS version 11.0 ou plus
    Other Settings > Architecture ARM64

Étapes suivantes