Sdílet prostřednictvím

Konfigurace Azure Spatial Anchors v projektu Unity

  • Článek

Tato příručka vám ukáže, jak začít se sadou Azure Spatial Anchors SDK v projektu Unity.

Požadavky projektu

Když spustíte nový projekt Unity, můžete si vybrat mezi architekturou plug-in Unity XR a starší integrovanou architekturou XR.

Modul plug-in XR je podporován pouze v sadě ASA SDK verze 2.9.0 nebo novější. Pokud chcete cílit na architekturu plug-in XR, použijte Unity 2020.3 (LTS) a AR Foundation 4.1.7 s následujícími balíčky v závislosti na vaší platformě:

  • Modul plug-in Mixed Reality OpenXR: 1.1.2
  • Modul plug-in Windows XR: 4.5.0
  • Modul plug-in ARCore XR: 4.1.7
  • Modul plug-in ARKit XR: 4.1.7

Konfigurace projektu

Před zahrnutím sady Azure Spatial Anchors SDK do projektu Unity nezapomeňte nainstalovat požadované balíčky prostřednictvím Správce balíčků Unity.

Volba verze ASA

Pokud chcete určit verzi sady ASA SDK, kterou chcete použít v projektu Unity, vyberte níže svou verzi Unity.

Podpora unity 2020 byla přidána se sadou ASA SDK 2.9.0. Doporučujeme použít nejnovější sadu ASA SDK pro vývoj pro Unity 2020.

Důležité

Pokud používáte modul plug-in Mixed Reality OpenXR, je minimální podporovaná verze sady ASA SDK 2.10.0. Pokud používáte Windows XR 4.5.1 nebo novější, je minimální podporovaná verze sady ASA SDK 2.11.0.

Stažení balíčků ASA

Dalším krokem je stažení balíčků Azure Spatial Anchors pro Unity.

Pokud chcete používat Azure Spatial Anchors v Unity, musíte stáhnout základní balíček (com.microsoft.azure.spatial-anchors-sdk.core) i balíček specifický pro platformu pro každou platformu, kterou plánujete podporovat.

Platforma Požadované názvy balíčků
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>

Poznámka:

Nástroj pro funkce hybridní reality v současné době podporuje pouze Windows.

Pokračujte dalším krokem. V pozdějším kroku použijete nástroj pro funkci hybridní reality.

Import balíčků ASA

Tento krok vyžaduje, aby byl nástroj pro funkci hybridní reality stažený a dostupný.

  1. Postupujte podle dokumentace k nástroji pro funkce hybridní reality a naučte se, jak ho používat.
  2. Nainstalovat
    1. Azure Spatial Anchors SDK Core
    2. Sada Azure Spatial Anchors SDK pro <vaše platformy>
    3. Modul plug-in Mixed Reality OpenXR, pokud používáte OpenXR – nachází se v části Podpora platformy

Další konfigurace

Pokud vyvíjíte pro HoloLens nebo Android, postupujte podle dalších kroků nastavení níže.

Konfigurace nastavení XR projektu Unity

Při vývoji aplikací MixedReality v HoloLens je potřeba nastavit konfiguraci XR v Unity. Další informace najdete v tématu Nastavení konfigurace XR – Hybridní realita | Microsoft Docs a volba verze Unity a modulu plug-in XR – Mixed Reality | Microsoft Docs.

Sada Azure Spatial Anchors SDK verze 2.9.0 nebo starší poskytuje podporu pouze pro modul plug-in Windows XR (com.unity.xr.windowsmr), takže balíček Azure Spatial Anchors pro Windows má explicitní závislost na modulu plug-in Windows XR.

Sada Azure Spatial Anchors SDK verze 2.10.0 nebo novější poskytuje podporu modulu plug-in Mixed Reality OpenXR (com.microsoft.mixedreality.openxr) i modulu plug-in com.unity.xr.windowsmrWindows XR . V závislosti na vaší volbě musíte do projektu zahrnout balíček com.microsoft.mixedreality.openxr nebo com.unity.xr.windowsmr balíček.

Konfigurace možností projektu Unity

Nezapomeňte v projektu Unity povolit následující možnosti:

  • SpatialPerception
  • InternetClient
  • PrivateNetworkClientServer

Upozorňující

Pokud se nepovolí funkce PrivateNetworkClientServer, může dojít k selhání dotazování ukotvení, když zařízení používá síť, která je nakonfigurovaná tak, aby byla soukromá.