Podgląd bezpośredni umożliwia testowanie i iterowanie złożonych interakcji bezpośrednio w edytorze Unreal Editor przy użyciu danych na żywo z urządzenia z Androidem XR. Dzięki podglądowi bezpośredniemu maszyna hosta renderuje i debuguje treści, przesyła strumieniowo widok bezpośrednio na fizyczne urządzenie z Androidem XR oraz przesyła strumieniowo obsługiwane rozszerzenia OpenXR z powrotem do hosta w czasie rzeczywistym.
Skorzystaj z tego przewodnika, aby skonfigurować podgląd bezpośredni w projekcie w Unreal Engine.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że środowisko programistyczne spełnia te wymagania:
- Wersja Unreal Engine: Unreal Engine 5.6.1 lub nowsza.
- Konfiguracja projektu: wykonaj wszystkie czynności opisane w przewodniku dotyczącym konfiguracji projektu w Unreal Engine.
- Android XR Engine Hub: wykonaj wszystkie czynności opisane w sekcji „Pierwsze kroki” w przewodniku po Android XR Engine Hub , aby zainstalować i skonfigurować maszynę hosta na potrzeby podglądu bezpośredniego.
Sprzęt:
- Użyj maszyny hosta z systemem Windows 11.
- Użyj nowoczesnej karty graficznej z obsługą kodowania wideo Vulkan.
Konfigurowanie wtyczek Androida XR
Skonfiguruj Unreal Engine za pomocą wymaganych wtyczek Androida XR:
-
Jeśli później utworzysz nowy projekt lub otworzysz projekt, którego nie używasz z podglądem bezpośrednim, wykonaj te same czynności ponownie.
W przypadku każdego projektu upewnij się, że projekt ma dowiązanie symboliczne do folderu wtyczek dostawcy.
Konfigurowanie ustawień projektu
Skonfiguruj ustawienia projektu na potrzeby strumieniowego przesyłania podglądu bezpośredniego:
- Kliknij Ustawienia projektu > Platformy > Windows.
- W przypadku RHI wybierz Vulkan.
- Kliknij Edytuj > Wtyczki.
- Włącz wtyczkę AndroidXRStreaming.
- Kliknij Edytuj > Ustawienia projektu > Opis.
- Włącz Uruchom w VR.
Włączanie środowiska wykonawczego strumieniowego przesyłania
Gdy w projekcie jest włączona wtyczka AndroidXRStreaming , sprawdź, czy jest obecne środowisko wykonawcze strumieniowego przesyłania Androida XR:
- Kliknij Ustawienia projektu > Wtyczki > AndroidXRStreaming.
Kliknij Włącz strumieniowe przesyłanie Androida XR.
Aby zastosować te zmiany, uruchom ponownie Unreal Engine.
Konfigurowanie klienta strumieniowego przesyłania
Skonfiguruj klienta strumieniowego przesyłania za pomocą różnych opcji projektu:
- Kliknij Ustawienia projektu > Wtyczki.
W sekcji AndroidXRStreamingClient sprawdź każdą z tych opcji i włącz lub wyłącz je, aby dopasować je do potrzeb projektu:
- Auto Start Client On Preview (Automatyczne uruchamianie klienta w podglądzie): gdy ta opcja jest włączona, po kliknięciu Start VR Preview (Uruchom podgląd VR) w edytorze uruchamia aplikację klienta podglądu na dowolnym prawidłowym, wybranym urządzeniu.
- Auto Stop Client On Preview (Automatyczne zatrzymywanie klienta w podglądzie): gdy ta opcja jest włączona, zamyka klienta podglądu po zatrzymaniu podglądu VR w edytorze.
- Auto Select Compatible Device (Automatyczne wybieranie zgodnego urządzenia): gdy ta opcja jest włączona, podczas wyszukiwania urządzeń automatycznie wybiera pierwsze zgodne urządzenie podłączone do maszyny.
- Show Error Dialogs (Wyświetlaj okna błędów): gdy ta opcja jest włączona, wyświetla dodatkowe okna błędów (np. okno błędu, jeśli spróbujesz uruchomić podgląd VR bez wybrania urządzenia klienta). Aby ukryć te okna, wyłącz tę opcję.
- Refresh (Odśwież): gdy ta opcja jest włączona, przycisk Refresh (Odśwież) wyszukuje podłączone urządzenia i wyświetla listę zgodnych urządzeń (określaną na podstawie obecności aplikacji klienta podglądu bezpośredniego w Android XR Engine Hub).
Uruchamianie podglądu bezpośredniego
Uruchom podgląd bezpośredni, aby przesyłać strumieniowo bezpośrednio z Unreal Engine:
Podłącz urządzenie z Androidem XR do maszyny hosta za pomocą kabla USB-C wysokiej jakości.
Jeśli nigdy wcześniej nie używasz tego urządzenia z podglądem bezpośrednim, przed uruchomieniem podglądu bezpośredniego w silniku gry podłącz i skonfiguruj urządzenie na potrzeby podglądu bezpośredniego w Android XR Engine Hub.
W edytorze Unreal Editor kliknij Play level in VR (Odtwórz poziom w VR). Podczas uruchamiania podglądu bezpośredniego nie używaj zwykłej opcji Play in Editor (Odtwórz w edytorze).