Konfigurasi easyar

Halaman konfigurasi EasyAR dapat diakses dari menu Unity EasyAR > Sense > Configuration atau Edit > Project Settings > EasyAR.

Ini berisi semua konfigurasi global untuk EasyAR Sense Unity Plugin

---

Initialize on startup

Inisialisasi EasyAR saat startup. Biasanya disarankan untuk menjaga opsi ini tetap aktif.

Jika menonaktifkan opsi ini, perlu menginisialisasi EasyAR Sense secara manual, metode spesifik dapat merujuk ke inisialisasi EasyAR Sense.

EasyAR Sense License

Konfigurasi terkait EasyAR Sense License.

License key

EasyAR Sense License Key. Harus diisi dengan license yang valid untuk menggunakan fungsi EasyAR.

Dapat dikosongkan hanya saat menginisialisasi EasyAR Sense secara manual melalui antarmuka.

Catatan

Saat digunakan pada perangkat headset (Vision Pro, XREAL, Pico, Rokid, dll.), diperlukan EasyAR XR License.

Catatan

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.

Verify when build

Memverifikasi license Key saat membangun proyek Unity.

Saat opsi ini diaktifkan, proses pembangunan proyek Unity akan memverifikasi license Key. Jika license tidak valid pada platform pembangunan atau tidak menyertakan nama paket yang diatur di Unity Player Settings, proses pembangunan akan gagal. Jika perlu menggunakan license key yang dikonfigurasi di tempat lain atau perlu mengubah nama paket setelah proses pembangunan Unity, opsi ini dapat dimatikan.

Lib variants

Konfigurasi varian pustaka EasyAR Sense.

EasyAR Sense License

Konfigurasi terkait EasyAR Sense License.

License key

EasyAR Sense License Key. Harus diisi dengan license yang valid untuk menggunakan fungsi EasyAR.

Dapat dikosongkan hanya saat menginisialisasi EasyAR Sense secara manual melalui antarmuka.

Catatan

Saat digunakan pada perangkat headset (Vision Pro, XREAL, Pico, Rokid, dll.), diperlukan EasyAR XR License.

Catatan

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.

Verify when build

Memverifikasi license Key saat membangun proyek Unity.

Saat opsi ini diaktifkan, proses pembangunan proyek Unity akan memverifikasi license Key. Jika license tidak valid pada platform pembangunan atau tidak menyertakan nama paket yang diatur di Unity Player Settings, proses pembangunan akan gagal. Jika perlu menggunakan license key yang dikonfigurasi di tempat lain atau perlu mengubah nama paket setelah proses pembangunan Unity, opsi ini dapat dimatikan.

Permissions

Konfigurasi izin aplikasi. Biasanya disarankan untuk mempertahankan default.

Kecuali izin kamera, konfigurasi izin lainnya tidak dapat diubah, ditentukan oleh konfigurasi fitur lainnya.

Izin	Dapat diubah	Kondisi diaktifkan	Penjelasan izin
Camera	Ya		Izin kamera, izin yang diperlukan untuk menggunakan perangkat kamera
AndroidMicrophone	Tidak	Variant adalah VideoRecording	Izin mikrofon, izin yang diperlukan untuk menggunakan fungsi perekaman layar
Location	Tidak	Mengimpor dukungan Mega	Izin lokasi (fine), izin yang diperlukan untuk menggunakan EasyAR Mega

Unity xr

Konfigurasi terkait kerangka kerja Unity XR (AR Foundation, dll.).

AR foundation support

Sakelar dukungan AR Foundation, disarankan untuk tetap aktif.

Dalam kasus yang sangat jarang, seperti perlu menggunakan AR Foundation 4 atau pembaruan AR Foundation menyebabkan kesalahan kompilasi, opsi ini dapat dinonaktifkan, tetapi semua fungsi terkait AR Foundation di dalam plugin akan dinonaktifkan secara bersamaan.

Catatan

Setelah mengubah opsi ini, skrip akan dikompilasi ulang secara otomatis.

Unity xr auto switch

Konfigurasi fungsi pengalihan otomatis objek Unity XR (seperti AR Foundation).

• Editor : opsi mode edit
  • Disable AR Session : Saat ada ARSession, nonaktifkan ARSession AR Foundation saat mengedit.
• Player : opsi mode runtime
  • Enable : Aktifkan kontrol runtime. Catatan: Jika menonaktifkan opsi ini, komponen yang dinonaktifkan di mode edit tidak akan dipulihkan saat runtime.
  • Enable If Desktop : Aktifkan di Windows/Mac.
  • Enable If Mobile AR On Startup : Saat pengalih diaktifkan, jika loader AR seluler (ARKit/ARCore) aktif, maka aktifkan. Biasanya opsi ini memerlukan Initialize XR on Startup di XR Plug-in Management dipilih.
  • Disable If Non Mobile AR Post Startup : Saat pengalih diaktifkan, jika ada loader selain AR seluler (ARKit/ARCore), tetapi tidak ada loader yang aktif, maka nonaktifkan. Biasanya opsi ini digunakan saat Initialize XR on Startup di XR Plug-in Management tidak dipilih.
  • Restore AR Session When Disabled : Saat fungsi dinonaktifkan, pulihkan (aktifkan) semua ARSession AR Foundation yang dinonaktifkan (terlepas dari apakah dinonaktifkan oleh EasyAR atau tidak). Opsi ini biasanya digunakan untuk memulihkan komponen yang dinonaktifkan saat pengeditan.

Penjelasan fungsi rinci dapat merujuk ke pengalihan otomatis Unity XR.

---

Mega

Konfigurasi fungsi EasyAR Mega.

InertialCameraDevice support

Opsi hanya-baca, menampilkan apakah fungsi inertial navigation saat ini tersedia dan informasi runtime ONNX.

Jika informasi yang ditampilkan tidak sesuai kebutuhan, perlu memodifikasi opsi Lib Variants dan ONNX Runtime (Bundled) sesuai situasi.

Mega block > Localization service access [Global]

Konfigurasi server lokalisasi Mega Block global.

Mega landmark > Localization service access [Global]

Konfigurasi server lokalisasi Mega Landmark global.

Spatial map

Konfigurasi fungsi peta spasial EasyAR.

Service access [Global]

Konfigurasi server peta jarang global.

Image tracking

Konfigurasi fungsi pelacakan gambar EasyAR.

Target gizmo

Konfigurasi Gizmos ImageTarget di editor.

Mengaktifkan opsi ini akan menampilkan gizmo yang sesuai di Unity Editor, jika ada terlalu banyak target jenis ini di scene, dapat memengaruhi kinerja startup di editor. Kinerja saat dijalankan di perangkat tidak akan terpengaruh.

• Enable Image File : Aktifkan Gizmos untuk target dengan ImageTargetController.Source bertipe ImageTargetController.ImageFileSourceData.
• Enable Target Data File : Aktifkan Gizmos untuk target dengan ImageTargetController.Source bertipe ImageTargetController.TargetDataFileSourceData.
• Enable Target : Aktifkan Gizmos untuk target dengan ImageTargetController.Source bertipe ImageTargetController.TargetSourceData.
• Enable Texture 2D : Aktifkan Gizmos untuk target dengan ImageTargetController.Source bertipe ImageTargetController.Texture2DSourceData.

Cloud recognition (CRS) > Service access [Global]

Konfigurasi server pengenalan awan global.

Object tracking

Konfigurasi fungsi pelacakan objek EasyAR.

Target gizmo

Konfigurasi Gizmos ObjectTarget di editor.

• Enable: Aktifkan Gizmos.

---

Third-party libraries

Konfigurasi pustaka pihak ketiga.

Arcore sdk konfigurasi

Konfigurasi ARCore SDK.

ARCore menyediakan kemampuan pelacakan gerak pada beberapa perangkat Android. Baca Pelacakan gerak dan fungsi EasyAR untuk memahami hubungan antara fungsi EasyAR dan pelacakan gerak, serta kapan perlu menggunakan ARCore.

• AR Foundation Or Optional: ARCore SDK yang didistribusikan bersama EasyAR atau AR Foundation akan disertakan dalam aplikasi, ditentukan oleh pengaturan ARCore XR Plugin. Secara umum, opsi ini direkomendasikan karena akan menangani kasus AR Foundation secara otomatis.
• Optional: Fungsi ARCore dapat digunakan pada perangkat yang mendukung ARCore dan telah menginstal Google Play Services for AR.
• Required: Aplikasi hanya akan berjalan di perangkat yang mendukung ARCore dan telah menginstal Google Play Services for AR.
• External: Gunakan opsi ini jika menggunakan distribusi AR Foundation atau ARCore SDK lainnya. Dengan demikian, ARCore SDK yang didistribusikan bersama EasyAR tidak akan digunakan. Opsi ini juga dapat digunakan untuk sepenuhnya mengecualikan ARCore SDK dari aplikasi.

Hati-Hati

Jika ARCore SDK disetel ke Required, atau jika dalam konfigurasi ARCore AR Foundation Requirement disetel ke Required, dan aplikasi yang dibangun diinstal pada 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 masalah lain), tetapi ini salah.

Fenomena ini terjadi karena Google Play Store memblokir instalasi aplikasi yang menandai ARCore sebagai wajib pada perangkat yang tidak didukung, sehingga aplikasi tersebut selalu menganggap mereka berjalan pada perangkat yang didukung.

Dalam konfigurasi normal, perangkat ini akan mendeteksi bahwa ARCore tidak didukung saat perakitan sesi dan menggunakan fungsi EasyAR sebagai gantinya.

Untuk penjelasan rinci tentang Optional dan Required serta konfigurasi lain yang diperlukan untuk mengunggah aplikasi ke Google Play Store, lihat dokumentasi Google (Tiongkok Daratan, Internasional).

Catatan

Di EasyAR Sense Unity Plugin, file pustaka dan konfigurasi yang diperlukan untuk dukungan ARCore sudah ada dalam paket plugin, tetapi untuk menjalankannya di ponsel, Google Play Services for AR masih perlu diinstal di ponsel.

Ada tiga sumber berbeda ARCore SDK yang dapat digunakan:

• Menggunakan ARCore SDK yang didistribusikan dengan plugin

  Plugin ini menyertakan versi ARCore SDK terintegrasi. Detailnya dapat merujuk ke Kompatibilitas versi ARCore, AR Engine. Saat menggunakan pembungkus ARCore EasyAR, tidak perlu mengimpor AR Foundation secara terpisah.

• Menggunakan ARCore SDK dari AR Foundation

  Jika perlu menggunakan ARCore SDK dari AR Foundation, lihat dokumentasi Google (Tiongkok Daratan, Internasional) untuk konfigurasi. Dalam hal ini, opsi ARCore SDK harus memilih AR Foundation Or Optional atau External.

• Menggunakan ARCore SDK lainnya

  Jika ada plugin pihak ketiga lain atau proyek yang mendistribusikan ARCore SDK, SDK tersebut juga dapat digunakan. Dalam hal ini, opsi ARCore SDK harus memilih External, dan konfigurasikan sesuai dengan persyaratan plugin atau proyek tertentu.

Peringatan build dengan ARCore hanya 32-bit

Menurut dokumentasi Google, menjalankan program yang hanya memiliki file pustaka armv7 pada perangkat arm64, ARCore tidak akan berfungsi dengan baik. Peringatan akan muncul saat membangun jika ARM64 tidak dipilih:

Dalam hal ini, perlu mengubah konfigurasi proyek, gunakan kompilasi IL2CPP dan pilih dukungan ARM64.

Hati-Hati

Jika benar-benar diperlukan, Anda dapat memilih Continue and don't warn me again, atau menonaktifkan opsi tersebut, yang akan menonaktifkan pemeriksaan saat membangun. Menonaktifkan pemeriksaan hanya menghilangkan peringatan saat membangun, tetapi saat runtime beberapa perangkat mungkin mengalami kelainan, termasuk namun tidak terbatas pada crash atau layar hitam.

Ar engine sdk konfigurasi

Konfigurasi AR Engine SDK.

AR Engine menyediakan kemampuan pelacakan gerak pada beberapa perangkat Android. Baca Pelacakan gerak dan fungsi EasyAR untuk memahami hubungan antara fungsi EasyAR dan pelacakan gerak, serta kapan perlu menggunakan AR Engine.

• AREngineInterop: AREngineInterop tersedia. AR Engine SDK yang didistribusikan bersama EasyAR akan disertakan dalam aplikasi.
• External: AREngineInterop tersedia. AR Engine SDK yang didistribusikan bersama EasyAR tidak akan digunakan.
• Disabled: AREngineInterop tidak tersedia. AR Engine SDK yang didistribusikan bersama EasyAR tidak akan digunakan. Semua fungsi terkait AR Engine akan dinonaktifkan.

Onnx runtime (bundel)

Apakah menggunakan runtime ONNX yang dibundel. Hanya berlaku jika Lib Variant adalah Full.

Jika perlu menggunakan versi ONNX yang berbeda, dapatkan versi yang diperbarui dari sumber resmi ONNX dan nonaktifkan opsi ini. Menggunakan biner ONNX yang dikompilasi sendiri dan tidak kompatibel akan menyebabkan kesalahan yang tidak diketahui.

Workaround for unity

Solusi untuk mengatasi bug atau perilaku tidak wajar Unity.

Generatexmldoc

Menghasilkan dokumen XML saat skrip dimuat ulang agar intelliSense dokumentasi API dapat berfungsi.

Urp17rg dx11 ruinedscene

Penyelesaian masalah URP 17 Render Graph DX11 penggambaran adegan yang rusak. Dinonaktifkan di Unity 6.2 dan versi lebih baru.

Urp17rg ios glitches partial

Penyelesaian masalah parsial untuk Unity Issue UUM-87787.

Deskripsi masalah: Saat memperoleh tekstur kamera dari EasyAR (seperti yang digunakan dalam contoh ImageTracking_Coloring3D dan contoh Alur Kerja ARSession (CameraDevice)), artefak visual dan glitches dapat diamati pada perangkat iOS/Mac. Kami telah mereproduksi masalah ini dalam paket Unity murni dan melaporkannya ke Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Perkembangan masalah dapat dilacak melalui pembaruan Unity Issue UUM-87787 dan catatan rilis versi Unity mendatang.