Registrare dati EIF: prove ad alta fedeltà per riprodurre problemi AR
Nelle applicazioni di realtà aumentata (AR), alcuni problemi complessi di spatial localization, come jitter del tracking, disallineamento virtual-real e deriva del contenuto, sono spesso difficili da riprodurre completamente solo tramite registrazioni dello schermo o log. Per questo forniamo la funzione di registrazione dati EIF, un formato proprietario di dump dati ad alta fedeltà che può registrare in modo sincronizzato le seguenti informazioni chiave:
- Informazioni di base del dispositivo, come modello, sistema e versione SDK
- Frame immagine della camera con timestamp
- Matrice intrinseca ed estrinseca della camera del dispositivo
- Dati dei sensori IMU
- Dati aggiuntivi da input ausiliari esterni, come GNSS
Perché registrare dati EIF è importante?
Importante
I dati EIF in grado di riprodurre un problema sono inestimabili.
I dati EIF possono riprodurre completamente il contesto dettagliato in cui si verifica un problema, consentendo al team di sviluppo di riprodurre con precisione lo scenario dell'utente in un ambiente offline e migliorare notevolmente l'efficienza di localizzazione del problema. Rispetto a registrazioni dello schermo o log, EIF presenta i seguenti vantaggi:
- Riproduzione precisa: gli sviluppatori possono riprodurre direttamente i dati EIF negli strumenti di debug per ricreare il Bug incontrato.
- Diagnostica di basso livello: attraverso l'analisi completa di vari tipi di dati, come immagini, sensori e input esterni, gli sviluppatori possono determinare in quale fase tecnica si trova il problema.
- Risparmio di tempo: evita lunghi cicli di comunicazione e riduce significativamente il ciclo dalla segnalazione del problema alla risoluzione.
Come registrare dati EIF
EasyAR fornisce due modi per registrare dati EIF.
- Usare direttamente le API fornite dall'SDK per implementare la funzione di registrazione dati EIF nella propria applicazione.
- Usare la Mega Toolbox App ufficiale. Di solito è adatta allo sviluppo EasyAR Mega e al feedback sui problemi.
Per i passaggi dettagliati, consultare la nostra documentazione tecnica per ottenere guide operative relative al proprio metodo di utilizzo e dispositivo.
Consiglio
Visitare il seguente link per vedere come implementare la registrazione EIF in-app chiamando le API: Input frame recording and simulated runtime.
Visitare il seguente link per vedere la guida operativa per usare Mega Toolbox App: Use Toolbox to record mobile EIF files.
Panoramica breve del processo di registrazione, usando Mega Toolbox App come esempio:
- Aprire Mega Toolbox App e toccare
On-site Verification and Diagnostics Tool. - Accedere al proprio account, selezionare la propria localization library e iniziare il test.
- Provare a riprodurre il problema. Trovare un modello operativo che possa riprodurre stabilmente il problema, come orientamento del dispositivo, metodo di navigazione o punto di ripresa.
- Quando tutto è pronto, toccare il pulsante rosso "Record" per avviare la registrazione.
- Dopo la comparsa del problema, toccare il pulsante rosso "Stop and Save".
- Il sistema genererà automaticamente un file EIF. Collegare il dispositivo a un computer, esportarlo nello storage locale e inviarlo.
Nota
I file EIF possono essere grandi, da centinaia di MB a diversi GB. Si consiglia di registrare solo il segmento principale contenente il problema, di solito 10-30 secondi sono sufficienti.
Suggerimenti di best practice
Per garantire che il feedback possa essere elaborato in modo efficiente, includere contemporaneamente i seguenti quattro tipi di informazioni al momento dell'invio:
| Tipo di informazione | Descrizione |
|---|---|
| File dati EIF | Base diagnostica principale, deve includere il processo di riproduzione del problema |
| Descrizione soggettiva del fenomeno | Descrivere chiaramente il comportamento osservato, ad esempio "la freccia di navigazione è saltata improvvisamente al soffitto durante la svolta a sinistra" |
| Registrazione dello schermo o screenshot | Aiuta a visualizzare il problema e mostra intuitivamente "che cosa l'utente ha visto alla fine" |
| Informazioni di contesto ausiliarie | Include: • Modello del dispositivo e versione del sistema operativo • Versione EasyAR SDK usata dall'applicazione • Descrizione dell'ambiente in cui si è verificato il problema (indoor/outdoor, illuminazione, dimensione dello spazio) • Le applicazioni di tipo Mega devono fornire anche informazioni sulla localization library, esportabili dallo Unity tool • Le applicazioni di tipo CRS cloud recognition devono fornire anche informazioni sulla cloud recognition library |
Consiglio
Esempio: "Su Apple Vision Pro (visionOS 26) con EasyAR Sense Unity Plugin 4000.0.1, durante la navigazione in un centro commerciale indoor, il percorso di navigazione è diventato improvvisamente errato in una certa posizione. File EIF registrato: avp_wrong_path_20251218.mkveif, con registrazione dello schermo, foto dell'ambiente e informazioni sulla localization library allegate: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
Fornendo il pacchetto completo di informazioni sopra, accelererete significativamente l'analisi e la riparazione del problema. Grazie per la collaborazione!