Azure Spatial Anchors configureren in een Unity-project

In deze handleiding ziet u hoe u aan de slag kunt met de Azure Spatial Anchors SDK in uw Unity-project.

Projectvereisten

Wanneer u een nieuw Unity-project start, kunt u kiezen tussen het Unity XR Plug-in Framework en legacy ingebouwde XR.

XR-invoegtoepassingsframework

Het XR-invoegtoepassingsframework wordt alleen ondersteund op ASA SDK-versie 2.9.0 of hoger. Als u het XR Plug-in Framework wilt gebruiken, gebruikt u Unity 2020.3 (LTS) en AR Foundation 4.1.7 met de volgende pakketten, afhankelijk van uw platform:

• Mixed Reality OpenXR-invoegtoepassing: 1.1.2
• Windows XR-invoegtoepassing: 4.5.0
• ARCore XR-invoegtoepassing: 4.1.7
• ARKit XR-invoegtoepassing: 4.1.7

Verouderde ingebouwde XR

Verouderde ingebouwde XR wordt alleen ondersteund op ASA SDK-versie 2.8.1 of eerder. Gebruik Unity 2019.4 (LTS) en AR Foundation 3.1.3 met de volgende pakketten om een verouderde ingebouwde XR te gebruiken, afhankelijk van uw platform:

• Windows Mixed Reality: 4.2.1
• ARCore XR-invoegtoepassing: 3.1.3
• ARKit XR-invoegtoepassing: 3.1.3

Een project configureren

Voordat u de Azure Spatial Anchors SDK in uw Unity-project oppakt, moet u de vereiste pakketten installeren via de Unity-Pakketbeheer.

ASA-versie kiezen

Als u wilt bepalen welke ASA SDK-versie moet worden gebruikt in uw Unity-project, selecteert u hieronder uw versie van Unity.

Unity 2020

Ondersteuning voor Unity 2020 is toegevoegd met ASA SDK 2.9.0. We raden u aan de nieuwste ASA SDK te gebruiken voor Unity 2020-ontwikkeling.

Belangrijk

Als u de Mixed Reality OpenXR-invoegtoepassing gebruikt, is ASA SDK 2.10.0 de minimaal ondersteunde versie. Als u Windows XR 4.5.1 of hoger gebruikt, is ASA SDK 2.11.0 de minimaal ondersteunde versie.

Unity 2019

De minimaal ondersteunde versie in Unity 2019 is ASA SDK 2.7.0. De nieuwste versie die ondersteuning biedt voor Unity 2019 is ASA SDK 2.8.1.

ASA-pakketten downloaden

De volgende stap is het downloaden van de Azure Spatial Anchors-pakketten voor Unity.

Als u Azure Spatial Anchors in Unity wilt gebruiken, moet u zowel het kernpakket (com.microsoft.azure.spatial-anchors-sdk.core) als een platformspecifiek pakket downloaden voor elk platform dat u wilt ondersteunen.

Platform	Vereiste pakketnamen
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>

Hulpprogramma voor mixed reality-functies

Notitie

Het Hulpprogramma voor mixed reality-functies ondersteunt momenteel alleen Windows.

Ga door naar de volgende stap. In een latere stap gebruikt u het hulpprogramma Voor mixed reality-functies.

Webdownload

Zoek hier het Azure Spatial Anchors-kernpakket (com.microsoft.azure.spatial-anchors-sdk.core) voor Unity. Selecteer de gewenste versie en download het pakket met behulp van de knop Downloaden . Herhaal deze stap om het pakket te downloaden voor elk platform dat u wilt ondersteunen.

NPM downloaden

In de volgende stappen wordt ervan uitgegaan dat NPM is geïnstalleerd en beschikbaar is.

Voer de volgende opdracht uit en vervang deze <version_number> door de versie van Azure Spatial Anchors die u wilt downloaden naar de huidige map:

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/

Notitie

Voer het volgende uit om de beschikbare versies van het Azure Spatial Anchors-pakket weer te geven:

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

Het Azure Spatial Anchors-kernpakket wordt gedownload naar de map waarin u de opdracht hebt uitgevoerd. Herhaal deze stap om het pakket te downloaden voor elk platform dat u wilt ondersteunen.

ASA-pakketten importeren

Hulpprogramma voor mixed reality-functies

Voor deze stap is vereist dat het Hulpprogramma voor mixed reality-functies wordt gedownload en beschikbaar is.

1. Volg de documentatie van het Hulpprogramma voor mixed reality-functies om het hulpprogramma in te stellen en te leren hoe u het kunt gebruiken.
2. Installeren
   1. Azure Spatial Anchors SDK Core
   2. Azure Spatial Anchors SDK voor <uw platform(en)>
   3. Mixed Reality OpenXR-invoegtoepassing als u OpenXR gebruikt , zich onder Platformondersteuning bevindt

Webdownload

Volg de instructies hier voor het importeren van de Azure Spatial Anchors-pakketten die u hebt gedownload in het Unity-project met behulp van de Unity-Pakketbeheer.

NPM downloaden

Volg de instructies hier voor het importeren van de Azure Spatial Anchors-pakketten die u hebt gedownload in het Unity-project met behulp van de Unity-Pakketbeheer.

Extra configuraties

Als u ontwikkelt voor HoloLens of Android, volgt u de aanvullende installatiestappen hieronder

HoloLens

XR-instellingen voor uw Unity-project configureren

Bij het ontwikkelen van MixedReality-apps op HoloLens moet u de XR-configuratie instellen in Unity. Zie Uw XR-configuratie instellen - Mixed Reality | Microsoft Docs en een Unity-versie en XR-invoegtoepassing kiezen - Mixed Reality | Microsoft Docs.

Azure Spatial Anchors SDK-versies 2.9.0 of eerder bieden alleen ondersteuning voor de Windows XR-invoegtoepassing (com.unity.xr.windowsmr), dus het Windows-pakket Azure Spatial Anchors heeft een expliciete afhankelijkheid van de Windows XR-invoegtoepassing.

Azure Spatial Anchors SDK-versies 2.10.0 of hoger bieden ondersteuning voor zowel de Mixed Reality OpenXR-invoegtoepassing (com.microsoft.mixedreality.openxr) als de Windows XR-invoegtoepassing com.unity.xr.windowsmr. U moet het com.microsoft.mixedreality.openxr pakket of het com.unity.xr.windowsmr pakket in uw project opnemen, afhankelijk van uw keuze.

De mogelijkheden van uw Unity-project configureren

Zorg ervoor dat u de volgende mogelijkheden inschakelt in uw Unity-project:

• SpatialPerception
• InternetClient
• PrivateNetworkClientServer

Waarschuwing

Als u de mogelijkheid PrivateNetworkClientServer niet inschakelt, kan dit leiden tot een fout bij het opvragen van ankers wanneer het apparaat een netwerk gebruikt dat is geconfigureerd als privé.

Android

Het bestand mainTemplate.gradle configureren

1. Ga naar Edit>Project Settings>Player.

2. Selecteer in het Inspector Panel voor Player Instellingen het Android-pictogram.

3. Schakel onder de sectie Opbouwen het selectievakje Aangepaste hoofd-gradlesjabloon in om een aangepaste gradle-sjabloon te genereren op Assets\Plugins\Android\mainTemplate.gradle.

4. Open het mainTemplate.gradle bestand in een teksteditor.

5. Plak in de dependencies sectie de volgende afhankelijkheden:

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

Wanneer alles klaar is, ziet uw dependencies sectie er ongeveer als volgt uit:

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

Volgende stappen

Procedure: Ankers maken en vinden in Unity