Konfigurasi EasyAR

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

Di sini terdapat semua konfigurasi global EasyAR Sense Unity Plugin

---

Initialize On Startup

Menginisialisasi EasyAR saat startup. Biasanya disarankan untuk membiarkan opsi ini aktif.

Jika opsi ini dimatikan, Anda perlu menginisialisasi EasyAR Sense secara manual; lihat Inisialisasi EasyAR Sense untuk caranya.

EasyAR Sense License

EasyAR Sense License related configuration.

LicenseKey

EasyAR Sense License Key. A valid license is required to use EasyAR features.

It can be left empty only when EasyAR Sense is initialized manually through the interface.

Catatan

When used on headset devices (Vision Pro, XREAL, Pico, Rokid, Meta Quest, etc.), EasyAR XR License is required.

Catatan

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

Verify When Build

Verify the license Key when building the Unity project.

When this option is enabled, the Unity project build process verifies the license Key. If the license is invalid on the build platform or does not include the package name set in Unity Player Settings, the build process will fail. If you need to use a license key configured elsewhere or need to modify the package name after the Unity build process, you can disable this option.

Lib Variants

Konfigurasi varian library EasyAR Sense.

Only Android, iOS, and visionOS platforms can be selected. Windows and Mac platforms do not support selection and always use the Full variant.

EasyAR Sense usually has multiple variants, and different variants have different features. The library variants integrated in the plugin are compared below.

Variant	EasyAR Sense variant name	Feature differences	Other notes
Normal	Community/Enterprise	Does not include screen recording, inertial navigation, or Mega Go
Full	CommunityFull/EnterpriseFull	Includes inertial navigation and Mega Go	Larger library file size
VideoRecording	CommunityR	Includes screen recording feature (Android only)

Kiat

Some variants that cannot be used in Unity are not listed, such as the iOS CommunityR variant.

Nilai default:

• EasyAR Mega support package not imported: Normal
• EasyAR Mega support package imported: Full

Konfigurasi yang direkomendasikan:

• Full: use EasyAR Mega or inertial navigation features
• Normal: pursue the smallest package size and do not use EasyAR Mega or inertial navigation support
• VideoRecording: need to use screen recording feature (Android only)

Permissions

Konfigurasi izin aplikasi. Biasanya disarankan untuk membiarkan opsi default.

Selain izin kamera, izin lainnya tidak dapat diubah; semuanya ditentukan oleh fungsi lain yang dikonfigurasi.

Permission	Bisa diubah	Kondisi aktif	Deskripsi izin
Camera	Ya		Izin kamera, diperlukan untuk memakai perangkat kamera
AndroidMicrophone	Tidak	Variant = VideoRecording	Izin mikrofon, diperlukan untuk memakai fungsi perekaman layar
Location	Tidak	Mengimpor paket dukungan Mega	Izin lokasi (fine), diperlukan untuk memakai EasyAR Mega

Unity XR

Konfigurasi terkait framework Unity XR (seperti AR Foundation).

AR Foundation Support

Sakelar dukungan AR Foundation; disarankan tetap aktif.

Dalam kasus yang sangat jarang, misalnya jika Anda perlu memakai AR Foundation 4 atau pembaruan AR Foundation menyebabkan error kompilasi, Anda dapat mematikan opsi ini, tetapi semua fungsi terkait AR Foundation di plugin akan ikut dinonaktifkan.

Catatan

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

Unity XR Auto Switch

Konfigurasi fungsi yang secara otomatis mengganti objek Unity XR (misalnya AR Foundation).

• Editor: opsi mode editor
  • Disable AR Session: jika ARSession ada, nonaktifkan ARSession AR Foundation di editor.
• Player: opsi mode runtime
  • Enable: aktifkan kontrol runtime. Perhatikan bahwa jika opsi ini dimatikan, komponen yang dinonaktifkan di mode editor tidak akan dipulihkan saat runtime.
  • Enable If Desktop: aktif di Windows/Mac.
  • Enable If Mobile AR On Startup: saat switcher dimulai, jika loader mobile AR (ARKit/ARCore) aktif, maka akan diaktifkan. Biasanya opsi ini membutuhkan Initialize XR on Startup dicentang di XR Plug-in Management.
  • Disable If Non Mobile AR Post Startup: saat switcher dimulai, jika ada loader selain mobile AR (ARKit/ARCore) tetapi tidak ada yang aktif, maka akan dinonaktifkan. Biasanya opsi ini dipakai saat Initialize XR on Startup tidak dicentang di XR Plug-in Management.
  • Restore AR Session When Disabled: saat fungsi dimatikan, pulihkan (aktifkan) semua ARSession AR Foundation yang dinonaktifkan, baik dinonaktifkan oleh EasyAR maupun tidak. Opsi ini biasanya dipakai untuk memulihkan komponen yang dinonaktifkan di editor.

Penjelasan fungsi yang lebih detail dapat dilihat di Unity XR Auto Switch.

---

Mega

Konfigurasi fungsi EasyAR Mega.

Mega Block/Landmark Support

• Versi >= 4003
• Versi 4.7 - 4002

Apakah dukungan Mega Block/Landmark diaktifkan.

Opsi ini aktif secara default setelah com.easyar.mega diimpor; jika tidak diimpor, default-nya nonaktif.

Mega Go Support

Versi >= 4003.1

Apakah dukungan lokasi di perangkat untuk Mega Go diaktifkan.

Opsi hanya baca; menampilkan apakah fungsi Mega Go tersedia dengan konfigurasi saat ini.

Jika informasi yang ditampilkan tidak sesuai kebutuhan, ubah opsi Lib Variants sesuai kebutuhan.

InertialCameraDevice Support

• Versi >= 4003
• Versi 4.7 - 4002

Opsi hanya baca; menampilkan apakah fungsi inersial tersedia dengan konfigurasi saat ini.

Jika informasi yang ditampilkan tidak sesuai kebutuhan, ubah opsi Lib Variants sesuai kebutuhan.

ONNX Rumtime

• Versi >= 4003
• Versi 4.7 - 4002

Opsi hanya baca; menampilkan informasi runtime ONNX dengan konfigurasi saat ini.

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

Mega Block > Localization Service Access [Global]

Konfigurasi global server lokalisasi Mega Block.

Mega Landmark > Localization Service Access [Global]

Konfigurasi global server lokalisasi Mega Landmark.

Spatial Map

Konfigurasi fungsi spatial map EasyAR.

Service Access [Global]

Konfigurasi global server sparse map.

Image Tracking

Konfigurasi fungsi image tracking EasyAR.

Target Gizmo

Konfigurasi Gizmo ImageTarget di editor.

Mengaktifkan opsi ini akan menampilkan Gizmo yang sesuai di Unity Editor. Jika target jenis ini terlalu banyak di scene, performa startup editor bisa terpengaruh. Performa saat berjalan di perangkat tidak akan terpengaruh.

• Enable Image File: aktifkan Gizmo untuk target dengan tipe ImageTargetController.Source ImageTargetController.ImageFileSourceData.
• Enable Target Data File: aktifkan Gizmo untuk target dengan tipe ImageTargetController.Source ImageTargetController.TargetDataFileSourceData.
• Enable Target: aktifkan Gizmo untuk target dengan tipe ImageTargetController.Source ImageTargetController.TargetSourceData.
• Enable Texture 2D: aktifkan Gizmo untuk target dengan tipe ImageTargetController.Source ImageTargetController.Texture2DSourceData.

Cloud Recognition (CRS) > Service Access [Global]

Konfigurasi global server cloud recognition.

Object Tracking

Konfigurasi fungsi object tracking EasyAR.

Target Gizmo

Konfigurasi Gizmo ObjectTarget di editor.

• Enable: aktifkan Gizmo.

---

Third-Party Libraries

Konfigurasi library pihak ketiga.

ARCore SDK

Konfigurasi ARCore SDK.

ARCore menyediakan kemampuan motion tracking pada sebagian perangkat Android. Anda dapat membaca motion tracking dan fitur EasyAR untuk memahami hubungan antara fitur EasyAR dan motion tracking, serta apakah dan kapan ARCore perlu digunakan.

• AR Foundation Or Optional: ARCore SDK yang didistribusikan bersama EasyAR atau AR Foundation akan disertakan dalam aplikasi, bergantung pada pengaturan ARCore XR Plugin. Opsi ini umumnya direkomendasikan dan akan menangani kasus AR Foundation secara otomatis.
• Optional: fitur ARCore dapat digunakan pada perangkat yang mendukung ARCore dan telah menginstal Google Play Services for AR.
• Required: aplikasi hanya dapat berjalan pada perangkat yang mendukung ARCore dan telah menginstal Google Play Services for AR.
• External: gunakan opsi ini jika sedang menggunakan distribusi AR Foundation atau ARCore SDK lain. ARCore SDK yang didistribusikan bersama EasyAR tidak akan digunakan. Opsi ini juga dapat digunakan untuk sepenuhnya mengecualikan penggunaan ARCore SDK dalam aplikasi.

Hati-Hati

Jika ARCore SDK diatur ke Required, atau Requirement dalam konfigurasi ARCore AR Foundation diatur ke Required, lalu aplikasi hasil packaging diinstal pada perangkat yang tidak mendukung ARCore, perangkat akan keliru melaporkan bahwa ARCore tersedia dan berjalan dengan ARCore. Ini menimbulkan kesan palsu bahwa perangkat tersebut sedang menjalankan ARCore tetapi tidak berfungsi normal, misalnya layar hitam atau kondisi abnormal lain, padahal hal tersebut salah.

Fenomena ini terjadi karena Google Play Store mencegah aplikasi yang ditandai membutuhkan ARCore diinstal pada perangkat yang tidak didukung, sehingga aplikasi tersebut selalu menganggap dirinya berjalan pada perangkat yang didukung.

Dengan konfigurasi normal, perangkat ini akan menentukan saat session assembly bahwa ARCore tidak didukung dan menggunakan fitur EasyAR.

Untuk penjelasan detail tentang Optional dan Required, serta konfigurasi lain yang diperlukan untuk merilis aplikasi di Google Play Store, lihat dokumentasi Google (China Daratan, Internasional).

Catatan

Dalam EasyAR Sense Unity Plugin, file library dan konfigurasi yang diperlukan untuk dukungan ARCore sudah ada dalam paket plugin. Namun untuk berjalan di ponsel, Google Play Services for AR tetap perlu diinstal di ponsel.

Ada tiga sumber ARCore SDK berbeda yang dapat digunakan:

• Menggunakan ARCore SDK yang didistribusikan bersama plugin

  Plugin mengintegrasikan satu versi ARCore SDK. Detailnya dapat dilihat di kompatibilitas versi ARCore dan AR Engine. Saat menggunakan wrapper ARCore EasyAR, AR Foundation tidak perlu diimpor secara terpisah.

• Menggunakan ARCore SDK dari AR Foundation

  Jika perlu menggunakan ARCore SDK dari AR Foundation, konfigurasi dapat dilakukan sesuai dokumentasi Google (China Daratan, Internasional). Dalam hal ini, opsi ARCore SDK perlu dipilih sebagai AR Foundation Or Optional atau External.

• Menggunakan ARCore SDK lain

  Jika ada plugin pihak ketiga lain atau distribusi ARCore SDK dalam project, ARCore SDK tersebut juga dapat digunakan. Dalam hal ini, opsi ARCore SDK perlu dipilih sebagai External, dan dikonfigurasi sesuai persyaratan plugin atau project terkait.

Warn 32-bit-only ARCore-enabled build

Menurut dokumentasi Google, pada perangkat arm64, aplikasi yang hanya memiliki file library armv7 tidak akan bekerja normal dengan ARCore. Saat packaging, jika ARM64 tidak dipilih, peringatan akan muncul:

Pada saat ini, ubah konfigurasi project, gunakan kompilasi IL2CPP, dan pilih dukungan ARM64.

Hati-Hati

Jika memang diperlukan, Anda dapat memilih Continue and don't warn me again, atau mematikan opsi ini. Ini akan menonaktifkan pemeriksaan saat packaging. Mematikan pemeriksaan hanya membuat prompt tidak muncul saat packaging, tetapi saat runtime pada sebagian perangkat masih mungkin terjadi kondisi abnormal, termasuk tetapi tidak terbatas pada crash atau layar hitam.

AR Engine SDK

Konfigurasi AR Engine SDK.

AR Engine menyediakan kemampuan motion tracking pada sebagian perangkat Android. Anda dapat membaca motion tracking dan fitur EasyAR untuk memahami hubungan antara fitur EasyAR dan motion tracking, serta apakah dan kapan AR Engine perlu digunakan.

• 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 fitur terkait AR Engine akan dinonaktifkan.

ONNX Runtime (Bundled)

Apakah menggunakan ONNX runtime yang dibundel.

Jika perlu menggunakan versi ONNX yang berbeda, Anda dapat memperoleh versi yang lebih baru dari sumber resmi ONNX dan mematikan opsi ini. Menggunakan ONNX hasil kompilasi sendiri yang tidak kompatibel secara biner akan menyebabkan error yang tidak diketahui.

Workaround For Unity

Solusi untuk bug atau perilaku Unity yang kurang semestinya.

GenerateXMLDoc

Menghasilkan dokumentasi XML saat script dimuat ulang agar intelliSense pada dokumentasi API dapat bekerja.

URP17RG_DX11_RuinedScene

Workaround untuk kerusakan rendering scene URP 17 Render Graph DX11. Opsi ini dinonaktifkan pada Unity 6.2 dan versi lebih baru.

URP17RG_IOS_Glitches_Partial

Sebagian menghindari Unity Issue UUM-87787.

Ringkasan masalah: ketika memperoleh tekstur kamera dari EasyAR, seperti penggunaan pada sample ImageTracking_Coloring3D dan sample ARSession workflow (CameraDevice), glitches visual dan artifacts 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). Untuk perkembangan masalah, ikuti pembaruan Unity Issue UUM-87787 dan release notes Unity mendatang.