Premiers pas avec les extensions ARCore pour AR Foundation

Le package facultatif ARCore Extensions for AR Foundation ajoute des fonctionnalités au package AR Foundation d'Unity, ce qui vous permet d'utiliser des fonctionnalités telles que Cloud Anchors, les filtres de configuration de l'appareil photo et l'enregistrement et la lecture dans votre application.

Conditions requises

Pour développer avec ARCore Extensions for AR Foundation, vous avez besoin des éléments suivants:

Android

Matériel

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

Logiciels

iOS

Matériel

  • Un appareil compatible ARKit compatible ARKit
  • Un câble USB pour connecter votre appareil à votre ordinateur de développement

Logiciels

Installer le package d'extensions ARCore

Pour installer des extensions ARCore pour AR Foundation, procédez comme suit.

Dépendances groupées

  1. Assurez-vous qu'AR Foundation est installé et configuré dans votre environnement de développement.
  2. Ouvrez ou créez un projet Unity.
  3. Sélectionnez la plate-forme de compilation cible souhaitée :
    1. Dans le menu File, sélectionnez Build Settings.
    2. Sélectionnez Android ou iOS, selon la plate-forme cible souhaitée.
    3. Cliquez sur Switch Platform.

  4. Importez le dernier package d'extensions ARCore:

    1. Accédez à Window > Package Manager.

    2. Cliquez sur le bouton et choisissez l'option Add package from git URL... dans le menu déroulant.

    3. Collez l'URL suivante dans la zone de texte:

      https://github.com/google-ar/arcore-unity-extensions.git

    4. Cliquez sur Add.

Sans EDM4U

Par défaut, ARCore Extensions est fourni avec des dépendances supplémentaires. Lorsque vous utilisez d'autres bibliothèques (par exemple, Firebase Analytics) qui dépendent d'une autre version d'External Dependency Manager for Unity, un comportement non défini peut se produire, ce qui peut entraîner l'arrêt du fonctionnement des dépendances.

Installez les extensions ARCore sans dépendances groupées pour éviter les conflits de gestion des versions des bibliothèques:

  1. Téléchargez les extensions ARCore sans version EDM4U et com.google.external-dependency-manager.
  2. Suivez les instructions pour importer des packages UPM avec des fichiers .tgz et les installer dans l'ordre suivant :
    1. com.google.external-dependency-manager,
    2. Extensions ARCore (sans EDM4U).

Lors de l'installation de ARCore Extensions, Unity installe également automatiquement une version appropriée des dépendances requises:

  • AR Foundation
  • ARCore XR Plugin (utilisé pour cibler Android)
  • ARKit XR Plugin (utilisé pour le ciblage sur iOS)

Ces dépendances peuvent ne pas être visibles dans la vue Package Manager > Package: In project. Toutefois, les packages peuvent être visibles dans la fenêtre Project sous Packages.

Configurer des extensions ARCore

AR Foundation 4.x

  1. Dans le volet Hierarchy, effectuez un clic droit et ajoutez les objets de jeu suivants (s'ils ne sont pas déjà ajoutés):

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

  2. Dans le volet Hierarchy, sélectionnez le package ARCore Extensions.

  3. Dans le volet Inspector, pour chacun des champs suivants, cliquez sur le bouton cible , puis connectez chaque champ à l'objet de jeu correspondant, comme suit:

    • Session: utiliser l'élément AR Session de la scène
    • AR Session Origin: utiliser le AR Session Origin de la scène.
    • Camera Manager: utiliser l'élément AR Camera de la scène

  4. Si vous le souhaitez, créez et connectez les éléments suivants pour les ancres cloud et les filtres de configuration de caméra.

    1. Dans le volet Project > Assets, effectuez un clic droit et sélectionnez Create > XR > ARCore Extensions Config.

    2. Dans le volet Project > Assets, effectuez un clic droit et sélectionnez Create > XR > Camera Config Filter.

    3. Dans le volet Hierarchy, sélectionnez le package ARCore Extensions.

    4. Dans le champ ARCore Extensions Config du volet Inspector, cliquez sur le bouton cible , puis connectez-vous à l'élément ARCoreExtensionsConfig.

    5. Dans le champ Camera Config Filter du volet Inspector, cliquez sur le bouton cible , puis connectez-vous à l'élément ARCoreExtensionsCameraConfigFilter.

      Pour en savoir plus, consultez le guide du développeur Cloud Anchors et le guide de configuration de la caméra.

    6. Si vous utilisez une version d'Unity antérieure à 2020.3:

      • Sélectionnez Custom Gradle Properties Template (Modèle des propriétés Gradle personnalisées) dans Project Settings > Player > Android > Publishing Settings > Build (Paramètres du projet > Lecteur > Android > Paramètres de publication > Compiler).

Avec tous les champs d'extensions ARCore ci-dessus connectés correctement, le volet Inspector des extensions ARCore se présente comme suit:

AR Foundation 5.x

  1. Dans le volet Hierarchy, effectuez un clic droit et ajoutez les objets de jeu suivants (s'ils ne sont pas déjà ajoutés):

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions

  2. Dans le volet Hierarchy, sélectionnez le package ARCore Extensions.

  3. Dans le volet Inspector, pour chacun des champs suivants, cliquez sur le bouton cible , puis connectez chaque champ à l'objet de jeu correspondant, comme suit:

    • Session: utiliser l'élément AR Session de la scène
    • XR Origin: utiliser le XR Origin de la scène.
    • Camera Manager: utiliser l'élément AR Camera de la scène

  4. Si vous le souhaitez, créez et connectez les éléments suivants pour les ancres cloud et les filtres de configuration de caméra.

    1. Dans le volet Project > Assets, effectuez un clic droit et sélectionnez Create > XR > ARCore Extensions Config.

    2. Dans le volet Project > Assets, effectuez un clic droit et sélectionnez Create > XR > Camera Config Filter.

    3. Dans le volet Hierarchy, sélectionnez le package ARCore Extensions.

    4. Dans le champ ARCore Extensions Config du volet Inspector, cliquez sur le bouton cible , puis connectez-vous à l'élément ARCoreExtensionsConfig.

    5. Dans le champ Camera Config Filter du volet Inspector, cliquez sur le bouton cible , puis connectez-vous à l'élément ARCoreExtensionsCameraConfigFilter.

      Pour en savoir plus, consultez le guide du développeur Cloud Anchors et le guide de configuration de la caméra.

    6. Si vous utilisez une version d'Unity antérieure à 2020.3:

      • Sélectionnez Custom Gradle Properties Template (Modèle des propriétés Gradle personnalisées) dans Project Settings > Player > Android > Publishing Settings > Build (Paramètres du projet > Lecteur > Android > Paramètres de publication > Compiler).

Avec tous les champs d'extensions ARCore ci-dessus connectés correctement, le volet Inspector des extensions ARCore se présente comme suit:

Pour en savoir plus sur la configuration des propriétés, consultez le guide Unity sur la modification des propriétés.

Exemples de projets

Les projets fournis avec les extensions ARCore pour AR Foundation sont des exemples de projets que vous pouvez utiliser pour commencer à créer vos propres projets.

  1. Dans le menu Window, ouvrez Package Manager et sélectionnez le package ARCore Extensions.

  2. Sous Samples, cliquez sur Import pour l'exemple de projet décrit ci-dessous.

Les exemples de projets suivants sont importés à partir du dépôt GitHub:

  • Géospatial (Android uniquement) : créez des expériences de RA à l'échelle mondiale et joignez à distance du contenu à n'importe quelle zone couverte par Google Street View. Pour en savoir plus, consultez la section Présentation de l'API Geospatial.

  • PersistentCloudAnchors (Android et iOS) : créez des expériences de RA persistantes dans le monde réel avec des couches interactives d'informations numériques ancrées à des emplacements réels, et des expériences de conception pouvant être partagées au fil du temps par plusieurs personnes sur de nombreux appareils différents. Pour en savoir plus, consultez l'introduction Cloud Anchors.

Étapes suivantes

Avec ARCore Extensions pour AR Foundation, vous pouvez désormais utiliser Cloud Anchors et les configurations de caméra dans vos applications.