Konfigurowanie projektu Unreal Engine

Odpowiednie urządzenia z XR
Te wskazówki pomogą Ci tworzyć treści na te typy urządzeń z XR.
Więcej informacji o typach urządzeń XR →
Gogle XR
Przewodowe okulary XR
Więcej informacji o typach urządzeń XR →

W tym przewodniku znajdziesz szczegółowe informacje o zalecanych wersjach silnika, wymaganych pakietach SDK i ustawieniach projektu aplikacji na Androida podczas tworzenia aplikacji Unreal Engine na Androida XR.

Wymagania wstępne

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

  1. Pobierz i zainstaluj Epic Games Launcher.

    1. Zainstaluj Unreal Engine w wersji 5.6.x lub 5.8.x z Epic Games Launcher.

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

  3. Zainstaluj pakiet SDK .NET 8.0.

  4. Zainstaluj Android Studio (Rabbit 2 | 2026.2.2 lub nowsza wersja).

Instalowanie obsługi kompilacji na Androida

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

  1. Otwórz program uruchamiający Epic Games.

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

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

  3. Zainstaluj Java JDK 17.

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

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

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

    • 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 (wersja 5.6.x lub 5.8.x).
  2. W sekcji New Project Categories (Nowe kategorie projektów) wybierz szablon Virtual Reality (Rzeczywistość wirtualna).
  3. W menu Project Defaults (Domyślne ustawienia projektu) ustaw Target Platform (Platforma docelowa) na Mobile (Urządzenia mobilne).
  4. Ustaw Ustawienia jakości na Skalowalne, aby zapewnić optymalną wydajność na mobilnym sprzęcie XR.
  5. Wybierz nazwę projektu, a następnie kliknij Utwórz.

Konfigurowanie ustawień Androida

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

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

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

    Vulkan to zalecany, wysoce wydajny interfejs API do obsługi grafiki na Androidzie XR.

Konfigurowanie ustawień renderowania

Aby uzyskać wysoką liczbę klatek i wyraźny obraz wymagane w przypadku Androida XR, musisz też skonfigurować Unreal Engine tak, aby używał zoptymalizowanej ścieżki renderowania na urządzeniach mobilnych:

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

  2. W sekcji Forward Renderer (Renderowanie w przód) wybierz Forward Shading (Cieniowanie w przód).

    Mechanizm renderowania z wyprzedzeniem jest znacznie szybszy w przypadku mobilnej rzeczywistości wirtualnej niż domyślny mechanizm renderowania z opóźnieniem. Pamiętaj, że włączenie tej opcji wymaga ponownego uruchomienia edytora i kompilacji cieniowania.

  3. W sekcji Ustawienia domyślne ustaw Metodę antyaliasingu na MSAA.

  4. W sekcji Urządzenia mobilne ustaw Mobilny MSAA na 4x.

    MSAA zapewnia najostrzejsze wyniki w VR bez efektów rozmycia powodowanych przez TAA.

  5. W sekcji VR:

    1. Odznacz Mobilny HDR.

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

    2. Wybierz Widok łączony na urządzeniach mobilnych.

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

Zobacz też

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