Wdrażanie projektu MRTK3 na urządzeniu Quest

Na tej stronie opisano sposób wdrażania projektu aparatu Unity za pomocą zestawu NARZĘDZI MRTK3 na urządzeniu Quest.

Uwaga

• Zdecydowanie zalecamy korzystanie z usługi Meta Quest Link w celu szybkiego iteracji i testowania na urządzeniach Quest, co pozwala na natychmiastowe testowanie na urządzeniu bez konieczności kompilowania i wdrażania.

Wymagania wstępne dotyczące wdrożenia

Te kroki są oparte na technologii OpenXR jako środowisku uruchomieniowym (tj. dostawcy wtyczki XR), ponieważ nie zalecamy używania OculusXR ze względu na podstawowe problemy ze zgodnością.

1. Upewnij się, że projekt jest gotowy do wdrożenia na urządzeniu Quest, wykonując następujące kroki.

2. Upewnij się, że tryb dewelopera jest włączony na urządzeniu (może być konieczne najpierw dołączenie do organizacji deweloperów). Instalowanie sterowników Oculus ADB jest opcjonalne.

3. Dodaj zestaw narzędzi MRTK do projektu i upewnij się, że ustawienia projektu są poprawnie skonfigurowane do używania potoku OpenXR i zestawu funkcji zestawu narzędzi MRTK. Te funkcje są wymagane do wdrożenia projektu na urządzeniu Quest. Możesz zignorować instrukcje dotyczące ustawień projektu dotyczące platformy UWP.

Uwaga

• Jeśli zaczniesz od naszego projektu szablonu, te ustawienia projektu powinny być już skonfigurowane.

1. Przejdź do Ustawienia kompilacji pliku>.

2. W obszarze Platforma wybierz pozycję Android. Przełącz platformę na system Android i poczekaj na zakończenie operacji.

3. Przejdź do pozycji Edytuj > Ustawienia projektu.

4. W obszarze Project Ustawienia przejdź do pozycji Zarządzanie wtyczką XR i włącz funkcję OpenXR na karcie Android. Upewnij się, że wybrano opcję Inicjowanie XR przy uruchamianiu i że nie włączono żadnych grup funkcji i poczekaj na zakończenie operacji.

   

5. W obszarze Projekt Ustawienia przejdź do pozycji XR Plug-in Management OpenXR Interaction Profiles (Profile interakcji openXR zarządzania wtyczką > XR>) i zmień go tak, aby był obecny tylko profil kontrolera Oculus Touch Controller.

6. W obszarze Project Ustawienia przejdź do pozycji XR Plug-in Management OpenXR OpenXR Feature Groups (Zarządzanie wtyczką > XR OpenXR OpenXR>) i upewnij się, że w obszarze Wszystkie funkcje zaznaczono następujące opcje.

   Uwaga

   Jeśli nie widzisz modelu śledzenia ręki lub kontrolera ruchu w panelu Grupy funkcji OpenXR, zapoznaj się z sekcją Konfigurowanie ustawień związanych z programem OpenXR ustawień projektu.

   

7. Przejdź do pozycji Walidacja projektu i napraw wszelkie ikony Błędu czerwonego lub żółtego/ostrzeżenia mogą pojawić się podczas tego procesu. Kliknij ikonę, aby otworzyć narzędzie weryfikacji projektu OpenXR, a następnie wybierz pozycję Napraw wszystko , aby rozwiązać problemy. Adres może zawierać kilka elementów.

8. Jeśli planujesz używać klawiatury natywnej, zapoznaj się z dokumentacją klawiatury, aby uzyskać wymaganą AndroidManifest.xml modyfikację.

Korzystanie z modeli kontrolera platformy

Uwaga

Modele kontrolerów są przechowywane w formacie, który nie jest natywnie obsługiwany przez aparat Unity. Aby użyć wizualizacji kontrolera zestawu NARZĘDZI MRTK w narzędziu Quest, musisz upewnić się, że w projekcie istnieją następujące pakiety:

• importer glTF, który umożliwia korzystanie z plików zasobów glTF w akwestie Unity i umożliwia korzystanie z wizualizacji kontrolera MRTK w narzędziu Quest
• Pakiet KTX, który umożliwia użytkownikom ładowanie plików tekstur uniwersalnych KTX lub Basis

Jeśli rozpoczęto pracę z projektem szablonu MRTK3, te pakiety zostały już uwzględnione w projekcie.

Wdrażanie na urządzeniu

Uwaga

Nie postępuj zgodnie z instrukcjami Konfigurowanie Ustawienia na stronie dokumentacji firmy Oculus. Ich instrukcje wymagają użycia zestawu Oculus Integration SDK i używają wtyczki Oculus XR, a nie wtyczki OpenXR.

Po skonfigurowaniu projektu przejdź do sekcji Generuj kompilację. Zalecamy wybranie pozycji Kompiluj i uruchom. Ta opcja umożliwia aparatowi Unity wdrożenie projektu bezpośrednio na urządzeniu Quest.