Raccolta dati diagnostici Mega
Questa guida mira a fornire istruzioni standardizzate per la raccolta di dati relativi ad anomalie visive. Attraverso una raccolta e feedback standardizzati, aiuta gli sviluppatori a descrivere accuratamente i problemi e supporta il team tecnico di EasyAR nell'identificare, replicare e risolvere in modo efficiente i guasti tecnici relativi al posizionamento visivo.
Introduzione ai contenuti
Durante l'integrazione del servizio di posizionamento EasyAR Mega, una raccolta dati accurata è il presupposto fondamentale per la diagnosi dei problemi. Questa guida copre le seguenti fasi chiave:
- Identificazione del problema: classificazione e valutazione preliminare dei fenomeni anomali comuni.
- Standard per screenshot e registrazioni schermo: metodi di acquisizione visiva per diverse piattaforme di dispositivi.
- Raccolta dati di runtime: estrazione ed esportazione dei dati dell'ambiente di runtime su varie piattaforme.
- Standard per il feedback: garanzia del "set minimo di informazioni" necessario al team tecnico per replicare il problema.
Classificazione e valutazione preliminare delle anomalie
Prima di segnalare un problema, identificare il fenomeno anomalo in base alle seguenti categorie:
Manifestazioni anomale comuni
- Impossibilità completa di localizzazione: impossibilità di riconoscere la scena, stato persistentemente visualizzato come "NotFound".
- Deviazione della precisione di localizzazione: localizzazione riuscita ma precisione insufficiente, con evidente spostamento spaziale.
- Instabilità della localizzazione: tremolio, deriva dell'immagine o perdita frequente del tracking.
- Anomalie regionali: prestazioni di localizzazione scadenti in aree o punti specifici.
- Differenze di compatibilità del dispositivo: prestazioni inferiori su modelli specifici di dispositivi.
Possibili cause ipotizzate
- Relative alla scena: posizionamento errato dei contenuti, bassa qualità della mappatura, illuminazione ambientale o punti caratteristici (es. ampie pareti bianche) scarsi, presenza di punti simili che causano interferenze.
- Ambiente tecnico: instabilità di rete, servizio non pagato, superamento del limite QPS, compatibilità della versione SDK, errori logici nella chiamata API.
- Autorizzazioni hardware: sensori del dispositivo (IMU) non supportano il motion tracking, autorizzazioni fotocamera o archiviazione non attive.
Flusso di feedback standardizzato
Per migliorare l'efficienza della risoluzione, si consiglia vivamente di inviare un pacchetto di feedback completo contenente queste tre parti:
Elenco informazioni di base (set minimo di informazioni)
- Identificatori risorse: informazioni account, Mega AppId, Block Id.
- Informazioni sulla versione: versione di EasyAR Sense SDK o del plugin mini-program.
- Descrizione dettagliata del problema: descrizione approfondita del fenomeno anomalo e delle condizioni che lo attivano.
- Parametri ambientali: modello dispositivo, versione OS, versione Weixin, ambiente di rete attuale (4G/5G/WiFi).
Prove visive (video e screenshot)
- Registrazione schermo del processo di riproduzione: registrazione completa del processo di localizzazione dall'avvio fino alla comparsa dell'anomalia.
- Screenshot dei fotogrammi chiave: cattura di istantanee nel momento esatto in cui si verifica l'anomalia.
- Registrazioni multiangolo: fornitura di riferimenti visivi da diverse posizioni e condizioni di illuminazione.
Dati di runtime (base per l'analisi)
- Dati EIF: registrazione di runtime basata su EasyAR Sense, supporta l'analisi di riproduzione su PC.
- Dati Dump: snapshot dello stato di runtime specifici per i mini-program Weixin.
- Log applicazione: log di runtime dell'app (Logcat/Console) e stack trace degli errori.
Consiglio
Ulteriori letture: Come comunicare chiaramente i dettagli di un problema
Ambiente di runtime e metodi di raccolta classificati
I metodi di raccolta dati variano in base al dispositivo e alla piattaforma di runtime. Selezionare le istruzioni pertinenti in base al proprio ambiente effettivo.
Spiegazione della classificazione dei dispositivi
- Dispositivi mobili: smartphone (iOS/Android).
- Dispositivi head-mounted:
- OST (Optical See-Through): ottica a visione diretta (es. XREAL, Rokid).
- VST (Video See-Through): video a visione diretta (es. Apple Vision Pro, PICO)
Istruzioni per screenshot e registrazioni schermo
| Tipo piattaforma | Guida di riferimento |
|---|---|
| Telefono / Mini-program Weixin | Screenshot, registrazione schermo ed esportazione su telefono |
| Head-mounted OST | Registrazione schermo ed esportazione per OST |
| Head-mounted VST | Registrazione schermo ed esportazione per VST |
Raccolta dati di runtime (EIF/Dump)
| Tipo scenario | Soluzione di raccolta |
|---|---|
| App nativa EasyAR Sense | Registrazione EIF per app mobile / Registrazione EIF per head-mounted |
| Mini-program Weixin | Registrazione ed esportazione dati Dump per mini-program |
| Strumento di raccolta rapida | Registrazione EIF con Mega Toolbox / Registrazione Dump con Toolbox |
Funzione di raccolta automatica (prossimamente disponibile)
Stiamo per aggiornare il supporto per la raccolta e il feedback automatici, offrendo un modo più semplice per inviare i dati:
- Registrazione in background: avvio su richiesta della raccolta del set di dati necessario in background
- Caricamento automatico: creazione automatica del pacchetto e caricamento al team tecnico EasyAR
- Cattura su richiesta: auto-cattura in tempo reale degli stati anomali
- Tracciamento avanzamento: classificazione e monitoraggio continuo
Riepilogo navigazione guide operative
In base alle esigenze della propria piattaforma dispositivo, passare direttamente alle guide operative dettagliate:
| Tipo | Guida alla raccolta screenshot e registrazioni schermo | Guida alla raccolta dati di runtime |
|---|---|---|
| App mobile | Screenshot, registrazione schermo ed esportazione su telefono | Registrazione EIF per app mobile, Registrazione EIF con Mega Toolbox, Spiegazione esportazione dati EIF |
| Head-mounted OST | Registrazione schermo ed esportazione per OST | Registrazione ed esportazione EIF per dispositivi head-mounted |
| Head-mounted VST | Registrazione schermo ed esportazione per VST | Registrazione ed esportazione EIF per dispositivi head-mounted |
| Mini-program Weixin | Screenshot, registrazione schermo ed esportazione su telefono | Registrazione ed esportazione Dump per mini-program Weixin, Registrazione Dump per mini-program Weixin con Toolbox |
Migliori pratiche consigliate
- Flusso di ricerca preliminare: prima del lancio del progetto, si consiglia ai membri del team di familiarizzare con il flusso di raccolta dati.
- Autoverifica preventiva: prima del feedback, verificare di aver escluso problemi ambientali tecnici, di posizionamento dei contenuti o di autorizzazioni del dispositivo.
- Completezza dei dati: raccogliere in modo standardizzato dati completi: fornire il set minimo di informazioni, video e screenshot delle anomalie visive, dati di runtime.
- Comunicazione tempestiva: dopo aver inviato i dati completi, mantenere la comunicazione con il team tecnico EasyAR.
Canali di supporto tecnico
- Documentazione di aiuto: consultare Documentazione Mega o Risoluzione dei problemi.
- Supporto tecnico: Contattaci ora o invia un'email a support@sightp.com.
Argomento successivo: Metodi per screenshot, registrazione schermo ed esportazione su telefono