Pengaturan Player

Artikel ini menjelaskan pengaturan Player yang perlu diperhatikan saat membangun aplikasi dengan EasyAR Sense Unity Plugin di Unity.

Catatan konfigurasi untuk platform berbeda

Saat build di Unity, Anda perlu memeriksa dan memastikan pengaturan berikut.

Di menu Unity File -> Build Settings-> Player Settings, klik ikon Android untuk membuka pengaturan platform Android.

switchtoandroid

Biasanya opsi berikut perlu diatur.

Package Name Atur Package Name aplikasi Android. Perhatikan bahwa Package Name harus sama dengan yang diisi saat membuat License Key.
Minimum API Level Minimum API level yang didukung EasyAR bergantung pada variant yang digunakan. Saat menggunakan variant Full, diperlukan Android API Level 24 atau lebih tinggi; saat menggunakan variant lain, EasyAR Sense memerlukan Android API Level 21 atau lebih tinggi.

Kiat

Variant Full biasanya digunakan untuk fitur on-device localization Mega Go dan fitur 5DoF camera. Saat menggunakan Mega cloud localization service, dukungan 5DoF camera juga diaktifkan secara default.

Variant EasyAR Sense yang digunakan platform target dapat dilihat di menu Project Settings > EasyAR > Sense pada opsi Lib Variants.
Target Architecture Jika Anda perlu menggunakan Google ARCore atau melakukan compile untuk ARM64 karena alasan lain, Anda perlu menggunakan IL2CPP dan memilih ARM64 support. Jika dukungan arsitektur ARM64 tidak diperlukan, tidak perlu konfigurasi.
Konfigurasi khusus untuk video recording

Jika ingin menggunakan video recording, set Graphics API ke OpenGLES3 atau OpenGLES2, lalu hilangkan centang Multithreaded Rendering. Anda juga perlu mengatur Lib Variants > Android menjadi VideoRecording di pengaturan EasyAR.

Di menu Unity File -> Build Settings-> Player Settings, klik iOS untuk membuka panel pengaturan platform iOS.

switchtoios

Biasanya opsi berikut perlu diatur.

Bundle ID

Atur Bundle ID aplikasi iOS. Perhatikan bahwa Bundle ID harus sama dengan yang diisi saat membuat License Key.
Target Architecture

Di Player Settings, ubah architecture menjadi ARM64; Universal tidak dapat digunakan.
Konfigurasi Usage Description

Bergantung pada apakah permission diaktifkan di EasyAR settings pada Permissions, Usage Description yang berbeda harus dikonfigurasi.
- Jika permission Camera diaktifkan, Anda perlu menambahkan Camera Usage Description, jika tidak build akan gagal.
- Jika permission Location diaktifkan, Anda perlu menambahkan Location Usage Description, jika tidak build akan gagal.
Konfigurasi tambahan untuk EIF recording (project XCode, jika diperlukan)

Jika Anda perlu merekam EIF ke direktori default dan mengirimkannya ke komputer atau device lain melalui aplikasi Files iOS, Anda perlu menambahkan UIFileSharingEnabled ke Info.plist dan mengatur nilainya menjadi true.

Berikut adalah beberapa error umum dan solusi terkait Player settings.

Error License Key

Jika ada exception pada License Key (misalnya Package Name tidak cocok), pesan seperti is not a valid EasyAR Sense license key or it does not match package name akan muncul saat membangun aplikasi. Jika Anda memilih untuk tetap melanjutkan build pada saat itu, aplikasi hasil build tidak akan berjalan dengan benar. Periksa prompt pada jendela dengan saksama dan perbaiki masalah sebelum build ulang.
Menonaktifkan pemeriksaan lisensi saat build

Dalam beberapa kasus khusus, jika Anda menginisialisasi secara manual menggunakan API EasyAR dan tidak menggunakan License Key di file Setttings, Anda dapat memilih Continue and don't warn me again, atau menonaktifkan opsi EasyAR Sense License > Verify When Build di pengaturan EasyAR. Ini akan mematikan pemeriksaan saat build.
Dukungan device Android untuk arsitektur non-ARM

EasyAR Sense tidak secara langsung mendukung sistem Android x86 dan x86-64, tetapi chip device berbasis arsitektur x86 biasanya dapat menjalankan program ARM secara kompatibel. Karena itu Anda perlu menonaktifkan pilihan arsitektur x86 agar beberapa device x86 dapat berfungsi dengan benar.