Konfigurasi universal render pipeline (URP)

Dokumen ini menjelaskan cara mengonfigurasi proyek Universal Render Pipeline (URP) saat mengintegrasikan fungsionalitas EasyAR.

Sebelum memulai

• Pahami cara menggunakan URP di Unity.
• Lihat Mengaktifkan EasyAR di Unity untuk mengimpor plugin EasyAR Unity.

Membuat aset universal render pipeline

[!CATATAN] Jika proyek Unity dibuat menggunakan template proyek URP, atau jika proyek sudah memiliki UniversalRenderPipelineAsset dan Universal Renderer, Anda dapat langsung melompat ke konfirmasi proyek telah beralih ke pipeline rendering URP.

Di jendela Project, buat aset yang diperlukan melalui menu klik kanan Create > Rendering > URP Asset(with Universal Renderer):

Menemukan aset universal render pipeline yang digunakan oleh platform target

1. Klik menu Edit > Project Settings > Graphics.

   Slot Default Render Pipeline di bagian atas seharusnya sudah memiliki Universal Render Pipeline Asset yang ditetapkan.

   

   Kiat

   Opsi ini disebut Scriptable Render Pipeline Settings di versi Unity yang lebih lama.

2. Klik menu Project Settings > Quality.

   Pilih tingkat kualitas untuk platform target, Render Pipeline Asset di bawahnya adalah aset Universal Render Pipeline yang digunakan oleh platform target. Jika kosong, aset Universal Render Pipeline yang digunakan oleh platform target adalah aset yang dikonfigurasi di jendela Graphics.

   

   Kiat

   Jika pengaturan di Quality tidak sesuai dengan Graphics, sistem akan memprioritaskan penggunaan Asset dari Quality.

Mengonfigurasi aset universal render pipeline

[!PENTING] Aset Universal Render Pipeline yang digunakan di editor Unity dan di perangkat seperti Android/iOS seringkali berbeda, perlu dikonfigurasi secara terpisah untuk penggunaan di editor dan di perangkat.

1. Pilih Universal Render Pipeline Asset yang digunakan oleh platform target, lalu pilih Universal Renderer Data yang digunakannya.

   

   Kiat

   Jika proyek memiliki beberapa Renderer yang dikonfigurasi, pastikan memilih renderer yang sedang digunakan oleh kamera AR. Anda dapat memeriksa nilai indeks saat ini di opsi Renderer di Camera component > Rendering pada kamera adegan.

2. Di panel Inspector Universal Renderer Data, klik Add Renderer Feature di bagian bawah, lalu tambahkan EasyARCameraImageRendererFeature.

   

Pertimbangan saat menggunakan contoh EasyAR

Adegan contoh yang disertakan dalam plugin EasyAR Unity secara default menggunakan material dan shader dari pipeline rendering Built-in. Unity secara otomatis akan mengonversi material dan shader ini ke versi yang kompatibel dengan URP, tetapi beberapa aset mungkin mengalami rendering yang tidak normal. Perlu merujuk ke Convert assets using the Render Pipeline Converter untuk mengonversi secara manual.

Klik menu Window > Rendering > Render Pipeline Converter, pilih Built-in to URP untuk membuka jendela konversi. Centang Material Upgrade dan Readonly Material Converter > klik Convert Assets di bagian bawah.

Setelah konversi selesai, tampilan material contoh akan kembali normal.

Masalah umum

Jika konfigurasi tidak benar, saat runtime tidak akan ada tampilan kamera, seringkali ditampilkan sebagai layar hitam, tetapi saat melacak target, konten yang ditambahkan di bawah target pelacakan akan ditampilkan dengan normal.

Di versi 4000 dan lebih tinggi, session akan masuk ke status Broken, di mana tampilan atau log akan menampilkan BrokenReason sebagai URP RenderPipeLineAsset not properly setup:

Untuk menyelesaikan masalah ini, konfigurasikan Universal Render Pipeline Asset dengan benar seperti yang dijelaskan dalam dokumen ini.

Topik terkait

• Kompabilitas Unity