Konfigurasi dan penggunaan scene AR Foundation dalam proyek EasyAR
Penggunaan AR Foundation di Unity sering kali memerlukan EasyAR untuk mengatasi keterbatasan perangkat AR Foundation. Konten berikut menjelaskan cara mengkonfigurasi dan menggunakan AR Foundation dengan benar dalam scene EasyAR, serta cara mengaktifkan AR Foundation secara dinamis berdasarkan dukungan perangkat.
Sebelum memulai
- Baca Dukungan EasyAR untuk framework Unity XR untuk memahami dukungan EasyAR terhadap framework Unity XR, dan dalam situasi apa AR Foundation dapat dipertimbangkan.
- Baca Mengaktifkan AR Foundation dalam proyek EasyAR untuk mempelajari cara menginstal dan mengkonfigurasi AR Foundation dalam proyek EasyAR.
Menambahkan komponen AR Foundation
Tambahkan AR Session dan XR Origin dari AR Foundation ke scene EasyAR.
Menambahkan AR Session
Klik kanan di area kosong pada tampilan Hierarchy, lalu tambahkan ARSession Unity melalui menu XR > AR Session ke scene.
Catatan
AR Session ini berbeda dengan AR Session EasyAR, keduanya perlu ada secara bersamaan dalam scene.
Menambahkan XR Origin
Klik kanan di area kosong pada tampilan Hierarchy, lalu tambahkan XROrigin Unity melalui menu XR > XR Origin (Mobile AR) ke scene.
Catatan
XR Origin ini tumpang tindih dengan fungsionalitas XR Origin EasyAR, sehingga perlu menggunakan Unity XR Origin dan bukan XR Origin EasyAR.
Jika sebelumnya ada XR Origin EasyAR di scene, biasanya bernama XR Origin (EasyAR), pindahkan objek anak di bawahnya ke XR Origin yang baru dibuat, lalu hapus XR Origin (EasyAR).
Pada tahap ini, jika XR Origin yang baru dibuat tidak memiliki XR Origin Child di bawahnya, tambahkan secara manual.
Pada tampilan Hierarchy, pilih XR Origin dan klik kanan, lalu tambahkan XR Origin Child ke bawah XR Origin melalui menu EasyAR Sense > Origin > Origin : XR Origin Child.
Mengkonfigurasi Camera
Jika sebelumnya ada Camera untuk AR di scene, akan ditemukan kamera utama berlebih di scene. Hapus kamera aslinya.
Kemudian pilih Main Camera di bawah XR Origin, dan konfigurasi kamera sesuai petunjuk di Konfigurasi Camera.
Akhirnya, struktur scene EasyAR lengkap yang telah ditambahkan AR Foundation seharusnya mirip dengan berikut:
Hati-Hati
Jika perlu memodifikasi konfigurasi AR Foundation melalui ARCameraManager.currentConfiguration, perhatikan bahwa beberapa ponsel (seperti Xiaomi 10) memiliki masalah internal - setelah modifikasi konfigurasi, gambar tidak dapat diperoleh sehingga EasyAR tidak dapat digunakan (aplikasi memiliki latar gambar tetapi fungsionalitas EasyAR tidak merespons). Oleh karena itu, umumnya tidak disarankan untuk memodifikasi. Jika diperlukan, siapkan skenario fallback saat EasyAR tidak dapat digunakan.
Kompatibilitas perangkat dan aktivasi dinamis AR Foundation
EasyAR kompatibel dengan lebih banyak perangkat dibandingkan AR Foundation, sehingga perlu dikonfigurasi untuk memastikan aplikasi hanya mengaktifkan AR Foundation saat diperlukan, dan menonaktifkannya sepenuhnya dalam kondisi lain.
Memeriksa komponen frame source
Umumnya, session yang dibuat melalui menu EasyAR biasanya secara otomatis menambahkan ARCoreARFoundationFrameSource dan ARKitARFoundationFrameSource (kecuali untuk pelacakan gambar tertentu yang tidak memerlukan fungsionalitas SLAM).
Penting
ARCoreARFoundationFrameSource dan ARKitARFoundationFrameSource adalah frame source yang disediakan EasyAR untuk mengaktifkan fungsionalitas AR Foundation pada perangkat yang mendukungnya. Jika session di scene tidak mengandung frame source ini, fungsionalitas AR Foundation tidak dapat diaktifkan.
Jika session di scene tidak mengandung frame source ini, tambahkan secara manual melalui menu.
Untuk menjalankannya di ponsel yang tidak mendukung AR Foundation, pastikan session juga mengandung frame source selain AR Foundation. Sebuah ARSession yang khas seharusnya mirip dengan berikut,
Kiat
Urutan frame source dapat diurutkan sesuai kebutuhan aktual. Saat aplikasi berjalan, session akan memilih frame source pertama yang tersedia berdasarkan urutan transform sesuai dukungan perangkat.
Mengaktifkan AR Foundation hanya saat diperlukan
Karena implementasi dasar AR Foundation di ponsel adalah ARCore dan ARKit, yang hanya dapat digunakan pada perangkat terbatas (terutama banyak ponsel Android China tidak mendukung), umumnya disarankan untuk hanya mengaktifkan AR Foundation dan skrip fungsionalitas terkait pada perangkat yang didukung.
EasyAR dapat menyelesaikan operasi ini secara otomatis. Fitur ini dapat diaktifkan atau dinonaktifkan melalui opsi Unity XR > Unity XR Auto Switch di Project Settings > EasyAR > Sense. Penjelasan rinci dapat merujuk ke Otomatis beralih objek Unity XR.
Mempertahankan scene yang kompatibel dengan AR Foundation
Scene dengan komponen AR Foundation yang ditambahkan dengan benar dapat berfungsi normal baik saat paket AR Foundation terinstal maupun tidak.
Saat AR Foundation tidak terinstal, fungsionalitas AR Foundation dan frame source terkait tidak tersedia, dan beberapa skrip akan hilang di scene - ini adalah kondisi normal.
Kiat
Banyak sampel dapat berfungsi normal baik saat paket AR Foundation terinstal maupun tidak. Jika perlu mengaktifkan dukungan AR Foundation dalam sampel ini, cukup Aktifkan AR Foundation dalam proyek EasyAR.
Langkah selanjutnya
- Pelajari cara Otomatis beralih ke AR Foundation berdasarkan dukungan perangkat
Topik terkait
- Komponen AR terkait yang disebutkan dalam dokumen:
- AR Foundation menyediakan kemampuan pelacakan gerak pada sebagian perangkat. Tentang hubungan pelacakan gerak dan berbagai fungsionalitas EasyAR, dapat merujuk ke:
- Informasi lebih lanjut tentang konfigurasi scene AR Foundation dapat dibaca di dokumentasi resmi AR Foundation. Sebelum membaca, perhatikan versi dokumentasi yang sesuai: