Konfigurowanie usługi Azure Spatial Anchors w projekcie aparatu Unity

W tym przewodniku pokazano, jak rozpocząć pracę z zestawem SDK usługi Azure Spatial Anchors w projekcie aparatu Unity.

Wymagania dotyczące projektu

Po uruchomieniu nowego projektu aparatu Unity możesz wybrać między strukturą Plug-in Platform aparatu Unity XR i starszym wbudowanym XR.

XR Plug-in Framework

Wtyczka XR Framework jest obsługiwana tylko w zestawie ASA SDK w wersji 2.9.0 lub nowszej. Aby zastosować program XR Plug-in Framework, użyj aparatu Unity 2020.3 (LTS) i programu AR Foundation 4.1.7 z następującymi pakietami w zależności od platformy:

• Wtyczka OpenXR rzeczywistości mieszanej: 1.1.2
• Wtyczka XR systemu Windows: 4.5.0
• Wtyczka ARCore XR: 4.1.7
• Wtyczka ARKit XR: 4.1.7

Starsze wbudowane XR

Starsze wbudowane środowisko XR jest obsługiwane tylko w zestawie ASA SDK w wersji 2.8.1 lub starszej. Aby zastosować starsze wbudowane środowisko XR, użyj aparatu Unity 2019.4 (LTS) i programu AR Foundation 3.1.3 z następującymi pakietami w zależności od platformy:

• Windows Mixed Reality: 4.2.1
• Wtyczka ARCore XR: 3.1.3
• Wtyczka ARKit XR: 3.1.3

Konfigurowanie projektu

Przed dołączeniem zestawu SDK usługi Azure Spatial Anchors w projekcie aparatu Unity należy zainstalować wymagane pakiety za pośrednictwem Menedżer pakietów aparatu Unity.

Wybierz wersję usługi ASA

Aby określić, która wersja zestawu ASA SDK ma być używana w projekcie aparatu Unity, wybierz wersję aparatu Unity poniżej.

Unity 2020

Dodano obsługę aparatu Unity 2020 z zestawem ASA SDK 2.9.0. Zalecamy użycie najnowszego zestawu ASA SDK na potrzeby programowania w środowisku Unity 2020.

Ważne

W przypadku korzystania z wtyczki Mixed Reality OpenXR zestaw ASA SDK 2.10.0 jest minimalną obsługiwaną wersją. W przypadku korzystania z systemu Windows XR 4.5.1 lub nowszego zestaw ASA SDK 2.11.0 jest minimalną obsługiwaną wersją.

Unity 2019

Minimalna obsługiwana wersja aparatu Unity 2019 to ZESTAW ASA SDK 2.7.0. Najnowsza wersja, która zapewnia obsługę aparatu Unity 2019, to zestaw ASA SDK 2.8.1.

Pobieranie pakietów usługi ASA

Następnym krokiem jest pobranie pakietów usługi Azure Spatial Anchors dla aparatu Unity.

Aby korzystać z usługi Azure Spatial Anchors w środowisku Unity, musisz pobrać zarówno pakiet podstawowy (com.microsoft.azure.spatial-anchors-sdk.core), jak i pakiet specyficzny dla platformy dla każdej platformy, którą planujesz obsługiwać.

Platforma	Wymagane nazwy pakietów
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>

Narzędzie funkcji rzeczywistości mieszanej

Uwaga

Narzędzie funkcji rzeczywistości mieszanej obsługuje obecnie tylko system Windows.

Przejdź do następnego kroku. W późniejszym kroku użyjesz narzędzia funkcji rzeczywistości mieszanej.

Pobieranie internetowe

Znajdź tutaj pakiet podstawowy usługi Azure Spatial Anchors (com.microsoft.azure.spatial-anchors-sdk.core) dla aparatu Unity. Wybierz odpowiednią wersję i pobierz pakiet przy użyciu przycisku Pobierz . Powtórz ten krok, aby pobrać pakiet dla każdej platformy, którą planujesz obsługiwać.

Pobieranie narzędzia NPM

W poniższych krokach przyjęto założenie, że narzędzie NPM jest zainstalowane i dostępne.

Uruchom następujące polecenie, zastępując <version_number> element wersją usługi Azure Spatial Anchors, którą chcesz pobrać do bieżącego folderu:

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/

Uwaga

Aby wyświetlić listę dostępnych wersji pakietu Azure Spatial Anchors, uruchom następujące polecenie:

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

Pakiet podstawowy usługi Azure Spatial Anchors zostanie pobrany do folderu, w którym uruchomiono polecenie . Powtórz ten krok, aby pobrać pakiet dla każdej platformy, którą planujesz obsługiwać.

Importowanie pakietów usługi ASA

Narzędzie funkcji rzeczywistości mieszanej

Ten krok wymaga pobrania i udostępnienia narzędzia funkcji rzeczywistości mieszanej.

1. Postępuj zgodnie z dokumentacją narzędzia funkcji rzeczywistości mieszanej, aby skonfigurować narzędzie i dowiedzieć się, jak z niego korzystać.
2. Zainstalować
   1. Azure Spatial Anchors SDK Core
   2. Zestaw SDK usługi Azure Spatial Anchors dla <platform>
   3. Wtyczka OpenXR rzeczywistości mieszanej w przypadku korzystania z biblioteki OpenXR — znajduje się w obszarze Obsługa platformy

Pobieranie internetowe

Postępuj zgodnie z instrukcjami w tym miejscu, aby zaimportować pakiety usługi Azure Spatial Anchors pobrane do projektu aparatu Unity przy użyciu Menedżer pakietów aparatu Unity.

Pobieranie narzędzia NPM

Postępuj zgodnie z instrukcjami w tym miejscu, aby zaimportować pakiety usługi Azure Spatial Anchors pobrane do projektu aparatu Unity przy użyciu Menedżer pakietów aparatu Unity.

Dodatkowe konfiguracje

Jeśli programujesz dla urządzeń HoloLens lub Android, wykonaj poniższe dodatkowe kroki konfiguracji

HoloLens

Konfigurowanie ustawień XR projektu aparatu Unity

Podczas tworzenia aplikacji MixedReality na urządzeniu HoloLens należy ustawić konfigurację XR w środowisku Unity. Aby uzyskać więcej informacji, zobacz Konfigurowanie konfiguracji XR — rzeczywistość mieszana | Microsoft Docs i Wybieranie wersji aparatu Unity i wtyczki XR — rzeczywistość mieszana | Microsoft Docs.

Zestaw AZURE Spatial Anchors SDK w wersji 2.9.0 lub starszej zapewnia obsługę wtyczki XR systemu Windows (com.unity.xr.windowsmr), dlatego pakiet windows Azure Spatial Anchors ma jawną zależność od wtyczki XR systemu Windows.

Zestaw SDK usługi Azure Spatial Anchors w wersji 2.10.0 lub nowszej zapewnia obsługę wtyczki Mixed Reality OpenXR (com.microsoft.mixedreality.openxr) i wtyczki com.unity.xr.windowsmrXR systemu Windows. Musisz uwzględnić com.microsoft.mixedreality.openxr pakiet lub com.unity.xr.windowsmr pakiet w projekcie w zależności od wybranej opcji.

Konfigurowanie możliwości projektu aparatu Unity

Pamiętaj, aby włączyć następujące możliwości w projekcie aparatu Unity:

• SpatialPerception
• InternetClient
• PrivateNetworkClientServer

Ostrzeżenie

Niepowodzenie włączenia funkcji PrivateNetworkClientServer może prowadzić do niepowodzenia wykonywania zapytań dotyczących kotwic, gdy urządzenie korzysta z sieci skonfigurowanej jako prywatna.

Android

Konfigurowanie pliku mainTemplate.gradle

1. Przejdź do pozycji Edytuj>projekt Ustawienia> Player.

2. W panelu inspektora dla odtwarzacza Ustawienia wybierz ikonę Android.

3. W sekcji Build (Kompilacja) zaznacz pole wyboru Custom Main Gradle Template (Szablon niestandardowego narzędzia Gradle), aby wygenerować niestandardowy szablon narzędzia gradle pod adresem Assets\Plugins\Android\mainTemplate.gradle.

4. mainTemplate.gradle Otwórz plik w edytorze tekstów.

5. dependencies W sekcji wklej następujące zależności:

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

Gdy wszystko będzie gotowe, dependencies sekcja powinna wyglądać mniej więcej tak:

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

Następne kroki

Instrukcje: tworzenie i lokalizowanie kotwic w środowisku Unity