Penyiapan project Unreal Engine

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

Panduan ini menjelaskan versi mesin game 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 Peluncur Epic Games.

    1. Dari Peluncur Epic Games, instal Unreal Engine versi 5.6.1 (atau yang lebih tinggi).

  2. Siapkan sistem Anda untuk membangun 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 (Quail 2 | 2026.1.2 atau yang lebih baru).

Menginstal dukungan build Android

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

  1. Buka Peluncur Epic Games.

  2. Klik panah drop-down di samping versi Engine yang diinstal (tombol Launch), lalu klik Options.

    1. Scroll lebih lanjut ke opsi penginstalan, pilih Android, lalu klik Terapkan.
    2. Jika diminta, izinkan mesin 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. Setel Preset Kualitas ke Dapat Diskalakan untuk meningkatkan performa yang optimal di hardware XR seluler.
  5. Pilih nama project, lalu klik Buat.

Mengonfigurasi setelan Android

Setelah project Anda terbuka, selesaikan langkah-langkah berikut untuk menyetel tingkat 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 ditandai dengan warna merah, klik tombol tersebut.
  4. Di bagian APKPackaging:
    • Setel Minimum SDK Version ke 34.
    • Setel 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 kejelasan visual yang diperlukan untuk Android XR, Anda juga harus mengonfigurasi Unreal Engine untuk menggunakan jalur rendering seluler yang dioptimalkan:

  1. Buka Edit > Project Settings dan buka Engine > Rendering.

  2. Di bagian Forward Renderer, pilih Forward Shading.

    Perender penerusan jauh lebih cepat untuk VR seluler daripada perender tertunda default. Perhatikan bahwa pengaktifan ini memerlukan mulai 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 HDR Seluler.

      Menonaktifkan Rentang Dinamis Tinggi di perangkat seluler akan mengurangi overhead pasca-pemrosesan secara drastis.

    2. Pilih Multi-Tampilan Seluler.

      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 berbasis Android, lihat Menyiapkan project Unreal Engine untuk pengembangan Android.