Pengumpulan data diagnostik Mega
Panduan ini menyediakan instruksi standar untuk mengumpulkan data tentang anomali visual effect. Pengumpulan data dan feedback yang terstandardisasi membantu developer menjelaskan masalah secara akurat, serta membantu tim teknis EasyAR menemukan, mereproduksi, dan menyelesaikan fault teknis terkait visual lokalisasi secara efisien.
Pengantar
Saat mengintegrasikan EasyAR Mega lokalisasi service, pengumpulan data yang akurat adalah prasyarat inti untuk diagnosis masalah. Panduan ini mencakup langkah-langkah utama berikut:
- Identifikasi masalah: Mengklasifikasikan dan melakukan penilaian awal terhadap anomali umum.
- Spesifikasi screenshot dan rekaman layar: Metode bukti visual untuk berbagai platform perangkat.
- Pengumpulan data runtime: Mengekstrak dan mengekspor data lingkungan runtime pada tiap platform.
- Standar informasi umpan balik: Memastikan "set informasi minimum" yang diperlukan tim teknis untuk mereproduksi masalah.
Klasifikasi anomali dan penilaian awal
Sebelum melaporkan masalah, gunakan klasifikasi berikut untuk memperjelas anomali:
Gejala anomali umum
- Sama sekali tidak dapat melakukan lokalisasi: Scene tidak dapat dikenali, dan status terus menampilkan "NotFound".
- Deviasi akurasi lokalisasi: Lokalisasi berhasil tetapi akurasi tidak cukup, dengan offset ruang yang jelas.
- Unstable lokalisasi: Gambar mengalami jitter atau drift, atau tracking sering hilang.
- Anomali regional: Efek lokalisasi buruk pada area tertentu atau titik tertentu.
- Perbedaan kompatibilitas perangkat: Performa buruk pada model perangkat tertentu.
Dugaan kemungkinan penyebab
- Terkait scene: Offset penempatan konten, kualitas pemetaan rendah, lighting lingkungan atau titik fitur yang jarang (seperti dinding putih luas), atau gangguan dari titik-titik yang mirip.
- Lingkungan teknis: Gangguan jaringan, tunggakan layanan, batas QPS terlampaui, kompatibilitas versi SDK, atau error logika panggilan API.
- Izin hardware: Sensor perangkat (IMU) tidak mendukung Motion Tracking, atau izin kamera/penyimpanan belum diaktifkan.
Proses umpan balik standar
Untuk meningkatkan efisiensi pemecahan masalah, kami sangat menyarankan Anda mengirim paket umpan balik lengkap yang berisi tiga bagian berikut:
Checklist informasi dasar (set informasi minimum)
- Identitas sumber daya: Informasi akun, Mega AppId, Block Id.
- Informasi versi: EasyAR Sense versi SDK atau versi plugin Mini Program.
- Detail masalah: Deskripsi detail anomali dan kondisi pemicu-nya.
- Parameter lingkungan: Model perangkat, versi OS, versi WeChat, dan lingkungan jaringan saat ini (4G/5G/WiFi).
Bukti visual (video dan screenshot)
- Rekaman layar proses reproduksi: Rekam lengkap proses lokalisasi dari startup hingga anomali terjadi.
- Screenshot frame kunci: Tangkap screenshot pada momen anomali terjadi.
- Rekaman multi-sudut: Berikan referensi visual dari berbagai posisi dan kondisi lighting.
Data runtime (dasar inti pemecahan masalah)
- Data EIF: Rekaman runtime berbasis EasyAR Sense, mendukung pemutaran ulang dan analisis di PC.
- Data Dump: Snapshot status runtime khusus WeChat Mini Program.
- Log aplikasi: Log runtime App (Logcat/Console) dan stack error.
Kiat
Bacaan lanjutan: Cara menyampaikan detail masalah dengan jelas
Kategori lingkungan runtime dan metode pengumpulan
Metode pengumpulan data berbeda sesuai running perangkat dan platform. Pilih panduan yang sesuai berdasarkan actual environment Anda.
Kategori perangkat
- Mobile perangkats: Smartphone (iOS/Android).
- Headset perangkats:
- OST (Optical See-Through): Optical see-through, seperti XREAL dan Rokid.
- VST (Video See-Through): Video see-through, seperti Apple Vision Pro dan PICO.
Panduan screenshot dan rekaman layar
| Jenis platform | Panduan referensi |
|---|---|
| Ponsel / WeChat Mini Program | Screenshot, screen recording, dan export pada phone |
| OST headset | OST rekaman dan ekspor |
| VST headset | VST rekaman dan ekspor |
Pengumpulan data runtime (EIF/Dump)
| Jenis skenario | Solusi pengumpulan |
|---|---|
| EasyAR Sense aplikasi native | Ponsel app EIF recording / Headset EIF recording |
| WeChat Mini Program | Mini Program Data Dump rekaman dan ekspor |
| Alat pengumpulan cepat | Perekaman EIF Mega Toolbox / Toolbox Dump recording |
Mode diagnostik Mega
Mode diagnostik Mega cocok untuk App atau WeChat Mini Program yang sudah online dan tidak memiliki pengembang aplikasi yang dapat ikut menangani masalah. Aplikasi harus sudah mengintegrasikan SDK atau plugin Mini Program yang mendukung kemampuan ini.
Setelah mode diagnostik diaktifkan untuk cloud localization library target dan perangkat diikat, mulai ulang App atau Mini Program agar data runtime direkam otomatis. Ketika masalah muncul saat penggunaan normal, segera simpan dan unggah record melalui Mega diagnostic tool agar dapat dianalisis oleh dukungan teknis EasyAR. Alur lengkap lihat Mode diagnostik Mega.
Jika pengembang aplikasi dapat ikut menangani, prioritaskan perekaman data EIF atau dump sesuai panduan pengumpulan data runtime di atas.
Ringkasan navigasi panduan operasi
Langsung buka detailed panduan operasi sesuai kebutuhan platform perangkat Anda:
| Type | Rekaman layar dan screenshot collection guide | Pengumpulan data runtime guide |
|---|---|---|
| Ponsel application | Screenshot, screen recording, dan export pada phone | Ponsel app EIF recording, Perekaman EIF Mega Toolbox, Instruksi export Data EIF |
| OST headset | OST rekaman dan ekspor | Headset EIF rekaman dan ekspor |
| VST headset | VST rekaman dan ekspor | Headset EIF rekaman dan ekspor |
| WeChat Mini Program | Screenshot, screen recording, dan export pada phone | WeChat Mini Program Dump rekaman dan ekspor, Perekaman Dump Toolbox WeChat Mini Program |
Rekomendasi praktik terbaik
- Proses pra-riset: Sebelum project go live, disarankan agar anggota tim memahami proses pengumpulan data.
- Periksa mandiri terlebih dahulu: Sebelum feedback, pastikan apakah masalah lingkungan teknis, masalah penempatan konten, atau perangkat permission issues sudah dikesampingkan.
- Kelengkapan data: Kumpulkan data lengkap secara standar: minimum informasi umpan balik set, video dan screenshot anomali visual, serta data runtime.
- Komunikasi tepat waktu: Setelah mengirim data lengkap, tetap berkomunikasi dengan tim teknis EasyAR.
Kanal dukungan teknis
- Dokumentasi bantuan: Lihat Dokumentasi Mega atau Troubleshooting.
- Dukungan teknis: Hubungi kami sekarang atau kirim email ke support@sightp.com.
Topik berikutnya: Metode screenshot, screen recording, dan export pada phone