Penyiapan project Unity

Panduan ini menjelaskan versi editor, setelan grafis, setelan URP, dan setelan project Android yang direkomendasikan saat mengembangkan aplikasi Unity untuk Android XR.

Prasyarat

Untuk mengembangkan dengan Unity, Anda harus Mendownload dan menginstal Unity Hub.

Instal versi 6000.0.58f2 atau yang lebih tinggi dari Unity Editor dan Android Build Support, yang mencakup:

  • OpenJDK
  • Android SDK
  • Alat Android NDK

Pilih mesin rendering

Sebaiknya gunakan Vulkan Graphics API untuk merender aplikasi Android XR. Untuk memilih Vulkan sebagai Graphics API Anda, ikuti langkah-langkah berikut:

  1. Di Unity, buka Edit > Project Settings > Player.
  2. Pilih tab Android, lalu buka Other Settings > Rendering.
  3. Jika Auto Graphics API diaktifkan, nonaktifkan setelan ini untuk menampilkan bagian Graphics API.

  4. Di bagian Graphics APIs, pilih tombol Add (+), lalu pilih Vulkan dari dropdown.

    Contoh yang menunjukkan cara mengubah setelan API grafis di UI

  5. Susun ulang Graphics API menggunakan tuas (=) sehingga Vulkan tercantum terlebih dahulu.

  6. Secara opsional, pilih API Grafis lainnya dan klik tombol Hapus (-) untuk menghapusnya.

Pipeline Render Universal

Android XR kompatibel dengan Universal Render Pipeline (URP). Jika Anda berencana menggunakan passthrough, Anda harus memperbarui setelan URP default untuk performa passthrough terbaik di Android XR.

Tabel berikut berisi daftar setelan URP yang direkomendasikan Unity, yang dijelaskan secara lebih mendetail di bagian berikut.

Setelan

Lokasi

Nilai yang direkomendasikan

HDR

Aset Universal Render Pipeline

Nonaktif

Pasca-pemrosesan

Data Perender Universal

Nonaktif

Setelan Aset Pipeline Render Universal

Ikuti langkah-langkah berikut untuk mengoptimalkan Aset Universal Render Pipeline untuk Android XR:

  1. Temukan Aset Pipeline Render Universal project Anda. Salah satu cara untuk melakukannya adalah dengan mengetik t:UniversalRenderPipelineAsset di kotak penelusuran jendela Project.

  2. Di bagian header Kualitas, nonaktifkan HDR.

    Aset Universal Render Pipeline yang ditampilkan dengan setelan yang direkomendasikan

Setelan Data Universal Renderer

Ikuti langkah-langkah berikut untuk mengoptimalkan Data Universal Renderer Anda untuk Android XR:

  1. Temukan Aset Data Universal Renderer project Anda. Salah satu caranya adalah dengan mengetik t:UniversalRendererData di kotak penelusuran jendela Project.

  2. Di Inspector, di bagian header Post-processing, hapus centang pada Enabled.

    Data Universal Renderer yang ditampilkan dengan setelan yang direkomendasikan

Level API Android minimal

Setel project Anda ke level API minimum 24, yang diperlukan oleh OpenXR Loader. Jika tidak, build Anda mungkin gagal.

Selesaikan langkah-langkah berikut untuk menetapkan level API Android minimal.

  1. Buka Edit > Project Settings > Player.
  2. Pilih tab Android dan buka Setelan Lainnya.
  3. Di bagian Identifikasi, untuk Level API minimal, pilih 24 atau yang lebih tinggi.

Titik entri aplikasi

Konfigurasi setelan berikut untuk titik entri aplikasi:

  1. Buka Edit > Project Settings > Player.
  2. Pilih tab Android, lalu buka Setelan Lainnya.
  3. Di bagian Configuration, pastikan Application Entry Point memiliki GameActivity yang dicentang dan Activity yang tidak dicentang.

Jendela pop-up

Sebagian besar aplikasi Android XR memerlukan jendela yang dapat diubah ukurannya, karena jendela tersebut diperlukan untuk merender pop-up seperti permintaan izin sistem.

Ikuti langkah-langkah berikut untuk memastikan jendela pop-up dirender dengan benar.

  1. Buka Edit > Project Settings > Player.
  2. Pilih tab Android, lalu buka Resolution and Presentation
  3. Di bagian Resolusi, aktifkan Aktivitas yang Dapat Diubah Ukurannya.

Lihat juga

OpenXR™ dan logo OpenXR adalah merek dagang yang dimiliki oleh The Khronos Group Inc. dan terdaftar sebagai merek dagang di China, Uni Eropa, Jepang, dan Inggris Raya.