Funkcja Direct Preview umożliwia testowanie i iteracyjne ulepszanie złożonych interakcji bezpośrednio w edytorze Unreal przy użyciu danych na żywo z urządzenia z Androidem XR. W przypadku podglądu bezpośredniego urządzenie hosta renderuje i debuguje treści, przesyła widok bezpośrednio na fizyczne urządzenie z Androidem XR oraz przesyła obsługiwane rozszerzenia OpenXR z powrotem do hosta w czasie rzeczywistym.
Wykonaj czynności opisane w tym przewodniku, 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.1 lub nowsza.
- Konfiguracja projektu: wykonaj wszystkie czynności opisane w przewodniku Konfigurowanie projektu Unreal Engine.
- Centrum Androida XR Engine: wykonaj wszystkie czynności opisane w sekcji Pierwsze kroki w przewodniku po Centrum Androida XR Engine, aby zainstalować i skonfigurować komputer hosta na potrzeby podglądu bezpośredniego.
Sprzęt:
- Użyj maszyny hosta z systemem Windows 11.
- Używaj 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 w przewodniku Android XR Extensions for Unreal Engine – szybki start.
Jeśli później utworzysz nowy projekt lub otworzysz projekt, którego nie używasz z bezpośrednim podglądem, ponownie wykonaj te same czynności.
W przypadku każdego projektu sprawdź, czy zawiera on symboliczne połączenie z folderem wtyczek dostawcy.
Skonfiguruj ustawienia projektu
Skonfiguruj ustawienia projektu na potrzeby przesyłania strumieniowego bezpośredniego podglądu:
- Kliknij Ustawienia projektu > Platformy > Windows.
- Z RHI na Vulkan.
- Kliknij Edytuj > Wtyczki.
- Włącz wtyczkę AndroidXRStreaming.
- Kliknij Edytuj > Ustawienia projektu > Opis.
- Włącz opcję Uruchom w VR.
Włącz środowisko wykonawcze strumieniowania
Teraz, gdy w projekcie jest włączona wtyczka AndroidXRStreaming, sprawdź, czy jest dostępny środowisko wykonawcze strumieniowania na Androida XR:
- Kliknij Ustawienia projektu > Wtyczki > AndroidXRStreaming.
Kliknij Włącz transmisję na Androidzie XR.
Aby zastosować te zmiany, uruchom ponownie Unreal Engine.
Konfigurowanie klienta przesyłania strumieniowego
Skonfiguruj klienta przesyłania strumieniowego z różnymi opcjami projektu:
- Kliknij Ustawienia projektu > Wtyczki.
W sekcji AndroidXRStreamingClient sprawdź każdą z tych opcji i włącz lub wyłącz je zgodnie z potrzebami projektu:
- Automatyczne uruchamianie klienta w podglądzie: po włączeniu uruchamia aplikację klienta podglądu na dowolnym prawidłowym, wybranym urządzeniu po kliknięciu Uruchom podgląd VR w edytorze.
- Automatyczne zatrzymywanie klienta w podglądzie: po włączeniu tej opcji klient podglądu zostanie zamknięty, gdy podgląd VR z edytora zostanie zatrzymany.
- Automatyczne wybieranie zgodnego urządzenia: po włączeniu tej opcji podczas wyszukiwania urządzeń automatycznie wybierane jest pierwsze zgodne urządzenie podłączone do maszyny.
- Wyświetlaj okna dialogowe błędów: gdy ta opcja jest włączona, wyświetlane są dodatkowe okna dialogowe błędów (np. okno dialogowe błędu wyświetla się, gdy próbujesz rozpocząć 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 podłączone urządzenia i wyświetla listę zgodnych (określanych na podstawie obecności aplikacji klienckiej Direct Preview w Centrum silnika Android XR).
Uruchom bezpośredni podgląd
Uruchom podgląd bezpośredni, aby przesyłać strumieniowo 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 nigdy wcześniej nie używałeś(-aś) tego urządzenia z podglądem bezpośrednim, przed rozpoczęciem podglądu bezpośredniego w silniku gry połącz i skonfiguruj urządzenie na potrzeby podglądu bezpośredniego w centrum Android XR Engine Hub.
W edytorze Unreal kliknij Play level in VR (Odtwórz poziom w VR). Nie używaj zwykłej opcji Odtwórz w edytorze podczas uruchamiania podglądu bezpośredniego.