Configurer des Spatial Anchors Azure dans un projet Unity

Ce guide vous montre comment prendre en main le kit SDK Azure Spatial Anchors dans votre projet Unity.

Configuration requise du projet

Lorsque vous démarrez un nouveau projet Unity, vous pouvez choisir entre l'infrastructure de plug-in Unity XR et la XR intégrée existante.

Infrastructure de plug-in XR

L’infrastructure de plug-in XR est uniquement prise en charge dans le kit de développement logiciel (SDK) ASA version 2.9.0 ou ultérieure. Pour cibler l’infrastructure de plug-in XR, utilisez Unity 2020.3 (LTS)et AR Foundation 4.1.7 avec les packages suivants, en fonction de votre plateforme :

• Plug-in OpenXR de la réalité mixte : 1.1.2
• Plug-in XR Windows : 4.5.0
• Plug-in XR ARCore : 4.1.7
• Plug-in XR ARKit : 4.1.7

XR intégré hérité

Le XR intégré hérité est pris en charge uniquement sur le SDK ASA version 2.8.1 ou antérieure. Pour cibler le XR intégré hérité, utilisez Unity 2019.4 (LTS)et AR Foundation 3.1.3 avec les packages suivants, en fonction de votre plateforme :

• Windows Mixed Reality : 4.2.1
• Plug-in XR ARCore : 3.1.3
• Plug-in XR ARKit : 3.1.3

Configuration d’un projet

Avant d’inclure le Kit de développement logiciel (SDK) Azure Spatial Anchors dans votre projet Unity, veillez à installer les packages requis via le gestionnaire de package d’Unity.

Choisir la version ASA

Pour déterminer la version du Kit de développement logiciel (SDK) ASA à utiliser dans votre projet Unity, sélectionnez votre version Unity ci-dessous.

Unity 2020

La prise en charge d’Unity 2020 a été ajoutée avec le SDK ASA 2.9.0. Nous vous suggérons d’utiliser le dernier SDK ASA pour le développement Unity 2020.

Important

Si vous utilisez le plug-in Mixed Reality OpenXR, le SDK ASA 2.10.0 est la version minimale prise en charge. Si vous utilisez Windows XR 4.5.1 ou version ultérieure, le SDK ASA 2.11.0 est la version minimale prise en charge.

Unity 2019

La version minimale prise en charge dans Unity 2019 est le SDK ASA 2.7.0. La dernière version qui assure la prise en charge d’Unity 2019 est le SDK ASA 2.8.1.

Télécharger les packages Azure Spatial Anchors

L’étape suivante consiste à télécharger les packages Azure Spatial Anchors pour Unity.

Pour utiliser Azure Spatial Anchors dans Unity, vous devez télécharger à la fois le package principal (com.microsoft.azure.spatial-anchors-sdk.core) et un package spécifique à la plateforme pour chaque plateforme que vous envisagez de prendre en charge.

Plate-forme	Noms des packages requis
HoloLens	com.microsoft.azure.spatial-anchors-sdk.core@<version_number> com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>
Android	com.microsoft.azure.spatial-anchors-sdk.core@<version_number> com.microsoft.azure.spatial-anchors-sdk.android@<version_number>
iOS	com.microsoft.azure.spatial-anchors-sdk.core@<version_number> com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>

Mixed Reality Feature Tool

Remarque

Mixed Reality Feature Tool ne prend actuellement en charge que Windows.

Passez à l’étape suivante. Vous utiliserez Mixed Reality Feature Tool dans une étape ultérieure.

Téléchargement web

Localisez le package Azure Spatial Anchors principal (com.microsoft.azure.spatial-anchors-sdk.core) pour Unity ici. Sélectionnez la version souhaitée et téléchargez le package à l’aide du bouton Télécharger. Répétez cette étape afin de télécharger le package pour chaque plateforme que vous envisagez de prendre en charge.

Téléchargement via NPM

Les étapes suivantes supposent que NPM est installé et disponible.

Exécutez la commande suivante en remplaçant <version_number> par la version d’Azure Spatial Anchors que vous souhaitez télécharger dans le dossier actuel :

npm pack com.microsoft.azure.spatial-anchors-sdk.core@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

Remarque

Pour lister les versions disponibles du package Azure Spatial Anchors, exécutez la commande suivante :

npm view com.microsoft.azure.spatial-anchors-sdk.core --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

Le package Azure Spatial Anchors principal est téléchargé dans le dossier où vous avez exécuté la commande. Répétez cette étape afin de télécharger le package pour chaque plateforme que vous envisagez de prendre en charge.

Importer des packages Azure Spatial Anchors

Mixed Reality Feature Tool

Cette étape nécessite que Mixed Reality Feature Tool soit téléchargé et disponible.

1. Suivez la documentation de Mixed Reality Feature Tool pour configurer l’outil et découvrir comment l’utiliser.
2. Installer
   1. SDK Azure Spatial Anchors Core
   2. SDK Azure Spatial Anchors pour <votre ou vos plateformes>
   3. Plug-in Mixed Reality OpenXR si vous utilisez OpenXR, qui se trouve sous Support de plateforme

Téléchargement web

Suivez les instructions ici pour importer les packages Azure Spatial Anchors que vous avez téléchargés dans le projet Unity à l’aide de Unity Package Manager.

Téléchargement via NPM

Suivez les instructions ici pour importer les packages Azure Spatial Anchors que vous avez téléchargés dans le projet Unity à l’aide de Unity Package Manager.

Configurations supplémentaires

Si vous développez pour HoloLens ou Android, effectuez les étapes de configuration supplémentaires ci-dessous.

HoloLens

Configurer les paramètres XR de votre projet Unity

Lorsque vous développez des applications MixedReality sur HoloLens, vous devez définir la configuration XR dans Unity. Pour plus d’informations, consultez Définition de votre configuration XR - Mixed Reality | Microsoft Docs et Choix de la version d’Unity et du plug-in XR - Mixed Reality | Microsoft Docs.

La version 2.9.0 du SDK Azure Spatial Anchors et les versions antérieures prennent uniquement en charge le plug-in Windows XR (com.unity.xr.windowsmr). Par conséquent, le package Windows Azure Spatial Anchors a une dépendance explicite sur le plug-in Windows XR.

Les versions 2.10.0 ou ultérieures du SDK Azure Spatial Anchors prennent en charge à la fois le plug-in Mixed Reality OpenXR (com.microsoft.mixedreality.openxr) et le plug-in Windows XR com.unity.xr.windowsmr. Vous devez inclure le package com.microsoft.mixedreality.openxr ou le package com.unity.xr.windowsmr dans votre projet en fonction de votre choix.

Configurer les fonctionnalités de votre projet Unity

Veillez à activer les fonctionnalités suivantes dans votre projet Unity :

• SpatialPerception
• InternetClient
• PrivateNetworkClientServer

Avertissement

L’échec de l’activation de la fonctionnalité PrivateNetworkClientServer peut entraîner l’échec de l’interrogation des ancres lorsque l’appareil utilise un réseau configuré pour être privé.

Android

Configurer le fichier mainTemplate.gradle

1. Accédez à Edit>Project Settings>Player.

2. Dans le panneau Inspector (Inspecteur) pour Player Settings (Paramètres du lecteur), sélectionnez l’icône Android.

3. Sous la section Build, cochez la case Custom Main Gradle Template (Principal modèle Gradle personnalisé) pour générer un modèle Gradle personnalisé sur Assets\Plugins\Android\mainTemplate.gradle.

4. Ouvrez votre fichier mainTemplate.gradle dans un éditeur de texte.

5. Dans la section dependencies, collez les dépendances suivantes :

   implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
   implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
   

Quand vous avez terminé, votre section dependencies doit ressembler à ce qui suit :

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
    implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
**DEPS**}

Étapes suivantes

Guide pratique pour créer et localiser des ancres dans Unity