Kompatibilitas Unity
Artikel ini menjelaskan versi Unity dan persyaratan konfigurasi yang didukung oleh EasyAR Sense Unity Plugin.
Versi Unity
EasyAR Sense Unity Plugin mendukung Unity 2021.3 atau lebih tinggi.
Paket dukungan EasyAR Mega yang diperlukan untuk mengembangkan fitur Mega mendukung Unity 2021.3.30 atau lebih tinggi.
Kiat
Secara umum, EasyAR tidak bergantung pada banyak API Unity yang sering berubah, jadi jika Unity merilis versi baru, EasyAR Sense Unity Plugin biasanya tetap dapat digunakan dengan normal.
EasyAR Sense Unity Plugin mendukung Unity 6 URP 17+ Render Graph mulai versi 4.6.4.
Platform pengembangan
| Sistem operasi | Versi OS | Arsitektur CPU | Catatan |
|---|---|---|---|
| Windows | 7 ke atas (7/8.1/10/11) | x86, x86_64 | Versi Windows N/KN perlu menginstal Media Feature Pack |
| macOS | 11.0 ke atas | x86_64, arm64 |
Selain itu, Anda perlu memenuhi persyaratan sistem pengembangan Unity untuk versi yang sesuai.
Platform rilis
| Sistem operasi | Versi OS | Arsitektur CPU | Catatan |
|---|---|---|---|
| Windows | 7 ke atas (7/8.1/10/11) | x86, x86_64 | Versi Windows N/KN perlu menginstal Media Feature Pack. Fitur perekaman layar EasyAR tidak didukung. |
| macOS | 11.0 ke atas | x86_64, arm64 | Fitur perekaman layar EasyAR tidak didukung. |
| Android | 5.0 ke atas | armv7a, arm64-v8a | Dukungan arm64-v8a memerlukan IL2CPP. Fitur perekaman layar EasyAR hanya didukung saat Graphics API adalah OpenGLES2 atau OpenGLES3. |
| HarmonyOS (ponsel) | 1.0 – 4.x dukungan native 5 ke atas melalui lapisan kompatibilitas aplikasi Android1 |
arm64-v8a | |
| iOS | 15.0 ke atas | arm64 | Architecture harus dikonfigurasi sebagai ARM64; Universal tidak didukung. Fitur perekaman layar EasyAR tidak didukung. |
| visionOS | 2.0 ke atas | arm64 | Fitur perekaman layar EasyAR tidak didukung. |
Selain itu, Anda perlu memenuhi persyaratan platform rilis Unity untuk versi yang sesuai:
Catatan tambahan untuk macOS
Apple silicon
EasyAR Sense Unity Plugin mendukung menjalankan secara native di perangkat Apple silicon mulai versi 4.6.0, dan juga dapat digunakan normal di Unity Editor.
Catatan
Karena bug dukungan plugin native di Unity, pada beberapa versi Unity, aplikasi yang dibangun untuk "Apple silicon" atau "Intel 64-bit + Apple silicon" mungkin tidak bekerja dengan benar. Jika aplikasi tidak bisa digunakan di Mac dan menampilkan error seperti "Fail to load EasyAR library" atau "DllNotFoundException: EasyAR assembly", disarankan menggunakan versi Unity yang lebih baru atau meminta bantuan Unity dan komunitas Unity.
Catatan tambahan untuk Android
Dukungan ukuran halaman memori 16 KB di Android
EasyAR Sense Unity Plugin mendukung perangkat dengan ukuran halaman memori 16 KB mulai versi 4000.
Kiat
Fitur ini diperkenalkan di Android 15. Untuk informasi lebih lanjut, lihat dokumentasi Android tentang dukungan ukuran halaman 16 KB.
Peringatan Google Play tentang libhuawei_arengine_jni.so yang dapat menyebabkan aplikasi crash di perangkat 16 KB
Dengan konfigurasi default, EasyAR Sense Unity Plugin menggunakan AR Engine SDK 3.7.0.3 (termasuk libhuawei_arengine_jni.so) di Android untuk mendukung Huawei AR Engine. Karena library ini dikompilasi Huawei dengan Android NDK lama, Google Play mungkin menampilkan peringatan, tetapi hal ini tidak benar-benar menimbulkan masalah.
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 Huawei dengan Android NDK lama, itulah sebabnya Google Play menampilkan peringatan. Lihat dokumentasi Google tentang membangun aplikasi dengan Android NDK r27 dan yang lebih lama.
- Versi 3.7.0.3 mendukung pemuatan di perangkat Android dengan ukuran halaman memori 16 KB, itulah sebabnya Google Play tidak melarang publikasi aplikasi.
- Versi 4.0.0.5 tidak mendukung pemuatan di perangkat Android dengan ukuran halaman memori 16 KB. Karena ini adalah versi terbaru yang tersedia publik di ekosistem Android, EasyAR Sense Unity Plugin tetap menggunakan versi 3.7.0.3.
Penggunaan AR Engine SDK 3.7.0.3 dengan EasyAR Sense Unity Plugin tidak mengganggu publikasi aplikasi di Google Play dan tidak akan benar-benar menyebabkan crash:
- Semua perangkat Huawei bukan perangkat Android 16 KB.
- EasyAR Sense menggunakan mekanisme whitelist agar AR Engine SDK tidak berjalan pada perangkat non-Huawei.
Cara menangani peringatan ini:
Jika Anda perlu menggunakan fitur AR Engine di perangkat Huawei, disarankan untuk mengabaikan peringatan ini.
Jika Anda tidak perlu mendukung perangkat Huawei atau bisa tidak menggunakan fitur AR Engine, Anda dapat menonaktifkan AR Engine SDK di Konfigurasi EasyAR.
Catatan
Pada perangkat Huawei, meskipun AR Engine dinonaktifkan, fitur EasyAR lainnya tetap berjalan normal, tetapi hasil pelacakan gerak akan berbeda dengan AR Engine, dan fitur lain yang menggunakan pelacakan gerak juga akan terpengaruh.
Catatan tambahan untuk HarmonyOS
Sistem Harmony yang kompatibel dengan Android
EasyAR Sense Unity Plugin sepenuhnya mendukung HarmonyOS 1.0 – 4.x.
HarmonyOS native / HarmonyOS murni / HarmonyOS NEXT
EasyAR Sense Unity Plugin akan segera mendukung HarmonyOS native 5.0+; versi saat ini belum mendukungnya dan hanya dapat digunakan melalui lapisan kompatibilitas aplikasi Android.
Kiat
Versi internasional Unity tidak mendukung HarmonyOS native; Anda perlu menggunakan Tuanjie Engine.
WebGL
EasyAR Sense Unity Plugin tidak mendukung WebGL Unity.
Kiat
Fitur yang dikembangkan langsung menggunakan antarmuka layanan cloud EasyAR (misalnya antarmuka layanan CRS) dapat dirilis ke platform Web.
Graphics API
EasyAR Sense Unity Plugin langsung menggunakan render pipeline Unity, sehingga semua Graphics API yang dapat digunakan di Unity didukung.
Scriptable Render Pipeline
EasyAR Sense Unity Plugin mendukung Universal Render Pipeline (URP) 7.0.0 atau yang lebih baru.
EasyAR Sense Unity Plugin tidak mendukung High Definition Render Pipeline (HDRP).
Catatan
Pernyataan tentang dukungan Unity 6 URP 17+ render graph
EasyAR mendukung Unity 6 URP 17+ render graph, tetapi Unity sendiri masih memiliki beberapa masalah yang belum terselesaikan. Saat menghadapi situasi yang tidak normal, Anda bisa mencoba mode kompatibilitas URP yang disediakan Unity.
Beberapa masalah sudah diperbaiki pada versi Unity terbaru, jadi disarankan menggunakan 6.2 atau lebih tinggi.
Masalah yang diketahui pada mode non-kompatibel meliputi:
[Belum terpecahkan] Saat mengambil tekstur kamera dari EasyAR (seperti pada contoh ImageTracking_Coloring3D dan contoh ARSession workflow (CameraDevice)), pada perangkat iOS/Mac dapat terlihat gangguan visual dan artefak. Kami telah mereproduksi masalah ini pada package Unity murni dan melaporkannya ke Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Anda bisa mengikuti perkembangannya melalui Unity Issue UUM-87787 dan catatan rilis Unity berikutnya.
Untuk semua versi Unity 6, Anda bisa menggunakan langkah mitigasi parsial, yang diaktifkan secara default.
Untuk Unity 6.2 dan yang lebih baru, Anda bisa mengatur Render Scale pada Universal Render Pipeline Asset ke nilai selain 0.96-1.05 untuk menghindari masalah ini.
[Diperbaiki di Unity 6.2] Pada Windows DX11, tampilan kamera dapat membuat hasil render objek di scene menjadi tidak dapat diprediksi. Di Unity 6.0 - 6.1, EasyAR menyediakan opsi mitigasi yang diaktifkan secara default.
-
Versi saat ini belum mendukung HarmonyOS native / HarmonyOS murni 5.0.↩