Table of Contents

Menginisialisasi easyar sense menggunakan kunci lisensi

Untuk menggunakan EasyAR di Unity, perlu menginisialisasi EasyAR Sense menggunakan kunci lisensi untuk memastikan fungsionalitas diaktifkan. Ada dua cara inisialisasi: inisialisasi otomatis dan inisialisasi manual.

Setelah inisialisasi berhasil, Anda dapat melihat informasi versi EasyAR Sense dan platform operasi melalui konsol Unity atau log sistem, misalnya:

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Sebelum memulai

  • Lisensi easyar sense menjelaskan cara mendapatkan lisensi EasyAR Sense (kunci lisensi). Sebelum menginisialisasi EasyAR Sense, Anda perlu menyiapkan lisensi yang sesuai berdasarkan perangkat yang digunakan dan tahap pengembangan.

Inisialisasi otomatis

Inisialisasi otomatis cocok untuk sebagian besar skenario penggunaan.

Buka Pengaturan Global EasyAR, centang opsi Initialize On Startup, dan isi EasyAR Sense License > LicenseKey

alt text

Inisialisasi otomatis akan dipanggil secara otomatis pada titik waktu BeforeSceneLoad di Unity.

Catatan

Lisensi yang digunakan di editor tidak memverifikasi nama paket aplikasi, sehingga lisensi yang berfungsi normal di editor mungkin masih gagal saat dibangun ke aplikasi platform atau saat aplikasi berjalan. Perhatikan dua kasus berikut:

  1. Nama paket lisensi yang diisi harus sesuai dengan bundle id/package name yang diisi di Unity Player Settings.
  2. Jika setelah pembangunan Unity, nama paket diubah di proyek gradle atau XCode. Dalam hal ini, gunakan nama paket dari gradle atau XCode di Unity.

[Opsional] Inisialisasi manual

Inisialisasi manual terutama digunakan untuk alur inisialisasi yang disesuaikan, seperti menampilkan penjelasan privasi pengguna sebelum memanggil antarmuka EasyAR (lihat Panduan kepatuhan).

Buka Pengaturan Global EasyAR, hapus centang pada opsi Initialize On Startup.

alt text

Kemudian gunakan antarmuka EasyARController.Initialize() untuk memanggil inisialisasi secara manual.

Anda dapat meneruskan lisensi melalui parameter,

EasyARController.Initialize("lisensi-saya");

Atau gunakan lisensi yang diisi di Pengaturan Global EasyAR,

EasyARController.Initialize();
Penting

EasyARController.Initialize() harus dipanggil sebelum ARSession dimulai.

Dalam beberapa kasus khusus, jika Anda perlu memanggil EasyARController.Initialize() beberapa kali, pastikan untuk melakukan deinisialisasi melalui EasyARController.Deinitialize() setelah setiap eksekusi EasyARController.Initialize().

Penyelesaian masalah inisialisasi gagal

Setelah menjalankan adegan yang berisi ARSession, jika log tidak berisi informasi serupa, berarti inisialisasi gagal.

EasyAR Sense (Android-arm64) Version 4.7.0.11800-cf8e24e30

Di editor Unity, Anda mungkin juga melihat jendela sembul seperti ini

alt text

Catatan

Perhatikan untuk membaca pesan teks yang ditampilkan di jendela sembul, tidak semua jendela sembul berarti inisialisasi gagal.

Pesan kesalahan dan penyebab umum adalah sebagai berikut:

  • EasyARSettings tidak ditemukan
    • File sumber daya Pengaturan Global EasyAR tidak dibuat (biasanya terjadi saat lisensi tidak diisi)
  • License Key kosong
    • Lisensi tidak diisi di Pengaturan Global EasyAR, atau ada beberapa file sumber daya Pengaturan Global EasyAR di proyek
  • EasyARController.Initialize tidak dipanggil (InitializeOnStartup = false)
    • Inisialisasi manual tidak dipanggil pada waktu yang tepat
  • EasyAR berhenti setelah perubahan skrip dalam mode play
    • Saat dijalankan di editor, skrip mengalami perubahan. Dalam hal ini, jalankan ulang saja

Topik terkait