Konfigurowanie projektu Unreal Engine

Odpowiednie urządzenia XR

Te wskazówki pomogą Ci tworzyć treści na te typy urządzeń XR.

Więcej informacji o typach urządzeń z XR

Więcej informacji o typach urządzeń z XR

W tym przewodniku znajdziesz zalecane wersje silnika, wymagane pakiety SDK i ustawienia projektu Androida 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 programie uruchamiającym Epic Games zainstaluj Unreal Engine w wersji 5.6.1 (lub nowszej).

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 Epic o konfigurowaniu środowiska programistycznego C++.

3. Zainstaluj pakiet SDK.NET 8.0.

4. Zainstaluj Androida Studio (Quail 2 | 2026.1.2 lub nowszego).

Instalowanie obsługi kompilacji na Androida

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

1. Otwórz program startowy Epic Games.

2. Kliknij strzałkę obok zainstalowanej wersji Engine (przycisk Uruchom) i kliknij Opcje.

   1. Przewiń dalej do opcji instalacji, wybierz Android i kliknij Zastosuj.
   2. Jeśli pojawi się prośba, zezwól silnikowi na zarejestrowanie wszystkich wymaganych przez niego 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 zaawansowanym przewodnikiem po 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 XR i danych wejściowych:

1. Uruchom Unreal Engine 5.6.1.
2. W sekcji Nowe kategorie projektów wybierz szablon Wirtualna rzeczywistość.
3. W menu Ustawienia domyślne projektu ustaw Platformę docelową na Urządzenia mobilne.
4. Ustaw Gotowe 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 dla Androida XR:

1. Kliknij Edytuj > Ustawienia projektu.
2. Kliknij Platformy > Android.
3. Jeśli przycisk Accept SDK License (Akceptuj licencję na pakiet SDK) jest podświetlony na czerwono, kliknij go.
4. W sekcji APKPackaging:
   • Ustaw Minimalną wersję pakietu SDK na 34.
   • Ustaw Wersję docelowego pakietu SDK na 34 (lub nowszą).

5. Przewiń dalej do sekcji Kompilacja i kliknij Obsługa platformy Vulkan.

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

Konfigurowanie ustawień renderowania

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

1. Kliknij Edytuj > Ustawienia projektu i otwórz Silnik > Renderowanie.

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

   Renderowanie do przodu jest znacznie szybsze w przypadku VR na urządzenia mobilne niż domyślne renderowanie odroczone. Pamiętaj, że włączenie tej opcji wymaga ponownego uruchomienia edytora i skompilowania cieniowania.

3. W sekcji Ustawienia domyślne ustaw Metodę wygładzania krawędzi na MSAA.

4. W sekcji Urządzenia mobilne ustaw opcję Wygładzanie krawędzi na urządzeniach mobilnych na 4x.

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

5. W sekcji VR:

   1. Odznacz HDR na urządzeniu mobilnym.

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

   2. Wybierz Widok łączony na urządzeniu mobilnym.

      Dzięki temu silnik może renderować oba obrazy 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 tworzenia aplikacji na Androida.