Table of Contents

Konfigurasi EasyAR

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

alt text

Di sini terdapat semua konfigurasi global untuk EasyAR Sense Unity Plugin.

alt text

Initialize On Startup

Inisialisasi EasyAR saat aplikasi dimulai. Biasanya disarankan untuk membiarkan opsi ini tetap terbuka.

Jika opsi ini dinonaktifkan, Anda perlu menginisialisasi EasyAR Sense secara manual. Cara spesifiknya dapat dilihat di 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 library 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 membiarkan pengaturan default.

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

Izin Apakah bisa diubah Kondisi pengaktifan Keterangan izin
Camera Ya Izin kamera, diperlukan untuk menggunakan perangkat kamera
AndroidMicrophone Tidak Variant adalah VideoRecording Izin mikrofon, diperlukan untuk menggunakan fitur perekaman layar
Location Tidak Mengimpor paket dukungan Mega Izin (fine) lokasi, diperlukan untuk menggunakan EasyAR Mega

Unity XR

Konfigurasi terkait kerangka kerja Unity XR (seperti AR Foundation).

AR Foundation Support

Tombol dukungan AR Foundation, disarankan untuk tetap diaktifkan.

Dalam beberapa kasus khusus, misalnya ketika Anda perlu menggunakan AR Foundation 4 atau terjadi kesalahan kompilasi karena pembaruan AR Foundation, Anda dapat menonaktifkan opsi ini. Namun, semua fitur terkait AR Foundation di dalam plugin juga akan dinonaktifkan.

Catatan

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

Unity XR Auto Switch

Konfigurasi fitur untuk otomatis mengganti objek Unity XR (seperti AR Foundation).

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

Penjelasan fitur lebih detail dapat dilihat di Otomatis mengganti Unity XR.

Mega

Konfigurasi fitur EasyAR Mega.

Mega Block/Landmark Support

Apakah akan mengaktifkan dukungan Mega Block/Landmark.

Opsi ini akan aktif secara default setelah mengimpor com.easyar.mega, dan dinonaktifkan secara default jika belum diimpor.

InertialCameraDevice Support

Opsi baca-saja, menampilkan apakah fitur inersia kamera tersedia dalam konfigurasi saat ini.

Jika informasi yang ditampilkan tidak sesuai kebutuhan, Anda perlu mengubah opsi Lib Variants sesuai kebutuhan.

ONNX Support

Opsi baca-saja, menampilkan informasi runtime ONNX dalam konfigurasi saat ini.

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

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 fitur peta spasial EasyAR.

Service Access [Global]

Konfigurasi server peta jarang global.

Image Tracking

Konfigurasi fitur pelacakan gambar EasyAR.

Target Gizmo

Konfigurasi Gizmos ImageTarget di editor.

Mengaktifkan opsi-opsi ini akan menampilkan gizmo yang sesuai di Unity Editor. Jika ada terlalu banyak target jenis ini di dalam scene, hal ini mungkin akan mempengaruhi performa saat memulai di editor. Performa saat berjalan di perangkat tidak akan terpengaruh.

Cloud Recognition (CRS) > Service Access [Global]

Konfigurasi server pengenalan cloud global.

Object Tracking

Konfigurasi fitur 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:

alt text

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

alt text

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 bug atau perilaku tidak wajar di 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.