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 biasanya memiliki berbagai macam varian, dan fungsinya berbeda-beda antar varian. Berikut ini adalah perbandingan varian pustaka yang terintegrasi dalam plugin.

Variant Nama varian EasyAR Sense Perbedaan fungsi Khusus lainnya
Normal Community/Enterprise Tidak termasuk rekaman layar dan navigasi inersia
Full CommunityFull/EnterpriseFull Termasuk navigasi inersia dan beberapa fitur Mega lainnya Ukuran file pustaka besar
VideoRecording CommunityR Termasuk fitur rekaman layar (hanya Android)
Kiat

Beberapa varian yang tidak dapat digunakan di Unity tidak dimasukkan, seperti varian CommunityR untuk iOS.

Nilai bawaan:

  • Jika paket dukungan EasyAR Mega belum diimpor: Normal
  • Jika paket dukungan EasyAR Mega telah diimpor: Full

Konfigurasi rekomendasi:

  • Full ：Menggunakan EasyAR Mega atau menggunakan fitur navigasi inersia
  • Normal ：Berusaha mencapai ukuran paket terkecil, dan tidak menggunakan dukungan EasyAR Mega atau navigasi inersia
  • VideoRecording ：Membutuhkan fitur rekaman layar (hanya untuk Android)

Permissions

Konfigurasi izin aplikasi. Biasanya disarankan untuk membiarkan pengaturan default.

Selain izin kamera, konfigurasi izin lainnya tidak dapat diubah dan ditentukan oleh pengaturan 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 lokasi (fine), 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 jika Anda perlu menggunakan AR Foundation 4 atau ada masalah kompilasi akibat 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 otomatisasi pengalihan objek Unity XR (seperti AR Foundation).

  • Editor ：Opsi mode pengeditan
    • Disable AR Session ：Jika ada ARSession, matikan ARSession AR Foundation saat pengeditan.
  • Player ：Opsi mode runtime
    • Enable ：Aktifkan kendali 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 ：Jika loader AR seluler (ARKit/ARCore) aktif saat pengalih dimulai, aktifkan. Biasanya opsi ini membutuhkan Initialize XR on Startup di XR Plug-in Management untuk dipilih.
    • Disable If Non Mobile AR Post Startup ：Jika ada loader selain AR seluler (ARKit/ARCore) saat pengalih dimulai, namun tidak ada loader yang aktif, nonaktifkan. Biasanya opsi ini digunakan saat Initialize XR on Startup di XR Plug-in Management tidak dipilih.
    • Restore AR Session When Disabled ：Ketika fitur dinonaktifkan, aktifkan kembali semua ARSession AR Foundation yang dinonaktifkan (baik itu dinonaktifkan oleh EasyAR atau tidak). Opsi ini biasanya digunakan untuk mengembalikan komponen yang dinonaktifkan saat pengeditan.

Penjelasan fitur lebih rinci dapat dilihat di Otomatisasi Pengalihan Unity XR.

Mega

Konfigurasi fitur EasyAR Mega.

Mega Block/Landmark Support

Apakah akan mengaktifkan dukungan Mega Block/Landmark.

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

InertialCameraDevice Support

Opsi readonly, menampilkan apakah fitur inertial navigation tersedia dalam konfigurasi saat ini.

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

ONNX Support

Opsi readonly, menampilkan informasi runtime ONNX dalam 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 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 terkait di Unity Editor. Jika ada terlalu banyak target jenis ini di scene, ini mungkin akan memengaruhi kinerja saat memulai editor. Kinerja saat dijalankan 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 Library pihak ketiga.

ARCore SDK

Konfigurasi ARCore SDK.

ARCore menyediakan kemampuan untuk melacak gerakan pada sebagian perangkat Android. Baca Melacak Gerakan dan Fitur EasyAR untuk mengetahui hubungan antara fitur EasyAR dan melacak gerakan, dan apakah dan kapan perlu menggunakan ARCore.

  • AR Foundation Or Optional: ARCore SDK yang didistribusikan bersama dengan EasyAR atau AR Foundation akan tercakup dalam aplikasi, tergantung pada pengaturan ARCore XR Plugin. Secara umum, opsi ini direkomendasikan karena akan secara otomatis menangani kasus AR Foundation.
  • 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: Jika menggunakan AR Foundation atau distribusi ARCore SDK lainnya, dapat menggunakan opsi ini. Dengan demikian, ARCore SDK yang didistribusikan bersama dengan EasyAR tidak akan digunakan. Opsi ini juga dapat digunakan untuk sepenuhnya menghilangkan penggunaan ARCore SDK dalam aplikasi.
Hati-Hati

Jika mengatur ARCore SDK menjadi Required, atau mengatur Requirement menjadi Required dalam konfigurasi ARCore dari AR Foundation, dan aplikasi yang telah dikemas diinstal pada perangkat yang tidak mendukung ARCore, perangkat akan secara salah melaporkan bahwa ARCore tersedia dan berjalan dengan ARCore. Hal ini akan menyebabkan kesalahan yang seolah-olah perangkat tersebut sedang menjalankan ARCore dan tidak berjalan normal (layar hitam atau kondisi abnormal lainnya), tetapi hal ini salah.

Alasan terjadinya fenomena ini adalah karena Google Play Store mencegah instalasi aplikasi yang menandai ARCore sebagai wajib pada perangkat yang tidak didukung, sehingga aplikasi tersebut selalu mengasumsikan bahwa mereka sedang berjalan pada perangkat yang didukung.

Dalam konfigurasi normal, perangkat ini akan menentukan bahwa ARCore tidak didukung saat menyusun sesi dan menggunakan fitur EasyAR.

Untuk penjelasan lebih lanjut mengenai Optional dan Required dan konfigurasi lainnya yang perlu dilakukan untuk aplikasi yang diunggah ke Google Play Store, dapat merujuk ke petunjuk Google ( China Mainland, Internasional ).

Catatan

Dalam EasyAR Sense Unity Plugin, berkas dan konfigurasi yang diperlukan untuk dukungan ARCore telah ada dalam paket plugin, tetapi untuk menjalankan di ponsel, masih perlu menginstal Google Play Services for AR di ponsel.

Terdapat tiga sumber ARCore SDK yang berbeda yang dapat digunakan:

  • Menggunakan ARCore SDK yang didistribusikan bersama dengan plugin

    Plugin telah mengintegrasikan satu versi ARCore SDK. Untuk informasi lebih lanjut, dapat merujuk ke Kompatibilitas Versi ARCore, AR Engine. Saat menggunakan pembungkus ARCore dari EasyAR, tidak perlu mengimpor AR Foundation secara terpisah.

  • Menggunakan ARCore SDK dari AR Foundation

    Jika perlu menggunakan ARCore SDK dari AR Foundation, dapat merujuk ke petunjuk Google ( China Mainland, Internasional ) untuk melakukan konfigurasi. Saat ini, opsi ARCore SDK perlu memilih AR Foundation Or Optional atau External.

  • Menggunakan ARCore SDK lainnya

    Jika ada plugin pihak ketiga atau distribusi ARCore SDK dalam proyek lainnya, juga dapat menggunakan ARCore SDK tersebut. Saat ini, opsi ARCore SDK perlu memilih External, dan melakukan konfigurasi sesuai dengan kebutuhan plugin atau proyek tertentu.

Warn 32-bit-only ARCore-enabled build

Menurut petunjuk Google, ketika menjalankan program yang hanya memiliki berkas armv7 di perangkat arm64, ARCore tidak akan berfungsi normal. Saat mengemas, akan muncul peringatan jika tidak memilih ARM64:

alt text

Kita perlu mengubah konfigurasi proyek, menggunakan kompilasi IL2CPP dan memilih dukungan ARM64.

alt text

Hati-Hati

Jika memang perlu, dapat memilih Continue and don't warn me again, atau menutup opsi tersebut, yang akan menutup pemeriksaan saat mengemas. Menutup pemeriksaan hanya akan menghilangkan pesan saat mengemas, tetapi saat menjalankan, pada beberapa perangkat mungkin akan muncul masalah, termasuk tetapi tidak terbatas pada kegagalan atau layar hitam.

AR Engine SDK

Konfigurasi AR Engine SDK.

AR Engine menyediakan kemampuan untuk melacak gerakan pada sebagian perangkat Android. Baca Melacak Gerakan dan Fitur EasyAR untuk mengetahui hubungan antara fitur EasyAR dan melacak gerakan, dan apakah dan kapan perlu menggunakan AR Engine.

  • AREngineInterop: AREngineInterop tersedia. AR Engine SDK yang didistribusikan bersama dengan EasyAR akan tercakup dalam aplikasi.
  • External: AREngineInterop tersedia. AR Engine SDK yang didistribusikan bersama dengan EasyAR tidak akan digunakan.
  • Disabled: AREngineInterop tidak tersedia. AR Engine SDK yang didistribusikan bersama dengan EasyAR tidak akan digunakan. Semua fitur yang berkaitan dengan AR Engine akan dinonaktifkan.

ONNX Runtime (Bundled)

Apakah akan menggunakan ONNX Runtime yang telah dibundel. Hanya berlaku jika Lib Variant adalah Full.

Jika ingin menggunakan versi ONNX yang berbeda, dapat memperoleh versi terbaru dari situs resmi ONNX dan menutup opsi ini. Menggunakan versi ONNX yang telah 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.