Podgląd bezpośredni umożliwia testowanie i iterowanie złożonych interakcji bezpośrednio w edytorze Unreal 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 widoczny obszar bezpośrednio na fizyczne urządzenie z Androidem XR i przesyła strumieniowo obsługiwane rozszerzenia OpenXR z powrotem do hosta w czasie rzeczywistym.
Postępuj zgodnie z tym przewodnikiem, aby skonfigurować podgląd bezpośredni w projekcie w Unreal Engine.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że Twoje środowisko programistyczne spełnia te wymagania:
- Wersja Unreal Engine: Unreal Engine 5.6.x lub 5.8.x.
- Konfiguracja projektu: wykonaj wszystkie czynności opisane w przewodniku Konfigurowanie 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 komputera hosta z systemem Windows 11.
- Użyj nowoczesnej karty graficznej z obsługą kodowania wideo Vulkan.
Konfigurowanie wtyczek Androida XR
Skonfiguruj Unreal Engine z wymaganymi wtyczkami Androida XR:
Postępuj zgodnie z instrukcjami podanymi w krótkim przewodniku po rozszerzeniach Androida XR dla Unreal Engine.
Jeśli później utworzysz nowy projekt lub otworzysz projekt, który nie był używany z podglądem bezpośrednim, wykonaj te same czynności.
Upewnij się, że każdy projekt ma dowiązanie symboliczne do folderu wtyczek dostawcy.
Skonfiguruj ustawienia projektu
Skonfiguruj ustawienia projektu na potrzeby strumieniowego przesyłania bezpośredniego podglądu:
- Kliknij Project Settings > Platforms > Windows (Ustawienia projektu > Platformy > Windows).
- RHI na Vulkan.
- Kliknij Edit > Plugins (Edytuj > Wtyczki).
- Włącz wtyczkę AndroidXRStreaming.
- Kliknij kolejno Edytuj > Ustawienia projektu > Opis.
- Włącz opcję Uruchom w VR.
Włączanie środowiska wykonawczego strumieniowania
Teraz, gdy w projekcie jest włączona wtyczka AndroidXRStreaming, sprawdź, czy jest obecne środowisko wykonawcze strumieniowania na Androidzie XR:
- Kliknij Project Settings > Plugins > AndroidXRStreaming (Ustawienia projektu > Wtyczki > AndroidXRStreaming).
Kliknij Włącz strumieniowanie na Androidzie XR.
Uruchom ponownie Unreal Engine, aby zastosować te zmiany.
Konfigurowanie klienta strumieniowania
Skonfiguruj klienta strumieniowego z różnymi opcjami dla projektu:
- Kliknij Project Settings > Plugins (Ustawienia projektu > Wtyczki).
W sekcji AndroidXRStreamingClient sprawdź każdą z tych opcji i włącz lub wyłącz je zgodnie z potrzebami projektu:
- Auto Start Client On Preview (Automatyczne uruchamianie klienta w trybie podglądu): gdy ta opcja jest włączona, kliknięcie Start VR Preview (Uruchom podgląd VR) w edytorze powoduje uruchomienie aplikacji klienckiej w trybie podglądu na dowolnym prawidłowym, wybranym urządzeniu.
- Auto Stop Client On Preview (Automatyczne zatrzymywanie klienta podczas podglądu): gdy ta opcja jest włączona, klient podglądu jest zamykany po zatrzymaniu podglądu VR w edytorze.
- Automatycznie wybieraj zgodne urządzenie: gdy ta opcja jest włączona, podczas wyszukiwania urządzeń automatycznie wybierane jest pierwsze zgodne urządzenie podłączone do komputera.
- Pokaż okna dialogowe błędów: po włączeniu tej opcji wyświetlane są dodatkowe okna dialogowe błędów (np. okno dialogowe błędu wyświetla się, gdy próbujesz uruchomić podgląd VR bez wybrania urządzenia klienta). Wyłącz tę opcję, aby ukryć te okna.
- Odśwież: po włączeniu przycisk Odśwież wyszukuje połączone urządzenia i wyświetla listę zgodnych urządzeń (określonych na podstawie obecności aplikacji klienckiej Direct Preview w Android XR Engine Hub).
Uruchamianie podglądu bezpośredniego
Aby rozpocząć podgląd bezpośredni i transmitować bezpośrednio z Unreal Engine:
Podłącz urządzenie z Androidem XR do komputera hosta za pomocą kabla USB-C wysokiej jakości.
Jeśli to urządzenie nie było wcześniej używane z podglądem bezpośrednim, przed rozpoczęciem korzystania z podglądu bezpośredniego w silniku gry połącz je i skonfiguruj w Android XR Engine Hub.
W edytorze Unreal kliknij Play level in VR (Graj na poziomie w VR). Podczas uruchamiania podglądu bezpośredniego nie używaj zwykłej opcji Play in Editor (Odtwórz w edytorze).