Table of Contents

Ui pesan

EasyAR Sense Unity Plugin memiliki tiga jenis pesan saat runtime.

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

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

diagnostics ui messages

Kiat

Di versi 4000, jika scene dibuat dengan plugin versi lama, DiagnosticsController akan otomatis ditambahkan ke session saat scene dibuka. Di beberapa versi Unity mungkin tidak ditambahkan otomatis. Di versi Unity tersebut, DiagnosticsController akan dibuat otomatis saat runtime dengan nilai default.

Pengecualian runtime

Terkadang plugin menerima masalah yang ditemukan oleh komponen internal saat runtime, ditampilkan sebagai pesan dalam sistem. Pesan ini bisa berupa kegagalan serius yang tidak dapat dilanjutkan, yang sengaja dipicu, atau perangkat tidak didukung, dll. Diklasifikasikan berdasarkan tingkat keparahan dari tinggi ke rendah sebagai berikut:

  • SenseError: Kesalahan EasyAR Sense, biasanya terkait dengan lisensi EasyAR Sense.
  • SessionError: Kesalahan ARSession, biasanya terkait dengan perangkat yang tidak mendukung beberapa fitur atau konfigurasi yang salah.
  • Error: Informasi kesalahan lainnya
  • Warning: Informasi peringatan

Karena sifat khusus pengembangan Unity, secara default kami menampilkan pesan ini di UI untuk membantu pengembangan.

Cara tampilan pesan ini dapat dikontrol di editor atau melalui skrip. Mode output yang dapat dipilih adalah:

  • UIAndLog: Output ke UI dan log. Di headset, ditampilkan 5 meter di depan mata.
  • Log: Output ke log sistem.
Kiat
  • Disarankan menggunakan konfigurasi default UIAndLog selama fase pengembangan dan pengujian.
  • Disarankan untuk mengubah opsi menjadi Log saat rilis, atau tetap mempertahankan UIAndLog, tetapi pesan UI ini biasanya tidak ramah bagi pengguna akhir.
  • Disarankan untuk menilai ketersediaan session dan dukungan perangkat sebelum menjalankan dan memberikan petunjuk yang wajar untuk perangkat yang tidak didukung.

Sense error

Sense Error adalah jenis kesalahan khusus. Saat terjadi, fungsi EasyAR tidak dapat digunakan lagi. Penyebab umum:

  • Lisensi tidak dikonfigurasi dengan benar atau validasi gagal. Kesalahan ini dapat dipulihkan dengan menginisialisasi ulang menggunakan lisensi yang benar.
  • Penggunaan produk percobaan (lisensi Personal Edition, lisensi XR versi percobaan, atau layanan Mega versi percobaan, dll.) melebihi waktu terbatas tetap pada perangkat tertentu (termasuk semua perangkat yang menggunakan kamera kustom seperti AR Foundation, AR Engine, atau berbagai headset). Kesalahan ini tidak dapat dipulihkan.

Session error

Session Error adalah kesalahan yang membuat ARSession saat ini tidak dapat melanjutkan pekerjaan. Memodifikasi konfigurasi dan menjalankan ulang ARSession mungkin dapat menyelesaikan kesalahan ini. Kesalahan ini umumnya disebabkan oleh kesalahan konfigurasi Anda, pengecualian yang dilempar selama alur mulai yang mengganggu perakitan, perangkat tidak didukung oleh konfigurasi ARSession saat ini, atau kehilangan komponen ARSession selama runtime, dll.

Kasus umum:

  • Kesalahan perakitan Session: Misalnya perangkat tidak didukung atau Frame Source untuk perangkat yang didukung tidak dikonfigurasi dengan benar di ARSession, dll.
  • Kesalahan mulai Session: Informasi konfigurasi layanan cloud salah menyebabkan kesalahan membuat fungsi layanan cloud, atau informasi konfigurasi tidak diisi (termasuk layanan Mega, layanan pengenalan cloud, layanan SpatialMap), dll.
  • Kesalahan selama runtime Session: Komponen ARSession dihancurkan secara eksternal, RendererFeature tidak dikonfigurasi dengan benar di lingkungan URP, dll.

Secara umum, kesalahan konfigurasi dan pengecualian dalam alur mulai yang mengganggu perakitan harus dihindari selama pengembangan. Ketidakmampuan perangkat terutama muncul pada fungsi yang memerlukan kemampuan pelacakan gerak. Lihat pelacakan gerak dan fungsi EasyAR untuk mengetahui fungsi mana yang perlu diperhatikan dukungan perangkatnya, dan pilih perangkat yang sesuai untuk debug selama pengembangan.

Session dump

Pesan SessionDump menampilkan status runtime ARSession yang dikumpulkan oleh plugin selama runtime, termasuk beberapa status kunci dari berbagai komponen. Informasi status ini sangat membantu untuk memahami operasi EasyAR dan menganalisis masalah.

Cara tampilan status ini dapat dikontrol di editor atau melalui skrip. Mode output yang dapat dipilih adalah:

  • UI: Tampilkan di UI dan perbarui setiap frame. Di headset, ditampilkan 5 meter di depan mata.
  • Log: Output ke log sistem. Karena output setiap frame, ini memengaruhi kinerja runtime. Disarankan digunakan selama pengembangan atau pengujian.
  • None: Tidak ada output.
Kiat
  • Disarankan menggunakan konfigurasi default UI selama fase pengembangan dan pengujian. Informasi yang ditampilkan di sana sangat penting untuk komunikasi dengan staf EasyAR.
  • Disarankan untuk mengubahnya menjadi None setelah rilis resmi, dan pertahankan sakelar perangkat lunak untuk mengaktifkan UI, atau kumpulkan data melalui sistem lain. Saat memberikan umpan balik masalah ke EasyAR, EasyAR akan meminta informasi ini dari Anda atau pengguna Anda untuk menilai status operasi aplikasi.
  • Dalam sebagian besar kasus, ketika aplikasi bermasalah setelah rilis, sisi aplikasi masih perlu melakukan analisis dan pemecahan masalah terlebih dahulu. Masalah hanya dapat diselesaikan dengan baik setelah masalah aplikasi disingkirkan dan informasi yang cukup diperoleh sebelum memberikan umpan balik. Ada banyak SDK dan platform pihak ketiga untuk pengumpulan dan analisis log, disarankan untuk digunakan sebelum rilis. Jika Anda tidak berpengalaman atau tidak memiliki sumber daya untuk platform ini, mempertahankan sakelar untuk mengaktifkan UI (misalnya menggunakan sakelar tersembunyi) agar pengguna dapat memberikan umpan balik tentang apa yang mereka lihat akan menjadi cara yang lebih sederhana.

Pengecualian khusus pengembangan easyar mega

Dalam pengembangan Mega, ada jenis informasi peringatan lain yang tidak dapat dikontrol. Jenis informasi ini akan ditampilkan di UI ketika kondisi konfigurasi tertentu terpenuhi, dan pengembang tidak dapat menonaktifkannya secara langsung.

Disarankan untuk memperhatikan pesan itu sendiri. Teksnya menjelaskan penyebab dan metode konfigurasinya. Pengembang perlu memahami persyaratan konfigurasi yang berbeda untuk penggunaan yang berbeda dan memilih dengan wajar sesuai dengan kemajuan pengembangan.

Informasi ini sengaja ditampilkan karena, dalam kondisi penggunaan tertentu, fungsi ini membantu pengembangan alur konten, tetapi pada saat yang sama tidak dapat memperoleh hasil operasi yang wajar. Perhatikan untuk tidak merilis dengan informasi ini.

Topik terkait