Registrare file EIF e utilizzarli per simulazioni
File EIF (EasyAR Input Frame file) è un formato di file utilizzato da EasyAR Sense per memorizzare una sequenza di frame di input. Questo articolo descrive come registrare file EIF e utilizzarli per simulazioni.
File EIF e contenuti
I file EIF, a seconda del metodo di registrazione, esistono in due implementazioni:
Formato EIF originale (estensione tipica .eif)
Il file EIF originale memorizza i dati dei frame di input fotogramma per fotogramma utilizzando una struttura dati interna definita da EasyAR, inclusi immagini e informazioni aggiuntive (come parametri della camera e stato del tracking). Questo formato non applica compressione video ma codifica ogni fotogramma separatamente (ad esempio dati di immagine JPEG), risultando adatto per riproduzioni precise.
Formato EIF MKV (estensione tipica .mkveif)
Formato video basato sul contenitore MKV, che codifica le informazioni dei frame di input all'interno del contenitore MKV. La codifica video utilizza H.264 per comprimere i dati dell'immagine, conservando altri metadati dei frame di input (come dati del sensore IMU, dati di posizione) come stream o tracce aggiuntive. Ciò riduce significativamente le dimensioni del file e facilita l'elaborazione di flussi video standard.
Nota
Il formato EIF MKV è attualmente supportato solo per la registrazione su Android/iOS/macOS/visionOS e per la riproduzione su Windows/macOS. Il formato EIF tradizionale non ha queste limitazioni.
Registrazione e riproduzione EIF
EasyAR fornisce un meccanismo completo per registrazione e riproduzione, controllato principalmente dai seguenti componenti:
InputFrameRecorder / InputFramePlayer
Scopo
Componenti per registrazione e riproduzione nel formato EIF originale.
Caratteristiche
Durante la registrazione, tutti i frame di input in arrivo vengono serializzati e salvati, inclusi immagini, parametri, stato del tracking, ecc.
VideoInputFrameRecorder / VideoInputFramePlayer
Scopo
Componenti per registrazione e riproduzione nel formato EIF MKV.
Caratteristiche
La registrazione supporta più flussi di dati da sensori (come giroscopio, accelerometro, dati di posizione) e li incorpora nel file EIF MKV. Il lato riproduzione può scegliere di emettere questi dati, facilitando la simulazione completa di vari input su PC.
Principio e risultati ottenibili con l'uso di EIF per simulazioni
Utilizzare un file EIF registrato come sorgente dati di input equivale a "riprodurre" all'engine AR il flusso completo di dati acquisiti da una camera fisica e dai relativi sensori durante l'esecuzione. Simulando la sequenza di frame di input:
L'engine AR ritiene di star ancora acquisendo dati da una camera fisica
Ogni fotogramma riprodotto possiede il timestamp originale, i parametri della camera e lo stato del tracking, guidando gli algoritmi a elaborare questi frame come se fossero dati in tempo reale.
È possibile riprodurre il comportamento di runtime reale in ambienti non su dispositivo (come PC o Unity Editor)
Ciò consente di debug funzioni come tracking visivo o mappatura spaziale senza un dispositivo fisico, simulando su Windows/Mac funzionalità come Mega.
I risultati ottenibili con l'uso di EIF per simulazioni:
Riproduzione fedele del flusso di dati reale Anche senza una camera fisica, è possibile guidare funzionalità AR come il tracking di immagini piane, il posizionamento spaziale o la generazione di mappe dense come in un'esecuzione reale.
Facilità di sviluppo, debug e diagnosi I file EIF registrati possono essere usati per analizzare cause di fallimento del tracking, verificare il comportamento degli algoritmi AR su input specifici o fluttuazioni delle prestazioni.
Riproduzione cross-platform Trasferire file EIF tra diverse piattaforme consente di riprodurre su PC il comportamento di una sessione AR registrata su telefono, debug senza dispositivo fisico.
Prossimi passi
Guide specifiche per piattaforma
Registrare file EIF e utilizzarli per simulazioni è strettamente legato alla piattaforma. Consulta le seguenti guide in base alla tua piattaforma target: