Migrowanie projektu aparatu Unity 2019 do aparatu Unity 2020 + OpenXR

W przypadku najładniejszej migracji zalecamy wykonanie wszystkich kroków opisanych w tym artykule w przedstawionej kolejności. Poniżej przedstawiono omówienie głównych kroków:

1. Zaktualizuj zestaw NARZĘDZI MRTK do najnowszej stabilnej wersji.
2. Przenieś projekt do rozwiązania Unity 2019 XR Plug-in Management.
3. Wybierz pozycję "Windows Mixed Reality".
4. Uaktualnij do wersji Unity 2020.3 LTS.
5. Użyj narzędzia funkcji rzeczywistości mieszanej, aby zainstalować więcej pakietów.
6. Konfigurowanie zarządzania wtyczkami XR dla biblioteki OpenXR.

1. Zaktualizuj zestaw narzędzi MRTK do najnowszej stabilnej wersji

Jeśli już używasz zestawu narzędzi MRTK, sugerujemy, że pierwszym krokiem migracji powinno być uruchomienie narzędzia funkcji rzeczywistości mieszanej i zaktualizowanie do najnowszej stabilnej wersji zestawu narzędzi MRTK.

Wybierz żądane funkcje

Uwaga

Opisy i obrazy w tej sekcji są oparte na najnowszej wersji narzędzia. Jeśli instrukcje nie są zgodne z wyświetlanymi elementami, sprawdź, czy nie używasz starszej wersji narzędzia.

1. Otwórz narzędzie Microsoft Mixed Reality Feature Tool, a następnie kliknij przycisk Start .

   

2. Wybierz przycisk Przeglądaj (jest to przycisk "trzy kropki" na poniższej ilustracji), a następnie przejdź do projektu, a następnie otwórz go.

   

3. Wybierz pozycję Odnajdź funkcje.

   Uwaga: może być konieczne odczekenie kilku sekund, gdy narzędzie odświeża pakiety z kanałów informacyjnych.

4. Na stronie Odnajdywanie funkcji zwróć uwagę, że istnieje lista sześciu grup pakietów.

   

5. Kliknij przycisk "+" po lewej stronie zestawu narzędzi Mixed Reality Toolkit , a następnie wybierz najnowszą wersję zestawu narzędzi Mixed Reality Toolkit Foundation.

Importowanie funkcji

1. Po wybraniu opcji kliknij pozycję Pobierz funkcje.
2. Na stronie Importowanie funkcji w lewej kolumnie Funkcje zostaną wyświetlone właśnie wybrane pakiety. Kolumna po prawej stronie, Wymagane zależności, wyświetla wszystkie zależności. Możesz kliknąć link Szczegóły dla dowolnego z tych elementów, aby dowiedzieć się więcej o nich.
3. Gdy wszystko będzie gotowe do przejścia, wybierz pozycję Importuj. Na stronie Przeglądanie i zatwierdzanie możesz przejrzeć informacje o pakietach.
4. Wybierz pozycję Zatwierdź. W narzędziu funkcji zostanie wyświetlony komunikat informujący, że projekt został zaktualizowany.
5. Wróć do Edytora aparatu Unity i kliknij pusty obszar w interfejsie użytkownika. Zostanie wyświetlony komunikat informujący o tym, że pakiety są importowane.

Wykonując to uaktualnienie podczas korzystania z aparatu Unity 2019, można wyświetlić konfigurator projektu ZESTAWU NARZĘDZI MRTK i wyświetlić wszystkie ostrzeżenia "przestarzały interfejs API" dotyczące sposobu pobierania bieżącego. Ostrzeżenia informują o tym, co należy zmienić. Jeśli nie wykonasz tego uaktualnienia zestawu NARZĘDZI MRTK, stary interfejs API może zniknąć i nie będziesz mieć tych ostrzeżeń.

Dowiedz się więcej o narzędziu funkcji rzeczywistości mieszanej.

2. Przenieś projekt do rozwiązania Unity 2019 XR Plug-in Management

Po zaktualizowaniu zestawu NARZĘDZI MRTK możesz poinstruować aparat Unity 2019 o korzystaniu z funkcji zarządzania wtyczką XR.

1. W edytorze aparatu Unity na pasku menu wybierz pozycję Edytuj>ustawienia projektu.
2. W lewej kolumnie okna Ustawienia projektu wybierz pozycję Zarządzanie wtyczkami XR.

W tym momencie może zostać wyświetlony przycisk z etykietą Install XR Plugin Management (Zainstaluj wtyczkę XR Plugin Management ). Jeśli tak, przejdź do poniższych kroków. Jeśli masz już zainstalowany system zarządzania XR, możesz pominąć pozostałe kroki opisane w tej sekcji i przejść do następnej sekcji "Wybierz pozycję Windows Mixed Reality".

1. Kliknij przycisk Zainstaluj zarządzanie wtyczkami XR.

2. Zostanie wyświetlone okno dialogowe o nazwie Built in VR Detected (Wykryte wbudowane oprogramowanie VR) z pytaniem, czy chcesz usunąć wbudowany pakiet VR. Kliknij przycisk OK.

   

3. Zostanie wyświetlone okno dialogowe Wbudowane w vr włączone . Kliknij przycisk OK. Spowoduje to wyłączenie wbudowanej rzeczywistości wirtualnej.

4. Zostanie wyświetlone okno konfiguratora projektu zestawu narzędzi MRTK i zostanie wyświetlone żądanie włączenia potoku XR. Wybierz drugą opcję XR SDK/SR Management.

5. Na następnej stronie w konfiguratorze kliknij pozycję Pokaż ustawienia.

3. Wybierz pozycję "Windows Mixed Reality"

Nie jesteśmy jeszcze gotowi do zainstalowania biblioteki OpenXR, ale ten następny zestaw kroków ułatwia czyszczenie wszystkich interfejsów API, które były dostępne i obsługiwane tylko w ścieżce "Wbudowane XR". (Jeśli używasz zestawu narzędzi MRTK, większość z tych elementów jest dla Ciebie abstrakcyjna).

1. W oknie Ustawienia projektu edytora aparatu Unity upewnij się, że jesteś na stronie Zarządzanie wtyczką XR.
2. Wykonaj jedną z następujących czynności:
   • Jeśli używasz urządzenia HoloLens 2:
     Upewnij się, że jesteś na karcie platforma uniwersalna systemu Windows (jest to druga karta i wyświetla logo systemu Windows), a następnie w obszarze Plug-in-Providers wybierz pozycję Windows Mixed Reality.
   • Jeśli kierujesz aplikację Desktop VR:
     Upewnij się, że jesteś na karcie Pulpit (jest to pierwsza karta i wyświetla obraz monitora), a następnie w obszarze Dostawcy wtyczek wybierz pozycję Windows Mixed Reality.
3. Zostanie ponownie wyświetlone okno konfiguratora projektu zestawu narzędzi MRTK. Kliknij przycisk Dalej, a następnie ponownie kliknij przycisk Dalej. (Zanim przejdziesz dalej, warto pośminąć chwilę na przeczytanie wyjaśnień na tych stronach).
4. Wybierz pozycję Importuj podstawowe elementy TMP.
5. Wybierz pozycję Gotowe. Spowoduje to zamknięcie konfiguratora.
6. Zamknij okno Ustawienia projektu, zapisz projekt, a następnie zamknij aparat Unity.

4. Uaktualnienie do wersji Unity 2020.3 LTS

1. Zainstaluj najnowszą wersję poprawki LTS aparatu Unity 2020.3.
2. Otwórz projekt aparatu Unity 2019 w środowisku Unity 2020.3.

Zostanie wyświetlone okno dialogowe z pytaniem, czy chcesz uaktualnić projekt do nowszej wersji aparatu Unity. Kliknij przycisk POTWIERDŹ.

Jeśli wcześniej używano programu AR Foundation 2.0, projekt przeniesie Cię automatycznie do programu AR Foundation 4.0.

5. Użyj narzędzia funkcji rzeczywistości mieszanej, aby zainstalować więcej pakietów

Za pomocą narzędzia funkcji rzeczywistości mieszanej zaimportuj poniższe pakiety.

1. Otwórz listę rozwijaną Obsługa platformy i wybierz najnowszą wersję wtyczki Mixed Reality OpenXR.
2. Po załadowaniu pakietów zostanie wyświetlone okno dialogowe Ostrzeżenie z pytaniem, czy chcesz ponownie uruchomić edytor aparatu Unity w celu włączenia zaplecza. Wybierz opcję Tak.
3. Po ponownym otwarciu aparatu Unity zostanie wyświetlony konfigurator projektu zestawu narzędzi MRTK. Pośmiń chwilę na przeczytanie wyjaśnień w oknie, a następnie wybierz pozycję Zastosuj.
4. Zostanie wyświetlone okno dialogowe z informacją, że aparat Unity musi zostać uruchomiony ponownie, aby system wejściowy mógł zostać uruchomiony. Wybierz Zastosuj.

6. Konfigurowanie zarządzania wtyczkami XR dla biblioteki OpenXR

Po ponownym otwarciu aparatu Unity można ustawić środowisko uruchomieniowe OpenXR:

1. Na pasku menu wybierz pozycję Edytuj>ustawienia projektu.

   Spójrz w kolumnie po lewej stronie i upewnij się, że jesteś na stronie zarządzanie wtyczką XR i na karcie platforma uniwersalna systemu Windows (na karcie znajduje się obraz logo systemu Windows).

2. Na liście Dostawcy wtyczek wybierz pozycję OpenXR.

   

3. W tej samej sekcji wybierz grupę funkcji Microsoft HoloLens.

4. Pamiętaj, że obok pozycji OpenXR znajduje się żółty trójkąt ostrzegawczy. Umieść kursor nad trójkątem, a następnie odczytaj komunikat w oknie podręcznym, a następnie wybierz trójkąt.

   

5. W oknie Walidacja projektu OpenXR znajduje się kilka problemów. Wybierz przycisk Napraw wszystko.

   

6. Pozostaje jeden problem i informuje o tym, że musisz dodać co najmniej jeden profil interakcji. W tym celu kliknij przycisk Edytuj. Spowoduje to przejście do ustawień wtyczki OpenXR w oknie Ustawienia projektu.

   

7. Wybierz przycisk znaku plus (+) trzy razy przy każdym wybraniu innego profilu:

   

   Profil interakcji z spojrzeniem na oczy

   Profil interakcji z ręką firmy Microsoft

   Profil kontrolera ruchu Firmy Microsoft

   

   Jeśli profil interakcji wzroku lub inny profil pojawi się z żółtym trójkątem obok niego, wybierz trójkąt, a następnie w oknie Walidacja projektu OpenXR kliknij przycisk Napraw.

   

8. W sekcji Grupy funkcji OpenXR wybierz pozycję Microsoft HoloLens, a następnie wybierz pozycję Model śledzenia rąk i kontrolera ruchu, jeśli nie zostały jeszcze wybrane.

   

9. Kliknij listę rozwijaną Tryb przesyłania głębokości, a następnie wybierz pozycję Głębokość 16-bitowa.

   

10. Zamknij okno Ustawienia projektu i wszystkie inne okna, które są nadal otwarte.

Projekt jest teraz w pełni zmigrowany.

Zobacz też

• Omówienie usługi OpenXR
• Wprowadzenie do platformy OpenXR
• Więcej informacji na temat biblioteki OpenXR
• Specyfikacja openXR 1.0
• Dokumentacja interfejsu API openXR 1.0
• Przewodnik szybki po przewodniku szybkich informacji dotyczących platformy OpenXR 1.0