Konfigurowanie projektu Unreal Engine

Obsługiwane urządzenia z XR
Te wskazówki pomogą Ci tworzyć aplikacje na te typy urządzeń z XR.
Więcej informacji o typach urządzeń z XR →
Gogle XR
Okulary XR z przewodami
Więcej informacji o typach urządzeń z XR →

W tym przewodniku znajdziesz zalecane wersje silnika, wymagane pakiety SDK i ustawienia projektu Android podczas tworzenia aplikacji Unreal Engine na Androida XR.

Wymagania wstępne

Zanim skonfigurujesz Unreal Engine do tworzenia aplikacji na Androida XR, musisz zainstalować te aplikacje i narzędzia:

  1. Pobierz i zainstaluj Epic Games Launcher.

    1. W Epic Games Launcher zainstaluj Unreal Engine w wersji 5.6.1 (lub nowszej).

  2. Skonfiguruj system do tworzenia kodu C++ (np. za pomocą Visual Studio 2022 w systemie Windows lub Xcode w systemie macOS). Więcej informacji znajdziesz w artykule Epic o konfigurowaniu środowiska programistycznego C++.

  3. Zainstaluj pakiet SDK .NET 8.0.

  4. Zainstaluj Android Studio (Panda 4 | 2025.3.4 Patch 1 lub nowszy).

Instalowanie obsługi kompilacji na Androida

Android XR korzysta z określonych wersji pakietu SDK, dlatego musisz zainstalować odpowiednie narzędzia do kompilacji na Androida razem z Unreal Engine.

  1. Otwórz Epic Games Launcher.

  2. Kliknij strzałkę w dół obok zainstalowanej wersji silnika (przycisk Uruchom) i kliknij Opcje.

    1. Przewiń dalej do opcji instalacji, kliknij Android i kliknij Zastosuj.
    2. Jeśli pojawi się prośba, zezwól silnikowi na zarejestrowanie wszystkich wymaganych rozszerzeń plików.

  3. Zainstaluj Java JDK 17.

  4. W Android Studio użyj SDK Manager, aby zainstalować te konkretne wersje wymagane przez przykłady Androida XR:

    • Platformy pakietu SDK: 34, 35 i 36
    • NDK: 29.0.x
    • Narzędzia wiersza poleceń (wszystkie elementy)

  5. Aby skonfigurować te zmienne środowiskowe systemu, postępuj zgodnie z zaawansowanym przewodnikiem po konfiguracji i rozwiązywaniu problemów firmy Epic:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Tworzenie projektu Unreal XR

Następnie utwórz nowy projekt i skonfiguruj go za pomocą niezbędnych wtyczek i danych wejściowych XR:

  1. Uruchom Unreal Engine 5.6.1.
  2. W sekcji New Project Categories (Kategorie nowych projektów) wybierz szablon Virtual Reality (Wirtualna rzeczywistość).
  3. W menu Project Defaults (Domyślne ustawienia projektu) ustaw Target Platform (Platforma docelowa) na Mobile (Urządzenia mobilne).
  4. Ustaw Quality Preset (Ustawienie jakości) na Scalable (Skalowalne), aby zapewnić optymalną wydajność na urządzeniach mobilnych z XR.
  5. Wybierz nazwę projektu i kliknij Utwórz.

Konfigurowanie ustawień Androida

Po otwarciu projektu wykonaj te czynności, aby ustawić wymagane poziomy interfejsu API Androida i ustawienia grafiki dla Androida XR:

  1. Kliknij Edit > Project Settings (Edytuj > Ustawienia projektu).
  2. Kliknij Platforms > Android (Platformy > Android).
  3. Jeśli przycisk Accept SDK License (Zaakceptuj licencję pakietu SDK) jest podświetlony na czerwono, kliknij go.
  4. W sekcji APKPackaging (Pakowanie APK):
    • Ustaw Minimum SDK Version (Minimalna wersja pakietu SDK) na 34.
    • Ustaw Target SDK Version (Docelowa wersja pakietu SDK) na 34 (lub nowszą).

  5. Przewiń dalej do sekcji Build (Kompilacja) i kliknij Support Vulkan (Obsługa Vulkan).

    Vulkan to zalecany, wysoce wydajny interfejs API grafiki dla Androida XR.

Konfigurowanie ustawień renderowania

Aby uzyskać wysokie liczby klatek na sekundę i przejrzystość obrazu wymagane przez Androida XR, musisz też skonfigurować Unreal Engine tak, aby korzystał ze zoptymalizowanej ścieżki renderowania na urządzeniach mobilnych:

  1. Kliknij Edit > Project Settings (Edytuj > Ustawienia projektu) i kliknij Engine > Rendering (Silnik > Renderowanie).

  2. W sekcji Forward Renderer (Renderowanie do przodu) kliknij Forward Shading (Cieniowanie do przodu).

    Renderowanie do przodu jest znacznie szybsze w przypadku VR na urządzeniach mobilnych niż domyślne renderowanie odroczone. Pamiętaj, że włączenie tej opcji wymaga ponownego uruchomienia edytora i kompilacji shaderów.

  3. W sekcji Default Settings (Ustawienia domyślne) ustaw Anti-Aliasing Method (Metoda wygładzania krawędzi) na MSAA.

  4. W sekcji Mobile (Urządzenia mobilne) ustaw Mobile MSAA (MSAA na urządzeniach mobilnych) na 4x.

    MSAA zapewnia najlepsze wyniki w przypadku VR bez efektów rozmycia spowodowanych przez Temporal AA (TAA).

  5. W sekcji VR:

    1. Odznacz Mobile HDR (HDR na urządzeniach mobilnych).

      Wyłączenie HDR na urządzeniach mobilnych znacznie zmniejsza obciążenie związane z przetwarzaniem końcowym.

    2. Wybierz Mobile Multi-View.

      Dzięki temu silnik może renderować obraz dla obu oczu w jednym przebiegu, co znacznie poprawia wydajność procesora.

Zobacz też

Szczegółowe instrukcje wdrażania projektu szablonu na urządzeniu z Androidem znajdziesz w artykule Konfigurowanie projektów Unreal Engine do tworzenia aplikacji na Androida.