Kompatibilitas Unity
Dokumen ini menjelaskan versi Unity dan persyaratan konfigurasi yang kompatibel dengan EasyAR Sense Unity Plugin.
Versi Unity
EasyAR Sense Unity Plugin mendukung Unity 2021.3 atau versi yang lebih tinggi.
Paket dukungan EasyAR Mega yang diperlukan untuk mengembangkan fitur Mega mendukung Unity 2021.3.30 atau versi yang lebih tinggi.
Kiat
Umumnya, EasyAR tidak bergantung pada banyak API Unity yang berubah, jadi jika Unity merilis versi baru, EasyAR Sense Unity Plugin umumnya dapat digunakan dengan normal.
EasyAR Sense Unity Plugin mulai versi 4.6.4 mendukung URP 17+ Render Graph di Unity 6.
Platform Pengembangan
| Sistem Operasi | Versi Sistem Operasi | Arsitektur CPU | Keterangan Tambahan |
|---|---|---|---|
| Windows | Versi 7 dan seterusnya (7/8.1/10/11) | x86, x86_64 | Versi Windows N/KN perlu menginstal Media Feature Pack untuk dapat digunakan |
| macOS | Versi 10.15 dan seterusnya | x86_64, arm64 |
Selain itu, perlu memenuhi persyaratan sistem pengembangan Unity untuk versi yang sesuai.
Platform Rilis
| Sistem Operasi | Versi Sistem Operasi | Arsitektur CPU | Keterangan Tambahan |
|---|---|---|---|
| Windows | Versi 7 dan seterusnya (7/8.1/10/11) | x86, x86_64 | Versi Windows N/KN perlu menginstal Media Feature Pack untuk dapat digunakan |
| macOS | Versi 10.15 dan seterusnya | x86_64, arm64 | |
| Android | Versi 5.0 dan seterusnya | armv7a, arm64-v8a | Dukungan arm64-v8a membutuhkan pengaktifan IL2CPP |
| HarmonyOS (ponsel) | Didukung secara asli versi 1.0 – 4.x Versi 5 ke atas didukung melalui lapisan kompatibilitas aplikasi Android |
arm64-v8a | |
| iOS | Versi 12.0 dan seterusnya | arm64 | Arsitektur harus dikonfigurasi sebagai ARM64, tidak mendukung konfigurasi Universal |
| visionOS | Versi 2.0 dan seterusnya | arm64 |
Selain itu, perlu memenuhi persyaratan platform rilis Unity untuk versi yang sesuai:
Keterangan Khusus:
Tentang Mac Apple silicon:
EasyAR Sense Unity Plugin mendukung berjalan secara asli di perangkat Apple silicon dan dapat digunakan dengan normal di editor Unity.
Karena bug dukungan plugin asli di Unity, di beberapa versi Unity, aplikasi yang dibangun untuk "Apple silicon" atau "Intel 64-bit + Apple silicon" mungkin tidak dapat bekerja dengan normal. Jika aplikasi tidak dapat digunakan di Mac dan menampilkan kesalahan seperti "Fail to load EasyAR library" atau "DllNotFoundException: EasyAR assembly", disarankan menggunakan versi Unity yang lebih baru atau mencari bantuan dari Unity dan komunitas Unity.
Tentang dukungan ukuran halaman memori 16 KB di Android:
EasyAR Sense Unity Plugin mulai versi 4000 mendukung perangkat dengan ukuran halaman memori 16 KB.
Ini adalah fitur yang diperkenalkan di Android 15. Untuk informasi lebih lanjut tentang fitur ini, lihat bagian dukungan ukuran halaman 16 KB di dokumentasi Android.
Tentang WebGL:
EasyAR Sense Unity Plugin tidak mendukung WebGL di Unity.
Fitur yang dikembangkan dengan langsung menggunakan antarmuka layanan cloud EasyAR (seperti antarmuka layanan CRS) dapat dirilis ke platform Web.
Tentang fitur rekam layar:
Fitur rekam layar hanya mendukung platform Android dan membutuhkan konfigurasi Graphics API sebagai OpenGLES2 atau OpenGLES3.
Graphics API
EasyAR Sense Unity Plugin langsung menggunakan pipeline rendering Unity, sehingga semua API grafis yang dapat digunakan di Unity juga didukung.
Scriptable Render Pipeline
EasyAR Sense Unity Plugin mendukung Universal Render Pipeline (URP) 7.0.0 atau versi yang lebih baru.
EasyAR Sense Unity Plugin tidak mendukung High Definition Render Pipeline (HDRP).
Catatan
Pengumuman tentang dukungan render graph URP 17+ di Unity 6
EasyAR mendukung render graph URP 17+ di Unity 6, tetapi masih ada beberapa masalah yang belum terpecahkan di Unity itu sendiri. Saat menghadapi situasi anomali, dapat mencoba menggunakan mode kompatibilitas URP yang disediakan oleh Unity.
Beberapa masalah telah terpecahkan di versi terbaru Unity, disarankan menggunakan versi 6.2 atau yang lebih tinggi.
Masalah yang diketahui di luar mode kompatibilitas meliputi:
[Belum terpecahkan] Ketika mengambil tekstur kamera dari EasyAR (seperti contoh ImageTracking_Coloring3D dan contoh alur kerja ARSession (CameraDevice)), dapat diamati gangguan visual dan artefak di perangkat iOS/Mac. Kami telah mereproduksi masalah ini di paket Unity murni dan melaporkannya ke Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Perkembangan masalah dapat diikuti melalui pembaruan Unity Issue UUM-87787 dan catatan rilis versi mendatang Unity.
Untuk semua versi Unity 6, dapat menggunakan langkah mitigasi sebagian, yang diaktifkan secara default.
Untuk versi Unity 6.2 atau yang lebih baru, dapat mengatur Render Scale di Universal Render Pipeline Asset ke nilai di luar 0.96-1.05 untuk menghindari masalah ini.
[Telah diperbaiki di Unity 6.2] Gambar kamera di Windows DX11 akan membuat efek rendering objek di dalam adegan menjadi tidak terprediksi. Di versi Unity 6.0 - 6.1, EasyAR menyediakan opsi penghindaran yang diaktifkan secara default.