Konfigurera Azure Spatial Anchors i ett Unity-projekt

Artikel
10/26/2023

Den här guiden visar hur du kommer igång med Azure Spatial Anchors SDK i ditt Unity-projekt.

Projektkrav

När du startar ett nytt Unity-projekt kan du välja mellan Unity XR Plug-in Framework och Äldre inbyggd XR.

XR Plug-in Framework
Äldre inbyggd XR

XR Plug-in Framework stöds endast på ASA SDK version 2.9.0 eller senare. Använd Unity 2020.3 (LTS) och AR Foundation 4.1.7 för att rikta in dig på XR-plugin-ramverket med följande paket, beroende på din plattform:

Plugin-programmet Mixed Reality OpenXR: 1.1.2
Windows XR-plugin-program: 4.5.0
XR-plugin-program för ARCore: 4.1.7
ARKit XR Plugin: 4.1.7

Konfigurera ett projekt

Innan du inkluderar Azure Spatial Anchors SDK i ditt Unity-projekt måste du installera de paket som krävs via Unity Package Manager.

Välj ASA-version

Om du vill ta reda på vilken ASA SDK-version som ska användas i ditt Unity-projekt väljer du din version av Unity nedan.

Unity 2020
Unity 2019

Stöd för Unity 2020 har lagts till med ASA SDK 2.9.0. Vi föreslår att du använder den senaste ASA SDK:t för Unity 2020-utveckling.

Viktigt!

Om du använder Plugin-programmet Mixed Reality OpenXR är ASA SDK 2.10.0 den lägsta versionen som stöds. Om du använder Windows XR 4.5.1 eller senare är ASA SDK 2.11.0 den lägsta version som stöds.

Ladda ned ASA-paket

Nästa steg är att ladda ned Azure Spatial Anchors-paketen för Unity.

Om du vill använda Azure Spatial Anchors i Unity måste du ladda ned både kärnpaketet (com.microsoft.azure.spatial-anchors-sdk.core) och ett plattformsspecifikt paket för varje plattform som du planerar att stödja.

Plattform	Nödvändiga paketnamn
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>`

Kommentar

Funktionsverktyget för Mixad verklighet stöder för närvarande endast Windows.

Fortsätt till nästa steg. Du använder funktionsverktyget för Mixed Reality i ett senare steg.

Följande steg förutsätter att NPM är installerat och tillgängligt.

Kör följande kommando och <version_number> ersätt med den version av Azure Spatial Anchors som du vill ladda ned till den aktuella mappen:

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/

Kommentar

Om du vill visa en lista över tillgängliga versioner av Azure Spatial Anchors-paketet kör du följande:

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

Azure Spatial Anchors-kärnpaketet laddas ned till mappen där du körde kommandot. Upprepa det här steget för att ladda ned paketet för varje plattform som du planerar att stödja.

Importera ASA-paket

Det här steget kräver att funktionsverktyget för Mixed Reality laddas ned och är tillgängligt.

Följ dokumentationen för Funktionsverktyg för Mixad verklighet för att konfigurera verktyget och lära dig hur du använder det.
Installera
1. Azure Spatial Anchors SDK Core
2. Azure Spatial Anchors SDK för <dina plattformar>
3. Plugin-programmet Mixed Reality OpenXR om du använder OpenXR – som finns under Plattformssupport

Extra konfigurationer

Om du utvecklar för HoloLens eller Android följer du de ytterligare installationsstegen nedan

HoloLens
Android

Konfigurera XR-inställningarna för Unity-projektet

När du utvecklar MixedReality-appar på HoloLens måste du ange XR-konfigurationen i Unity. Mer information finns i Konfigurera din XR-konfiguration – Mixed Reality | Microsoft Docs och Välja en Unity-version och XR-plugin - Mixed Reality | Microsoft Docs.

Azure Spatial Anchors SDK version 2.9.0 eller tidigare ger endast stöd för Windows XR-plugin-programmet (com.unity.xr.windowsmr), så Windows-paketet Azure Spatial Anchors har ett uttryckligt beroende av Windows XR-plugin-programmet.

Azure Spatial Anchors SDK version 2.10.0 eller senare ger stöd för både Plugin-programmet Mixed Reality OpenXR (com.microsoft.mixedreality.openxr) och Windows XR-plugin-programmet com.unity.xr.windowsmr. Du måste inkludera antingen com.microsoft.mixedreality.openxr paketet eller com.unity.xr.windowsmr paketet i projektet beroende på ditt val.

Konfigurera dina Unity-projektfunktioner

Se till att aktivera följande funktioner i Ditt Unity-projekt:

SpatialPerception
InternetClient
PrivateNetworkClientServer

Varning

Om det inte går att aktivera funktionen PrivateNetworkClientServer kan det leda till att det inte går att köra frågor mot fästpunkter när enheten använder ett nätverk som är konfigurerat att vara privat.

Konfigurera filen mainTemplate.gradle

Gå till Redigera>Project Inställningar> Player.
I kontrollpanelen för player Inställningar väljer du Android-ikonen.
I avsnittet Skapa markerar du kryssrutan Anpassad huvudgradlemall för att generera en anpassad gradle-mall på Assets\Plugins\Android\mainTemplate.gradle.
mainTemplate.gradle Öppna filen i en textredigerare.

I avsnittet dependencies klistrar du in följande beroenden:

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

När allt är klart bör ditt dependencies avsnitt se ut ungefär så här:

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

Nästa steg

Anvisningar: Skapa och hitta fästpunkter i Unity