Az Azure Spatial Anchors konfigurálása Unity-projektben

Cikk
10/26/2023

Ez az útmutató bemutatja, hogyan kezdheti el az Azure Spatial Anchors SDK-t a Unity-projektben.

Projektkövetelmények

Új Unity-projekt indításakor választhat a Unity XR beépülő modul keretrendszere és az örökölt beépített XR között.

XR beépülő modul keretrendszere
Örökölt beépített XR

Az XR beépülő modul keretrendszere csak az ASA SDK 2.9.0-s vagy újabb verziójában támogatott. Az XR beépülő modul keretrendszerének megcélzásához használja a Unity 2020.3 -at (LTS) és az AR Foundation 4.1.7-et a következő csomagokkal, a platformtól függően:

Mixed Reality OpenXR beépülő modul: 1.1.2
Windows XR beépülő modul: 4.5.0
ARCore XR beépülő modul: 4.1.7
ARKit XR beépülő modul: 4.1.7

Projekt konfigurálása

Mielőtt belevennénk az Azure Spatial Anchors SDK-t a Unity-projektbe, mindenképpen telepítse a szükséges csomagokat a Unity Csomagkezelő keresztül.

Az ASA-verzió kiválasztása

Annak megállapításához, hogy melyik ASA SDK-verziót szeretné használni a Unity-projektben, válassza ki alább a Unity verzióját.

Unity 2020
Unity 2019

A Unity 2020 támogatása az ASA SDK 2.9.0-val bővült. Javasoljuk a Unity 2020 legújabb ASA SDK-jának használatát.

Fontos

A Mixed Reality OpenXR beépülő modul használata esetén az ASA SDK 2.10.0 a minimálisan támogatott verzió. Ha Windows XR 4.5.1 vagy újabb verziót használ, az ASA SDK 2.11.0 a minimálisan támogatott verzió.

ASA-csomagok letöltése

A következő lépés az Azure Spatial Anchors-csomagok letöltése a Unityhez.

Az Azure Spatial Anchors a Unityben való használatához le kell töltenie az alapcsomagot (com.microsoft.azure.spatial-anchors-sdk.core) és egy platformspecifikus csomagot minden olyan platformhoz, amelyet támogatni szeretne.

Platform	Szükséges csomagnevek
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>`

Megjegyzés:

A Vegyes valóság funkció eszköz jelenleg csak a Windowst támogatja.

Folytassa a következő lépésben. Egy későbbi lépésben a Vegyes valóság funkcióeszközt fogja használni.

Az alábbi lépések feltételezik, hogy az NPM telepítve van és elérhető.

Futtassa a következő parancsot az aktuális mappába letölteni kívánt Azure Spatial Anchors-verzióra cserélve <version_number> :

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/

Megjegyzés:

Az Azure Spatial Anchors csomag elérhető verzióinak listázásához futtassa a következőket:

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

Az Azure Spatial Anchors alapcsomagja arra a mappára lesz letöltve, ahol a parancsot futtatta. Ismételje meg ezt a lépést a csomag letöltéséhez minden olyan platformhoz, amelyet támogatni szeretne.

ASA-csomagok importálása

Ehhez a lépéshez le kell töltenie és el kellérhetővé kell bocsátania a Mixed Reality szolgáltatáseszközt .

Az eszköz beállításához és használatának megismeréséhez kövesse a Mixed Reality szolgáltatáseszköz dokumentációját.
Telepíteni
1. Azure Spatial Anchors SDK Core
2. Azure Spatial Anchors SDK a platform(ok)hoz <>
3. Mixed Reality OpenXR beépülő modul OpenXR használata esetén – a platformtámogatás alatt található

További konfigurációk

Ha HoloLens vagy Android rendszerre fejleszt, kövesse az alábbi további telepítési lépéseket

HoloLens
Android

A Unity-projekt XR-beállításainak konfigurálása

Amikor MixedReality-alkalmazásokat fejleszt a HoloLensen, be kell állítania az XR-konfigurációt a Unityben. További információ: XR-konfiguráció beállítása – Vegyes valóság | Microsoft Docs és a Unity verzió és az XR beépülő modul kiválasztása – Mixed Reality | Microsoft Docs.

Az Azure Spatial Anchors SDK 2.9.0-s vagy korábbi verziói csak a Windows XR beépülő modul (com.unity.xr.windowsmr) támogatását biztosítják, így az Azure Spatial Anchors Windows-csomag explicit függőséget élvez a Windows XR beépülő modultól.

Az Azure Spatial Anchors SDK 2.10.0-s vagy újabb verziói egyaránt támogatják a Mixed Reality OpenXR beépülő modult (com.microsoft.mixedreality.openxr) és a Windows XR beépülő modult com.unity.xr.windowsmr. A csomagnak vagy a com.microsoft.mixedreality.openxrcom.unity.xr.windowsmr csomagnak is szerepelnie kell a projektben, attól függően, hogy melyiket választja.

A Unity-projekt képességeinek konfigurálása

A Unity-projektben mindenképpen engedélyezze a következő képességeket:

SpatialPerception
InternetClient
PrivateNetworkClientServer

Figyelmeztetés:

A PrivateNetworkClientServer funkció engedélyezésének elmulasztása a horgonyok lekérdezésének sikertelenségéhez vezethet, ha az eszköz privátnak konfigurált hálózatot használ.

A mainTemplate.gradle fájl konfigurálása

Nyissa meg a Project Gépház> Player szerkesztése>elemet.
A Player Gépház Felügyelő paneljénválassza az Android ikont.
A Build szakaszban jelölje be az Egyéni fő Gradle-sablon jelölőnégyzetet, és hozzon létre egy egyéni gradle-sablont a következő helyenAssets\Plugins\Android\mainTemplate.gradle: .
Nyissa meg a mainTemplate.gradle fájlt egy szövegszerkesztőben.

dependencies A szakaszban illessze be a következő függőségeket:

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

Ha minden elkészült, a dependencies szakasznak a következőképpen kell kinéznie:

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**}

Következő lépések

Útmutató: Horgonyok létrehozása és megkeresése a Unityben