Table of Contents

Mengaktifkan AR Foundation di proyek EasyAR

Jika perlu mengaktifkan dukungan AR Foundation dari EasyAR, atau menggunakan fitur lain AR Foundation, perlu menginstal dan mengonfigurasi AR Foundation dengan benar. Konten berikut menjelaskan cara menyelesaikan operasi ini.

Sebelum memulai

Kompatibilitas versi AR Foundation

EasyAR mendukung AR Foundation 5 atau versi lebih baru.

Penting

Dukungan AR Foundation diimplementasikan melalui kamera khusus.

Saat menggunakan produk percobaan (lisensi Personal, lisensi XR Trial, atau layanan Mega Trial, dll.) pada kamera kustom atau headset, EasyAR Sense akan berhenti merespons setelah 100 detik (pengguna Mega dapat menyesuaikan durasi melalui EasyAR Business setelah persetujuan) setiap kali dimulai. Versi berbayar dari EasyAR Sense dan layanan EasyAR Mega berbayar tidak memiliki batasan ini.

Menginstal AR Foundation

Disarankan merujuk ke dokumentasi resmi AR Foundation untuk menginstal AR Foundation. Sebelum membaca, perhatikan untuk memilih versi dokumen yang sesuai.

Unity 2022 dan versi lebih baru

Jika plugin XR belum diinstal di proyek, perlu pergi ke Project Settings > XR Plug-in Management, klik tombol Install XR Plugin Management untuk menginstal XR Plug-in Management dan tunggu hingga instalasi selesai.

alt text

Jika perlu menggunakan AR Foundation di platform Android, centang Google ARCore di tab Android dan tunggu hingga instalasi selesai.

alt text

Jika perlu menggunakan AR Foundation di platform iOS, centang Apple ARKit di tab iOS dan tunggu hingga instalasi selesai.

alt text

Jika perlu menggunakan AR Foundation di platform visionOS, perlu membaca Konfigurasi proyek Vision Pro.

Kiat

Disarankan untuk menjaga Initialize XR On Startup tetap dicentang, untuk memastikan AR Foundation dapat diinisialisasi pada titik waktu default.

Setelah instalasi selesai, buka jendela Package Manager, dapat dilihat AR Foundation serta plugin untuk platform yang sesuai akan muncul dalam daftar paket yang diinstal. Perhatikan bahwa nomor versi paket-paket ini harus sama persis.

alt text

Penting

Saat menginstal dan memperbarui AR Foundation, perlu memastikan versi Google ARCore XR Plugin dan Apple ARKit XR Plugin sama persis dengan versi AR Foundation. Versi yang tidak cocok dapat menyebabkan kesalahan runtime atau fungsi tidak normal.

Unity 2021

Di versi Unity 2021, perlu mengedit file Packages/manifest.json secara manual untuk menentukan versi, merujuk ke dokumentasi resmi.

Misalnya, jika perlu menginstal versi AR Foundation 5.2.0 dan menggunakannya di platform Android dan iOS, pastikan file Packages/manifest.json berisi konten berikut:

{
  "dependencies": {
    ...
    "com.unity.xr.arcore": "5.2.0",
    "com.unity.xr.arfoundation": "5.2.0",
    "com.unity.xr.arkit": "5.2.0",
    ...
  }
}

Mengonfigurasi XR Plug-in

Saat menggunakan EasyAR, keberadaan ARCore biasanya tidak wajib. Oleh karena itu, ARCore harus dikonfigurasi sebagai opsional, untuk menghindari aplikasi tidak berjalan normal di perangkat yang tidak mendukung ARCore.

Di Project Settings > XR Plug-in Management > ARCore, atur Requirement dan Depth menjadi Optional

alt text

Hati-Hati

Jika mengatur Requirement menjadi Required, dan menginstal aplikasi yang dibangun di perangkat yang tidak mendukung ARCore, perangkat akan secara keliru melaporkan bahwa ARCore tersedia dan berjalan dengan ARCore. Ini akan menciptakan ilusi bahwa perangkat ini menjalankan ARCore dan berjalan tidak normal (layar hitam atau situasi tidak normal lainnya), tetapi ini salah.

Alasan fenomena ini adalah karena Google Play Store memblokir instalasi aplikasi yang menandai ARCore sebagai wajib di perangkat yang tidak didukung, sehingga aplikasi ini selalu berasumsi bahwa mereka berjalan di perangkat yang didukung.

Dalam konfigurasi normal, perangkat ini akan menilai ARCore tidak didukung saat perakitan sesi dan menggunakan fungsionalitas EasyAR.

Jika perlu, juga dapat merujuk ke dokumentasi resmi berikut untuk mengonfigurasi ARCore dan ARKit lebih lanjut. Sebelum membaca, perhatikan untuk memilih versi dokumen yang sesuai.

Mengonfigurasi Universal Render Pipeline

Jika proyek saat ini menggunakan URP, perlu mengonfigurasi aset URP. Jika tidak dikonfigurasi dengan benar, gambar latar kamera AR Foundation mungkin tidak dapat dirender dengan benar.

Pertama, pastikan telah mengonfigurasi EasyAR URP Renderer Feature dengan benar, merujuk ke Konfigurasi Universal Render Pipeline EasyAR.

Kemudian tambahkan ARBackgroundRendererFeature ke daftar Renderer Features

alt text

Sama seperti konfigurasi EasyAR URP Renderer Feature, perlu memperhatikan konfigurasi di Project Settings > Quality untuk platform yang berbeda, memastikan bahwa di semua platform yang perlu menggunakan AR Foundation, aset URP yang dikonfigurasi dengan benar dengan ARBackgroundRendererFeature digunakan.

Selain itu, juga dapat merujuk ke dokumentasi konfigurasi URP resmi AR Foundation untuk konfigurasi, sebelum membaca, perhatikan untuk memilih versi dokumen yang sesuai.

Catatan

Konfigurasi Universal Render Pipeline EasyAR masih diperlukan, sehingga dapat memastikan bahwa fungsi terkait yang menggunakan antarmuka EasyAR masih dapat dirender dengan normal di perangkat yang tidak mendukung AR Foundation.

Mengaktifkan dukungan EasyAR AR Foundation

Di Project Settings > EasyAR > Sense, pastikan opsi Unity XR > AR Foundation Support diaktifkan. Opsi ini diaktifkan secara default.

alt text

Mengubah opsi ini akan memicu kompilasi ulang skrip, perlu menunggu hingga kompilasi skrip selesai agar perubahan berlaku. Jika Unity karena alasan tertentu tidak memicu kompilasi secara normal, dapat menutup Unity, menghapus folder Library/ScriptAssemblies untuk memaksa Unity mengompilasi ulang skrip.

Kiat

Jika EasyAR tidak kompatibel dengan AR Foundation di proyek, dan tidak ada kebutuhan untuk menggunakan EasyAR dan AR Foundation secara bersamaan, dapat menonaktifkan opsi ini.

Langkah selanjutnya

Topik terkait