Penyiapan project Unreal Engine

Perangkat XR yang kompatibel
Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.
Headset XR
Kacamata XR Berkabel

Panduan ini menjelaskan versi mesin yang direkomendasikan, SDK yang diperlukan, dan setelan project Android saat mengembangkan aplikasi Unreal Engine untuk Android XR.

Prasyarat

Sebelum dapat menyiapkan Unreal Engine untuk pengembangan Android XR, Anda harus menginstal aplikasi dan alat berikut:

  1. Download dan instal Epic Games Launcher.

    1. Dari Epic Games Launcher, instal Unreal Engine versi 5.6.1 (atau yang lebih tinggi).
  2. Siapkan sistem Anda untuk membuat kode C++ (misalnya, menggunakan Visual Studio 2022 untuk Windows, atau Xcode untuk macOS). Untuk mengetahui informasi selengkapnya, lihat Penyiapan lingkungan pengembangan C++ Epic.

  3. Instal .NET 8.0 SDK.

  4. Instal Android Studio (Panda 4 | 2025.3.4 Patch 1 atau yang lebih tinggi).

Menginstal dukungan build Android

Karena Android XR bergantung pada versi SDK tertentu, Anda harus menginstal alat build Android yang benar bersama dengan Unreal Engine.

  1. Buka Epic Games Launcher.
  2. Klik panah drop-down di samping versi Engine yang diinstal (tombol Luncurkan), lalu klik Opsi.

    1. Scroll lebih lanjut ke opsi penginstalan, pilih Android, dan klik Terapkan.
    2. Jika diminta, izinkan mesin untuk mendaftarkan ekstensi file yang diperlukan.
  3. Instal Java JDK 17.

  4. Di Android Studio, gunakan SDK Manager untuk menginstal versi spesifik berikut yang diperlukan oleh contoh Android XR:

    • Platform SDK: 34, 35, dan 36
    • NDK: 29.0.x
    • Alat Command Line (semua item)
  5. Ikuti panduan Penyiapan dan pemecahan masalah lanjutan Epic untuk mengonfigurasi variabel lingkungan sistem berikut:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Membuat project Unreal XR

Selanjutnya, buat project baru dan konfigurasikan dengan plugin dan input XR yang diperlukan:

  1. Luncurkan Unreal Engine 5.6.1.
  2. Di bagian New Project Categories, pilih template Virtual Reality.
  3. Di menu Project Defaults, tetapkan Target Platform ke Mobile.
  4. Tetapkan Quality Preset ke Scalable untuk meningkatkan performa optimal pada hardware XR seluler.
  5. Pilih nama project, lalu klik Create.

Mengonfigurasi setelan Android

Setelah project Anda terbuka, selesaikan langkah-langkah berikut untuk menetapkan level API Android dan setelan grafis yang diperlukan untuk Android XR:

  1. Buka Edit > Project Settings.
  2. Buka Platforms > Android.
  3. Jika tombol Accept SDK License berwarna merah, klik tombol tersebut.
  4. Di bagian APKPackaging :
    • Tetapkan Minimum SDK Version ke 34.
    • Tetapkan Target SDK Version ke 34 (atau yang lebih tinggi).
  5. Scroll lebih lanjut ke bagian Build , lalu pilih Support Vulkan.

    Vulkan adalah API grafis berperforma tinggi yang direkomendasikan untuk Android XR.

Mengonfigurasi setelan rendering

Untuk mencapai kecepatan frame tinggi dan kejernihan visual yang diperlukan untuk Android XR, Anda juga harus mengonfigurasi Unreal Engine untuk menggunakan jalur rendering seluler yang dioptimalkan:

  1. Buka Edit > Project Settings , lalu buka Engine > Rendering.
  2. Di bagian Forward Renderer, pilih Forward Shading.

    Renderer penerusan jauh lebih cepat untuk VR seluler daripada renderer tertunda default. Perhatikan bahwa mengaktifkan hal ini memerlukan memulai ulang editor dan kompilasi shader.

  3. Di bagian Default Settings, tetapkan Anti-Aliasing Method ke MSAA.

  4. Di bagian Mobile, tetapkan Mobile MSAA ke 4x.

    MSAA memberikan hasil paling tajam untuk VR tanpa efek buram yang disebabkan oleh Temporal AA (TAA).

  5. Di bagian VR:

    1. Hapus centang Mobile HDR.

      Menonaktifkan Rentang Dinamis Tinggi di perangkat seluler akan mengurangi overhead pascapemrosesan secara drastis.

    2. Pilih Mobile Multi-View.

      Hal ini memungkinkan mesin merender kedua mata dalam satu proses, sehingga meningkatkan performa CPU secara signifikan.

Lihat juga

Untuk mengetahui petunjuk mendetail tentang cara men-deploy project template ke perangkat yang didukung Android, lihat Menyiapkan project Unreal Engine untuk pengembangan Android.