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 |
Fitur pengumpulan otomatis (segera hadir)
Kami akan segera meningkatkan dukungan untuk pengumpulan dan feedback otomatis, menyediakan cara pengiriman data yang lebih mudah:
- Perekaman latar belakang: Mulai pengumpulan dataset di latar belakang yang diperlukan sesuai kebutuhan
- Unggah otomatis: Paketkan dan unggah otomatis data ke tim teknis EasyAR
- Tangkap sesuai kebutuhan: Tangkap status abnormal secara real time mandiri
- Pelacakan progres: Klasifikasikan dan lacak progres secara berkelanjutan
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