Table of Contents

Pesan UI

Ada tiga jenis pesan saat EasyAR Sense Unity Plugin berjalan.

  • Exception runtime, termasuk Sense Error, Session Error, Error, dan Warning
  • Session Dump
  • Exception khusus pengembangan EasyAR Mega

Anda dapat menyesuaikan cara output untuk dua jenis pesan pertama sesuai kebutuhan. Ini dapat dikonfigurasi di editor melalui komponen DiagnosticsController pada session, atau dikonfigurasi dalam skrip menggunakan antarmuka DiagnosticsController.MessageOutput.

diagnostics ui messages

Kiat

Pada versi 4000, jika scene dibuat dengan plugin versi lama, DiagnosticsController akan otomatis ditambahkan ke session saat scene dibuka. Pada sebagian versi Unity, komponen ini mungkin tidak ditambahkan otomatis; pada versi Unity tersebut, DiagnosticsController akan dibuat otomatis saat runtime dengan nilai default.

Exception runtime

Saat plugin berjalan, terkadang beberapa masalah yang ditemukan komponen internal akan muncul di sistem sebagai pesan. Sebagian pesan mungkin merupakan kegagalan serius sehingga penggunaan tidak dapat dilanjutkan, sebagian mungkin sengaja dipicu, dan sebagian mungkin karena perangkat tidak didukung. Berdasarkan tingkat keparahan dari tinggi ke rendah, pesan dibagi menjadi beberapa kategori berikut:

  • SenseError: error EasyAR Sense, biasanya terkait dengan license EasyAR Sense.
  • SessionError: error ARSession, biasanya terkait dengan perangkat yang tidak mendukung beberapa fungsi atau konfigurasi yang salah.
  • Error: informasi error lainnya
  • Warning: informasi peringatan

Karena kekhususan pengembangan Unity, secara default pesan-pesan ini akan ditampilkan di UI untuk membantu pengembangan.

Anda dapat mengontrol cara pesan ini ditampilkan di editor atau skrip. Mode output yang dapat dipilih adalah sebagai berikut:

  • UIAndLog: output ke UI dan log. Pada headset, ditampilkan 5 meter di depan mata.
  • Log: output ke log sistem.
Kiat
  • Disarankan menggunakan konfigurasi default UIAndLog pada tahap pengembangan dan pengujian.
  • Disarankan mengubah opsi menjadi Log saat rilis. Anda juga dapat mempertahankan UIAndLog, tetapi pesan UI ini biasanya tidak ramah bagi pengguna akhir.
  • Disarankan untuk memeriksa ketersediaan session dan dukungan perangkat sebelum menjalankan, lalu memberikan petunjuk yang wajar untuk perangkat yang tidak didukung.

Sense Error

Sense Error adalah jenis error khusus. Saat error ini terjadi, fungsi EasyAR tidak dapat terus digunakan. Penyebab umum:

  • License tidak dikonfigurasi dengan benar atau verifikasi gagal. Error ini dapat dipulihkan dengan menginisialisasi ulang menggunakan license yang benar.
  • Pada sebagian perangkat, termasuk AR Foundation, AR Engine, semua perangkat yang menggunakan kamera kustom, atau berbagai headset, penggunaan produk uji coba seperti license Personal Edition, XR license uji coba, atau layanan Mega uji coba melebihi waktu terbatas yang ditetapkan. Error ini tidak dapat dipulihkan.

Session Error

Session Error adalah error yang membuat ARSession saat ini tidak dapat terus bekerja. Mengubah konfigurasi dan menjalankan ulang ARSession mungkin dapat menyelesaikan error ini. Error ini umumnya disebabkan oleh konfigurasi yang salah, exception yang dilempar selama alur startup sehingga perakitan terputus, perangkat tidak didukung oleh konfigurasi ARSession saat ini, atau komponen ARSession hilang saat runtime.

Situasi umum meliputi:

  • Error perakitan Session: misalnya perangkat tidak didukung, atau Frame Source untuk perangkat yang didukung tidak dikonfigurasi dengan benar di ARSession.
  • Error startup Session: informasi konfigurasi cloud service salah sehingga pembuatan fungsi cloud service gagal, atau informasi konfigurasi belum diisi, termasuk layanan Mega, layanan cloud recognition, layanan SpatialMap, dan sebagainya.
  • Error saat Session berjalan: komponen ARSession dihancurkan dari luar, RendererFeature tidak dikonfigurasi dengan benar di lingkungan URP, dan sebagainya.

Secara umum, error konfigurasi dan exception dalam alur startup yang menyebabkan perakitan terputus sebaiknya dihindari selama pengembangan. Kondisi perangkat tidak didukung terutama muncul pada fungsi yang memerlukan kemampuan motion tracking. Lihat Motion tracking dan fungsi EasyAR untuk memahami fungsi mana yang perlu memperhatikan dukungan perangkat, dan pilih perangkat yang sesuai untuk debugging pada tahap pengembangan.

Session Dump

Pesan SessionDump menampilkan status operasi ARSession yang dikumpulkan saat plugin berjalan, termasuk beberapa status penting dari tiap komponen. Informasi status ini sangat membantu untuk memahami operasi EasyAR dan menganalisis masalah.

Anda dapat mengontrol cara status ini ditampilkan di editor atau skrip. Mode output yang dapat dipilih adalah sebagai berikut:

  • UI: ditampilkan di UI dan diperbarui setiap frame. Pada headset, ditampilkan 5 meter di depan mata.
  • Log: output ke log sistem. Karena output dilakukan setiap frame, ini memengaruhi performa runtime, sehingga disarankan hanya digunakan saat pengembangan atau pengujian.
  • None: tidak ada output.
Kiat
  • Disarankan menggunakan konfigurasi default UI pada tahap pengembangan dan pengujian. Informasi yang ditampilkan di atas sangat diperlukan saat berkomunikasi dengan staf EasyAR.
  • Disarankan mengubahnya menjadi None setelah resmi online, dan tetap menyimpan switch perangkat lunak untuk mengaktifkan UI, atau mengumpulkan data melalui sistem lain. Saat Anda melaporkan masalah kepada EasyAR, EasyAR akan meminta informasi ini dari Anda atau pengguna Anda untuk menilai status operasi aplikasi.
  • Pada sebagian besar kasus, jika aplikasi mengalami masalah setelah online, sisi aplikasi tetap perlu melakukan investigasi dan analisis masalah terlebih dahulu. Masalah yang dilaporkan setelah menyingkirkan masalah aplikasi dan memperoleh informasi yang cukup akan lebih mudah diselesaikan. Ada banyak SDK dan platform pihak ketiga untuk pengumpulan dan analisis log, dan disarankan digunakan sebelum online. Jika Anda tidak memiliki pengalaman atau sumber daya untuk menggunakan platform tersebut, mempertahankan switch untuk mengaktifkan UI, misalnya switch tersembunyi, agar pengguna dapat melaporkan informasi yang dilihat adalah cara yang relatif sederhana.

Exception khusus pengembangan EasyAR Mega

Dalam pengembangan Mega, ada juga jenis pesan peringatan yang tidak dapat dikontrol. Pesan ini akan ditampilkan di UI saat kondisi konfigurasi tertentu terpenuhi, dan developer tidak dapat menutupnya secara langsung.

Disarankan memperhatikan isi pesan itu sendiri, karena teksnya menjelaskan penyebab kemunculan dan metode konfigurasi. Developer perlu memahami persyaratan konfigurasi yang berbeda untuk cara penggunaan yang berbeda, lalu memilih secara wajar sesuai kemajuan pengembangan.

Pesan ini ditampilkan secara sengaja, karena dalam kondisi penggunaan tertentu fungsi-fungsi ini digunakan untuk membantu pengembangan alur konten, tetapi pada saat yang sama tidak dapat memperoleh hasil runtime yang wajar. Perhatikan agar tidak membawa pesan ini ke produksi.

Topik terkait