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.
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:
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.
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.
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> |
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.
ASA-pakketten importeren
Voor deze stap is vereist dat het Hulpprogramma voor mixed reality-functies wordt gedownload en beschikbaar is.
- Volg de documentatie van het Hulpprogramma voor mixed reality-functies om het hulpprogramma in te stellen en te leren hoe u het kunt gebruiken.
- Installeren
- Azure Spatial Anchors SDK Core
- Azure Spatial Anchors SDK voor <uw platform(en)>
- Mixed Reality OpenXR-invoegtoepassing als u OpenXR gebruikt , zich onder Platformondersteuning bevindt
Extra configuraties
Als u ontwikkelt voor HoloLens of Android, volgt u de aanvullende installatiestappen hieronder
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é.