Mega pengumpulan data diagnostik
Panduan ini bertujuan untuk memberikan panduan standar untuk pengumpulan data anomali visual. Melalui pengumpulan dan umpan balik data yang terstandarisasi, membantu pengembang menggambarkan masalah secara akurat, dan membantu tim teknologi EasyAR secara efisien menemukan, mereproduksi, dan menyelesaikan kesalahan teknis terkait pelokalan visual.
Ikhtisar konten
Dalam proses integrasi layanan pelokalan EasyAR Mega, pengumpulan data yang akurat adalah prasyarat inti untuk diagnosis masalah. Panduan ini mencakup tautan kunci berikut:
- Identifikasi masalah: Klasifikasi dan penilaian awal terhadap fenomena anomali umum.
- Spesifikasi tangkapan layar dan rekaman: Metode pengambilan bukti visual untuk berbagai platform perangkat.
- Pengumpulan data runtime: Ekstraksi dan ekspor data lingkungan runtime di berbagai platform.
- Standar umpan balik informasi: Memastikan "kumpulan informasi minimum" yang diperlukan tim teknis untuk mereproduksi masalah.
Klasifikasi dan penilaian awal fenomena anomali
Sebelum memberikan umpan balik masalah, harap identifikasi fenomena anomali dengan mengacu pada klasifikasi berikut:
Manifestasi anomali umum
- Sama sekali tidak dapat dilokalisasi: Tidak dapat mengenali pemandangan, status terus menampilkan "NotFound".
- Penyimpangan akurasi pelokalan: Pelokalan berhasil tetapi akurasi tidak mencukupi, terdapat pergeseran spasial yang jelas.
- Pelokalan tidak stabil: Gambar bergetar, melayang, atau kehilangan pelacakan secara sering.
- Anomali regional: Kinerja pelokalan buruk di area atau titik tertentu.
- Perbedaan kompatibilitas perangkat: Kinerja buruk pada model perangkat tertentu.
Dugaan penyebab yang mungkin
- Terkait pemandangan: Posisi penempatan konten bergeser, kualitas pemetaan rendah, pencahayaan lingkungan atau titik fitur (seperti dinding putih besar) jarang, terdapat gangguan titik serupa.
- Lingkungan teknis: Gangguan jaringan, layanan tidak dibayar, batas QPS terlampaui, kompatibilitas versi SDK, kesalahan logika pemanggilan API.
- Izin perangkat keras: Sensor perangkat (IMU) tidak mendukung pelacakan gerak, izin kamera atau penyimpanan tidak diaktifkan.
Prosedur umpan balik terstandarisasi
Untuk meningkatkan efisiensi pemecahan masalah, kami sangat menyarankan Anda mengirimkan paket umpan balik lengkap yang berisi tiga bagian berikut:
Daftar informasi dasar (kumpulan informasi minimum)
- Pengidentifikasi sumber daya: Informasi akun, Mega AppId, Block Id.
- Informasi versi: Versi EasyAR Sense SDK atau versi plugin mini program.
- Deskripsi masalah terperinci: Deskripsi rinci fenomena anomali dan kondisi pemicunya.
- Parameter lingkungan: Model perangkat, versi OS, versi WeChat, lingkungan jaringan saat ini (4G/5G/WiFi).
Bukti visual (video dan tangkapan layar)
- Rekaman proses reproduksi: Rekam lengkap proses pelokalan dari peluncuran hingga terjadinya anomali.
- Tangkapan layar bingkai kunci: Tangkap tangkapan layar pada saat anomali terjadi.
- Rekaman multi-sudut: Berikan referensi visual dari posisi berbeda, kondisi pencahayaan berbeda.
Data runtime (dasar inti pemecahan masalah)
- Data EIF: Rekaman berbasis EasyAR Sense runtime, mendukung analisis pemutaran ulang di PC.
- Data Dump: Cuplikan status runtime khusus untuk mini program WeChat.
- Log aplikasi: Log runtime aplikasi (Logcat/Console) dan jejak kesalahan.
Kiat
Bacaan lebih lanjut: Cara mengkomunikasikan detail masalah dengan jelas
Klasifikasi lingkungan runtime dan metode pengumpulan
Metode pengumpulan data bervariasi tergantung pada perangkat dan platform runtime, silakan pilih panduan yang sesuai dengan lingkungan aktual Anda.
Penjelasan klasifikasi perangkat
- Perangkat seluler: Smartphone (iOS/Android).
- Perangkat headset:
- OST (Optical See-Through): Augmented reality berbasis optik (mis. XREAL, Rokid).
- VST (Video See-Through): Augmented reality berbasis video (mis. Apple Vision Pro, PICO)
Panduan tangkapan layar dan rekaman
| Jenis platform | Panduan referensi |
|---|---|
| Ponsel / Mini program WeChat | Tangkapan layar, rekaman, dan ekspor ponsel |
| Headset OST | Rekaman dan ekspor OST |
| Headset VST | Rekaman dan ekspor VST |
Pengumpulan data runtime (EIF/Dump)
| Jenis skenario | Skema pengumpulan |
|---|---|
| Aplikasi native EasyAR Sense | Rekaman EIF aplikasi ponsel / Rekaman EIF headset |
| Mini program WeChat | Rekaman dan ekspor data Dump mini program |
| Alat pengumpulan cepat | Rekaman EIF Mega Toolbox / Rekaman Dump Toolbox |
Fitur pengumpulan otomatis (segera hadir)
Kami akan segera meningkatkan dukungan untuk fitur pengumpulan dan umpan balik otomatis, menyediakan cara pengiriman data yang lebih mudah:
- Rekaman latar belakang: Mulai pengumpulan kumpulan data yang diperlukan sesuai permintaan
- Unggahan otomatis: Otomatis mengemas dan mengunggah ke tim teknis EasyAR
- Tangkapan sesuai permintaan: Tangkap status anomali secara real-time mandiri
- Pelacakan kemajuan: Klasifikasi dan pelacakan berkelanjutan
Ringkasan navigasi panduan operasi
Sesuai kebutuhan platform perangkat Anda, langsung beralih ke panduan operasi terperinci:
| Jenis | Panduan pengumpulan tangkapan layar dan rekaman | Panduan pengumpulan data runtime |
|---|---|---|
| Aplikasi ponsel | Tangkapan layar, rekaman, dan ekspor ponsel | Rekaman EIF aplikasi ponsel, Rekaman EIF Mega Toolbox, Penjelasan ekspor data EIF |
| Headset OST | Rekaman dan ekspor OST | Rekaman dan ekspor EIF perangkat headset |
| Headset VST | Rekaman dan ekspor VST | Rekaman dan ekspor EIF perangkat headset |
| Mini program WeChat | Tangkapan layar, rekaman, dan ekspor ponsel | Rekaman dan ekspor Dump mini program WeChat, Rekaman Dump Toolbox mini program WeChat |
Saran praktik terbaik
- Proses pra-penelitian: Sebelum peluncuran proyek, disarankan anggota tim membiasakan diri dengan proses pengumpulan data.
- Pemeriksaan mandiri terlebih dahulu: Sebelum memberikan umpan balik, konfirmasi apakah masalah lingkungan teknis, penempatan konten, atau izin perangkat telah diselesaikan.
- Kelengkapan data: Kumpulkan data lengkap secara terstandarisasi: berikan kumpulan informasi minimum, video dan tangkapan layar anomali visual, data runtime.
- Komunikasi tepat waktu: Setelah mengirimkan data lengkap, harap pertahankan komunikasi dengan tim teknis EasyAR.
Saluran dukungan teknis
- Dokumentasi bantuan: Lihat Dokumentasi Mega atau Pemecahan masalah.
- Dukungan teknis: Konsultasi segera atau kirim email ke support@sightp.com.
Topik berikutnya: Metode tangkapan layar, rekaman, dan ekspor ponsel