Kompatibilitas Unity
Dokumen ini menjelaskan versi Unity yang kompatibel dengan EasyAR Sense Unity Plugin dan persyaratan konfigurasi.
Versi Unity
EasyAR Sense Unity Plugin mendukung Unity 2021.3 atau versi yang lebih baru.
Paket dukungan EasyAR Mega yang diperlukan untuk mengembangkan fitur Mega mendukung Unity 2021.3.30 atau versi yang lebih baru.
Kiat
Biasanya, 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 | 7 ke atas (7/8.1/10/11) | x86, x86_64 | Versi Windows N/KN perlu menginstal Media Feature Pack untuk dapat digunakan |
| macOS | 11.0 ke atas | x86_64, arm64 |
Selain itu, perlu memenuhi persyaratan sistem pengembangan Unity untuk versi yang sesuai.
Platform Publikasi
| Sistem Operasi | Versi Sistem Operasi | Arsitektur CPU | Keterangan Tambahan |
|---|---|---|---|
| Windows | 7 ke atas (7/8.1/10/11) | x86, x86_64 | Versi Windows N/KN perlu menginstal Media Feature Pack untuk dapat digunakan. Tidak mendukung fitur rekaman layar EasyAR. |
| macOS | 11.0 ke atas | x86_64, arm64 | Tidak mendukung fitur rekaman layar EasyAR. |
| Android | 5.0 ke atas | armv7a, arm64-v8a | Dukungan arm64-v8a memerlukan pengaktifan IL2CPP. Fitur rekaman layar EasyAR hanya mendukung penggunaan ketika Graphics API adalah OpenGLES2 atau OpenGLES3. |
| Hongmeng (ponsel) | Mendukung secara asli versi 1.0 – 4.x Versi 5 ke atas didukung melalui lapisan kompatibilitas aplikasi Android1 |
arm64-v8a | |
| iOS | 15.0 ke atas | arm64 | Arsitektur harus dikonfigurasi sebagai ARM64, tidak mendukung konfigurasi Universal. Tidak mendukung fitur rekaman layar EasyAR. |
| visionOS | 2.0 ke atas | arm64 | Tidak mendukung fitur rekaman layar EasyAR. |
Selain itu, perlu memenuhi persyaratan platform publikasi Unity untuk versi yang sesuai:
Keterangan Tambahan untuk Platform macOS
Apple silicon
EasyAR Sense Unity Plugin mulai versi 4.6.0 mendukung menjalankan secara asli di perangkat Apple silicon dan dapat digunakan dengan normal di editor Unity.
Catatan
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发现应用在 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.
Keterangan Tambahan untuk Platform Android
Dukungan Ukuran Halaman Memori 16 KB di Android
EasyAR Sense Unity Plugin mulai versi 4000 mendukung perangkat dengan ukuran halaman memori 16 KB.
Kiat
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.
Peringatan Google Play bahwa libhuawei_arengine_jni.so mungkin menyebabkan aplikasi crash di perangkat 16 KB
Dalam konfigurasi default, EasyAR Sense Unity Plugin akan menggunakan AR Engine SDK 3.7.0.3 (termasuk libhuawei_arengine_jni.so) di platform Android untuk mendukung Huawei AR Engine. Karena pustaka ini dikompilasi oleh Huawei menggunakan Android NDK versi awal, Google Play mungkin mengeluarkan peringatan, tetapi ini tidak akan menyebabkan dampak nyata.
Your app could crash on 16 KB devices
base/lib/arm64-v8a/libhuawei_arengine_jni.so
Tentang AR Engine SDK:
- Versi 3.7.0.3 dikompilasi oleh Huawei menggunakan Android NDK versi awal, inilah sebabnya Google Play mengeluarkan peringatan. Lihat penjelasan di dokumentasi Google tentang Mengompilasi Aplikasi dengan Android NDK r27 dan Lebih Rendah.
- Versi 3.7.0.3 mendukung pemuatan di perangkat Android dengan ukuran halaman memori 16 KB, inilah sebabnya Google Play tidak melarang publikasi aplikasi.
- Versi 4.0.0.5 tidak mendukung pemuatan di perangkat Android dengan ukuran halaman memori 16 KB, ini adalah versi terbaru yang tersedia secara publik untuk AR Engine SDK di ekosistem Android, oleh karena itu EasyAR Sense Unity Plugin masih menggunakan versi 3.7.0.3.
Penggunaan AR Engine SDK 3.7.0.3 oleh EasyAR Sense Unity Plugin tidak mempengaruhi publikasi aplikasi di Google Play dan tidak akan menyebabkan crash:
- Semua perangkat Huawei bukan perangkat Android 16 KB.
- EasyAR Sense menggunakan mekanisme daftar putih untuk menghindari menjalankan AR Engine SDK di perangkat non-Huawei.
Cara menangani peringatan ini:
Jika perlu menggunakan fitur AR Engine di perangkat Huawei, disarankan untuk mengabaikan peringatan ini.
Jika tidak perlu mendukung perangkat Huawei atau tidak perlu menggunakan fitur AR Engine, dapat menonaktifkan AR Engine SDK di Konfigurasi EasyAR.
Catatan
Di perangkat Huawei, bahkan jika AR Engine dinonaktifkan, fitur lain EasyAR masih dapat bekerja dengan normal, tetapi efek pelacakan gerakan akan berbeda dengan AR Engine, dan fitur lain yang menggunakan pelacakan gerakan juga akan terpengaruh.
Keterangan Tambahan untuk Platform Hongmeng
Sistem Hongmeng yang Kompatibel dengan Android
EasyAR Sense Unity Plugin sepenuhnya mendukung Hongmeng 1.0 – 4.x.
Hongmeng Asli/Hongmeng Murni/HarmonyOS NEXT
EasyAR Sense Unity Plugin akan segera mendukung Hongmeng asli 5.0+, versi saat ini belum mendukung Hongmeng asli/Hongmeng murni, hanya dapat digunakan melalui lapisan kompatibilitas aplikasi Android.
Kiat
Versi internasional Unity tidak mendukung Hongmeng asli, perlu menggunakan Tuanjie Engine.
WebGL
EasyAR Sense Unity Plugin tidak mendukung WebGL di Unity.
Kiat
Fitur yang dikembangkan dengan langsung menggunakan antarmuka layanan cloud EasyAR (seperti Antarmuka Layanan CRS) dapat dipublikasikan ke platform Web.
Graphics API
EasyAR Sense Unity Plugin langsung menggunakan pipeline rendering Unity, semua API grafis yang dapat digunakan di Unity juga dapat 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遇到异常情形, dapat mencoba menggunakan Mode Kompatibilitas URP yang disediakan oleh Unity.
Beberapa masalah telah terpecahkan di versi terbaru Unity, disarankan menggunakan versi 6.2 ke atas.
Masalah yang diketahui di luar mode kompatibilitas meliputi:
[Belum terpecahkan] Ketika mengambil tekstur kamera dari EasyAR (seperti penggunaan di contoh ImageTracking_Coloring3D dan 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 Penyelesaian Parsial, yang secara default diaktifkan.
Untuk versi Unity 6.2 ke atas, dapat mengatur Render Scale di Universal Render Pipeline Asset ke nilai selain 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 adegan menjadi tidak dapat diprediksi. Di versi Unity 6.0 - 6.1, EasyAR menyediakan Opsi Penyelesaian yang secara default diaktifkan.
-
Versi saat ini belum mendukung Hongmeng asli/Hongmeng murni 5.0.↩