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 Unity Editor dan Android Build Support versi 6000.0.23f1 atau yang lebih tinggi, yang mencakup:

• OpenJDK
• Android SDK
• Alat Android NDK

Memilih mesin rendering

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

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

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

   

5. Urutkan ulang Graphics API menggunakan nama sebutan (=) sehingga Vulkan dicantumkan terlebih dahulu.

6. Atau, pilih Graphics API lainnya, lalu klik tombol Remove (-) untuk menghapusnya.

Pipeline Render Universal

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

Catatan: Untuk project yang ada dengan aset yang dibuat untuk Pipeline Render Bawaan, Anda harus menggunakan Konverter Pipeline Render untuk mengonversi aset tersebut agar kompatibel dengan URP.

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

Setelan	Lokasi	Nilai yang direkomendasikan
HDR	Aset Pipeline Render Universal	Nonaktif
Pasca-pemrosesan	Data Perender Universal	Nonaktif

Catatan: Vulkan diperlukan jika Anda menggunakan URP. Sebaiknya gunakan Vulkan sebagai API grafis untuk Android XR, karena fitur grafis yang lebih baru hanya didukung dengan API tersebut.

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.

   Catatan: Jika project Anda tidak berisi Aset Pipeline Render Universal, lihat Menginstal Pipeline Render Universal ke Project yang ada dari dokumen URP.

2. Di bagian header Kualitas, nonaktifkan HDR.

   

Setelan Data Universal Renderer

Ikuti langkah-langkah berikut untuk mengoptimalkan Data Perender Universal untuk Android XR:

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

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

   

Level API Android minimum

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

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

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

Titik entri aplikasi

Konfigurasikan setelan berikut untuk titik entri aplikasi:

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

Jendela pop-up

Sebagian besar aplikasi Android XR memerlukan jendela yang dapat diubah ukurannya, karena 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 dan aktifkan Resizeable Activity.

Lihat juga

• Unity Android XR: OpenXR
• Mengimpor Ekstensi XR Android untuk Unity