Partager via


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.

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

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.

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.

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>

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.

Importer des packages Azure Spatial Anchors

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

Configurations supplémentaires

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

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é.