Premiers pas avec AR Foundation

AR Foundation d'Unity est un framework multiplate-forme qui vous permet d'écrire des expériences de réalité augmentée (RA) une seule fois, puis de les compiler pour les 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 supplémentaires pour vous permettre d'utiliser des fonctionnalités telles que les ancres cloud, les filtres de configuration de l'appareil photo, et l'enregistrement et la lecture dans votre application.

Migrer ou mettre à niveau des projets existants

  • Pour migrer un projet existant du SDK ARCore pour Unity (obsolète) vers la plate-forme AR Foundation d'Unity et, éventuellement, 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 avec 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.

  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 AR Foundation présente une interface utilisable par les développeurs Unity, mais n'implémente aucune fonctionnalité de RA en soi. 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.

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" (Plug-in ARCore XR).

  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" (Plug-in ARKit XR).

  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 a besoin d'une session de RA pour activer des processus de RA, tels que le suivi du mouvement, la compréhension de l'environnement et l'estimation de l'éclairage. Vous aurez besoin des objets de jeu suivants pour lancer une session de RA:

AR Foundation 4.x

  • 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 mondiales Unity.

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

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

AR Foundation 5.x

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

  • XR Origin: transforme les coordonnées RA en coordonnées mondiales Unity.

Avant d'ajouter les nouveaux objets de jeu, supprimez le Main Camera par défaut. Elle sera remplacée par un nouveau AR Camera dans XR Origin.

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

Configurer les paramètres du lecteur

Android

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

    Player Settings > … Valeur
    Other Settings > Rendering Décochez Auto Graphics API.
    Si Vulkan figure 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 à l'aide d'un format de nom de package Java.
    Par exemple, utilisez com.example.helloAR.
    Other Settings > Minimum API Level Si vous créez une application AR requise, spécifiez Android 7.0 'Nougat' (API Level 24) or higher.
    Si vous créez une application RA facultative, spécifiez Android API Level 19 or higher.
    Other Settings > Scripting Backend Sélectionnez IL2CPP au lieu de Mono pour permettre l'activation de la prise en charge d'ARM64 à l'étape suivante.

    Pendant le développement:

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

    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 la version 2018.3): dans Build Settings, activez Android App Bundles.
    Other Settings > Target Architectures Pour répondre aux exigences de version 64 bits de Google Play, activez ARM64 (ARM 64 bits). Laissez ARMv7 (ARM 32 bits) activé pour prendre en charge les appareils 32 bits.

iOS

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

    Player Settings > … Valeur
    Other Settings > Bundle Identifier Ajoutez le nom de votre application au 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