Registrazione dei dati EIF: base di alta fedeltà per riprodurre i problemi di AR
In applicazioni di realtà aumentata (AR), alcuni problemi complessi di localizzazione spaziale (come tremolio del tracciamento, disallineamento tra il reale e il virtuale, spostamento del contenuto, ecc.) spesso sono difficili da riprodurre completamente solo attraverso registrazioni video o log. Per questo motivo, offriamo la funzione di registrazione dei dati EIF, un formato di dump di dati di alta fedeltà proprietario, che può registrare in modo sincrono le seguenti informazioni chiave:
- Informazioni di base sul dispositivo (modello, sistema operativo, versione SDK, ecc.)
- Frame di immagine della telecamera con timestamp
- Matrici di parametri intrinseci ed esterni della telecamera del dispositivo
- Dati del sensore IMU
- Dati aggiuntivi di input ausiliario esterno (come GNSS)
Perché è importante registrare i dati EIF?
Importante
I dati EIF in grado di riprodurre il problema sono inestimabili.
I dati EIF possono riprodurre completamente il contesto dettagliato in cui si è verificato il problema, consentendo al team di sviluppo di riprodurre con precisione lo scenario riscontrato dall'utente in un ambiente offline, migliorando notevolmente l'efficienza nella localizzazione del problema. Rispetto alle registrazioni video o ai log, l'EIF presenta i seguenti vantaggi:
- Riproduzione precisa: gli sviluppatori possono riprodurre direttamente i dati EIF negli strumenti di debug, riproducendo il bug che hai incontrato.
- Diagnosi a basso livello: attraverso l'analisi completa di vari tipi di dati (immagini, sensori, input esterni, ecc.), gli sviluppatori possono identificare in quale fase tecnica si trova il problema.
- Risparmio di tempo: evita lunghi cicli di comunicazione, riducendo notevolmente il ciclo dal rapporto del problema alla sua risoluzione.
Come registrare i dati EIF
EasyAR offre due modalità di registrazione dei dati EIF.
- Utilizzare direttamente l'interfaccia API fornita dall'SDK per implementare la funzione di registrazione dei dati EIF nella tua applicazione.
- Utilizzare l'app Mega Toolbox fornita ufficialmente. Di solito è adatta per lo sviluppo di EasyAR Mega e il feedback sui problemi.
Per i passaggi operativi specifici, consulta la nostra documentazione tecnica per ottenere le istruzioni operative per la tua modalità d'uso e il tuo dispositivo.
Consiglio
Visita il seguente link per vedere come implementare la funzione di registrazione EIF all'interno dell'applicazione chiamando l'interfaccia API: Registrazione dei frame di input e esecuzione simulata.
Visita il seguente link per vedere le istruzioni operative per l'utilizzo dell'app Mega Toolbox: Utilizzare Toolbox per registrare file EIF dal telefono.
Panoramica sintetica del flusso di registrazione (prendendo l'app Mega Toolbox come esempio):
- Apri l'app Mega Toolbox e fai clic su
Strumento di verifica e diagnostica in loco. - Accedi al tuo account, seleziona la tua libreria di localizzazione e inizia il test.
- Prova a riprodurre il problema. Trova un modello di operazione che consenta di riprodurre il problema in modo stabile (come l'orientamento del dispositivo, il modo di navigazione, il punto di ripresa, ecc.).
- Quando tutto è pronto, fai clic sul pulsante rosso "Registrazione" per iniziare la registrazione.
- Dopo l'apparizione del problema, fai clic sul pulsante rosso "Ferma e salva".
- Il sistema genererà automaticamente un file EIF. Connetti il dispositivo al computer, esportalo nella memoria locale e invialo.
Nota
I file EIF possono essere di grandi dimensioni (da centinaia di MB a diversi GB). Si consiglia di registrare solo il segmento centrale contenente il problema (in genere 10 - 30 secondi sono sufficienti).
Suggerimenti per le migliori pratiche
Per garantire che il tuo feedback venga gestito in modo efficiente, assicurati di includere contemporaneamente le seguenti quattro categorie di informazioni al momento dell'invio:
| Tipo di informazione | Descrizione |
|---|---|
| File di dati EIF | Base di diagnostica principale, deve contenere sicuramente il processo di riproduzione del problema |
| Descrizione soggettiva del fenomeno | Spiega chiaramente il comportamento che hai osservato (ad esempio, "La freccia di navigazione è saltata all'improvviso sul soffitto durante una svolta a sinistra") |
| Registrazione video o screenshot | Aiuta a visualizzare il problema in modo直观, mostrando in modo immediato "come appare l'immagine finale vista dall'utente" |
| Informazioni di contesto ausiliario | Include: • Il modello del tuo dispositivo e la versione del sistema operativo • Il numero di versione dell'SDK EasyAR utilizzato dalla tua applicazione • Descrizione dell'ambiente in cui si è verificato il problema (interno/esterno, illuminazione, dimensioni dello spazio) • Le applicazioni di tipo Mega devono fornire ulteriori informazioni sulla libreria di localizzazione, che possono essere esportate nell'uso Unity • Le applicazioni di riconoscimento cloud CRS devono fornire ulteriori informazioni sulla libreria di riconoscimento cloud |
Consiglio
Esempio: "Utilizzo EasyAR Sense Unity Plugin 4000.0.1 su Apple Vision Pro (visionOS 26) per la navigazione in un centro commerciale interno. In un certo punto, il percorso di navigazione è diventato improvvisamente errato. Ho registrato il file EIF: avp_wrong_path_20251218.mkveif, e allegato la registrazione video, le foto dell'ambiente e le informazioni sulla libreria di localizzazione: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
Fornendo il pacchetto completo di informazioni sopra descritto, accelererai notevolmente il processo di analisi e risoluzione del problema. Grazie per la collaborazione!