Registrazione dati EIF: evidenza ad alta fedeltà per riprodurre problemi AR
Nelle applicazioni di realtà aumentata (AR), alcuni problemi complessi di localizzazione spaziale (come tremori nel tracking, disallineamento tra reale e virtuale, deriva dei contenuti, ecc.) sono spesso difficili da riprodurre completamente solo tramite registrazione dello schermo o log. A tale scopo, forniamo la funzione di registrazione dati EIF—un formato proprietario di dump dati ad alta fedeltà che registra sincronamente le seguenti informazioni chiave:
- Informazioni di base sul dispositivo (modello, sistema, versione SDK, ecc.)
- Frame di immagini della fotocamera con timestamp
- Matrice intrinseca ed estrinseca della fotocamera del dispositivo
- Dati del sensore IMU
- Dati aggiuntivi da input ausiliari esterni (es. GNSS)
Perché registrare i dati EIF è cruciale?
Importante
I dati EIF in grado di riprodurre un problema sono inestimabili.
I dati EIF permettono di ricostruire completamente il contesto dettagliato al momento del problema, consentendo al team di sviluppo di riprodurre con precisione lo scenario riscontrato dall'utente in un ambiente offline, migliorando notevolmente l'efficienza nella diagnosi. Rispetto a registrazioni dello schermo o log, l'EIF offre i seguenti vantaggi:
- Riproduzione precisa: Gli sviluppatori possono riprodurre direttamente i dati EIF negli strumenti di debug, replicando il bug incontrato.
- Diagnostica approfondita: Analizzando in modo completo vari dati (immagini, sensori, input esterni, ecc.), gli sviluppatori possono determinare in quale punto della catena tecnica si trova il problema.
- Risparmio di tempo: Evita lunghi cicli di comunicazione, riducendo significativamente il tempo dalla segnalazione alla risoluzione del problema.
Come registrare i dati EIF
EasyAR fornisce due modi per registrare i dati EIF.
- Utilizzare direttamente le interfacce API fornite dall'SDK, implementando la funzionalità di registrazione EIF nella tua applicazione.
- Utilizzare l'app ufficiale Mega Toolbox. Di solito è adatta per lo sviluppo con EasyAR Mega e per la segnalazione di problemi.
Per i passaggi operativi specifici, fai riferimento alla nostra documentazione tecnica per ottenere le linee guida operative adatte al tuo caso d'uso e dispositivo.
Consiglio
Visita il seguente link per vedere come chiamare le API per implementare la registrazione EIF all'interno dell'app: Input frame recording and simulation run.
Visita il seguente link per vedere la guida operativa sull'uso dell'app Mega Toolbox: Recording mobile EIF files using Toolbox.
Panoramica del flusso di registrazione (esempio con app Mega Toolbox):
- Apri l'app Mega Toolbox, fai clic su "Test di posizionamento sul campo e registrazione dati per feedback su problemi di posizionamento".
- Accedi al tuo account, seleziona la tua libreria di posizionamento e inizia il test.
- Tenta di riprodurre il problema. Trova una sequenza operativa che riproduca stabilmente il problema (es. orientamento dispositivo, modalità di navigazione, punti di ripresa, ecc.).
- Quando tutto è pronto, fai clic sul pulsante rosso "Registra" per iniziare la registrazione.
- Dopo che il problema si è verificato, fai clic sul pulsante rosso "Interrompi e salva".
- Il sistema genererà automaticamente un file EIF. Collega il dispositivo al computer, esportalo nella memoria locale e invialo.
Nota
I file EIF possono essere grandi (centinaia di MB fino a GB), si consiglia di registrare solo il frammento centrale contenente il problema (solitamente 10-30 secondi sono sufficienti).
Migliori pratiche suggerite
Per garantire che il tuo feedback venga elaborato efficientemente, includi tutte e quattro le seguenti informazioni quando lo invii:
| Tipo di informazione | Descrizione |
|---|---|
| File di dati EIF | Base diagnostica principale, deve includere il processo di riproduzione del problema |
| Descrizione soggettiva del fenomeno | Spiega chiaramente il comportamento osservato (es. "La freccia di navigazione durante una svolta a sinistra è saltata improvvisamente sul soffitto") |
| Registrazione dello schermo o screenshot | Aiuta la visualizzazione del problema, mostra chiaramente "cosa ha visto effettivamente l'utente" |
| Informazioni contestuali aggiuntive | Include: • Modello del dispositivo e versione del sistema operativo • Numero di versione dell'EasyAR SDK utilizzato dalla tua applicazione • Descrizione dell'ambiente in cui si è verificato il problema (interno/esterno, illuminazione, dimensioni dello spazio) • Per applicazioni tipo Mega, fornire inoltre informazioni sulla libreria di posizionamento, esportabili tramite lo strumento Unity • Per applicazioni di riconoscimento cloud CRS, fornire informazioni sulla libreria di riconoscimento cloud |
Consiglio
Esempio: "Su Apple Vision Pro (visionOS 26) con EasyAR Sense Unity Plugin 4000.0.1, durante la navigazione in un centro commerciale al coperto, in una certa posizione il percorso di navigazione ha improvvisamente dato un errore. File EIF registrato: avp_wrong_path_20251218.mkveif, allegata registrazione schermo, foto dell'ambiente e informazioni sulla libreria di posizionamento: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
Fornendo il pacchetto completo di informazioni sopra descritto, accelererai significativamente il processo di analisi e risoluzione del problema. Grazie per la collaborazione!