Table of Contents

Registrare file EIF e usarli per l'esecuzione simulata

Il file EIF (EasyAR Input Frame file) è il formato file usato da EasyAR Sense per memorizzare una serie di dati dei frame di input. Questo articolo descrive principalmente come registrare file EIF e usarli per l'esecuzione simulata.

File EIF e contenuti

I file EIF hanno due implementazioni a seconda del metodo di registrazione:

  • Formato EIF originale (di solito con estensione .eif)

    I file EIF originali memorizzano i dati dei frame di input frame per frame usando strutture dati definite internamente da EasyAR, inclusi immagini e dati aggiuntivi come parametri camera e stato di tracciamento. Questo formato non usa compressione video, ma codifica i dati frame per frame, ad esempio dati immagine JPEG, ed è quindi adatto a una riproduzione accurata.

  • Formato EIF MKV (di solito con estensione .mkveif)

    È un formato video basato su contenitore MKV. Le informazioni dei frame di input vengono codificate nel contenitore MKV. La codifica video usa H.264 per comprimere i dati immagine, mantenendo altri metadati dei frame di input, come dati dei sensori IMU e dati di localization, come stream o tracce aggiuntive. Questo può ridurre in modo significativo la dimensione del file e facilitare l'elaborazione di stream video standard.

Nota

Il formato EIF MKV attualmente supporta solo la registrazione su Android/iOS/macOS/visionOS e la riproduzione su Windows/macOS. Il formato EIF tradizionale non ha questa limitazione.

Registrazione e riproduzione EIF

EasyAR fornisce un meccanismo completo di registrazione e riproduzione, controllato principalmente tramite i seguenti componenti:

  • InputFrameRecorder / InputFramePlayer

    • Scopo

      Componenti di registrazione e riproduzione per il formato EIF originale.

    • Caratteristiche

      Durante la registrazione, tutti i frame di input in arrivo vengono serializzati e salvati, incluse immagini, parametri, stato di tracciamento e altri dati.

  • VideoInputFrameRecorder / VideoInputFramePlayer

    • Scopo

      Componenti di registrazione e riproduzione per il formato EIF MKV.

    • Caratteristiche

      La registrazione supporta più stream di dati sensore, come giroscopio, accelerometro e dati di localization, e li impacchetta insieme in un file EIF MKV. Il lato di riproduzione può scegliere di produrre questi dati, rendendo comodo simulare completamente su PC i vari input presenti al momento della registrazione.

Principi ed effetti ottenibili usando EIF per l'esecuzione simulata

Usare un file EIF registrato come sorgente dati di input equivale a "riprodurre" all'AR engine il flusso dati completo della camera fisica e dei sensori correlati durante il runtime. Simulando la sequenza di frame di input:

  • L'AR engine considera di stare ancora ottenendo dati dalla camera fisica

    Ogni frame emesso durante la riproduzione contiene il timestamp originale, i parametri camera e lo stato di tracciamento, facendo elaborare questi frame all'algoritmo come se stesse eseguendo dati in tempo reale.

  • Il comportamento reale in runtime può essere riprodotto in ambienti senza dispositivo, come un PC o Unity Editor

    In questo modo è possibile eseguire il debug di visual tracking, spatial map e altre funzioni senza un dispositivo fisico, e simulare Mega e altre funzioni su Windows/Mac.

Usare EIF per l'esecuzione simulata può ottenere i seguenti effetti:

  • Riprodurre il flusso dati reale Anche senza camera, le funzioni AR possono essere guidate come in un'esecuzione reale, ad esempio planar image tracking, spatial localization e dense map generation.

  • Facilitare sviluppo, debug e diagnostica I file EIF registrati possono essere usati per analizzare le cause di errori di tracciamento, verificare il comportamento degli algoritmi AR con input specifici o osservare fluttuazioni delle prestazioni.

  • Riproduzione multipiattaforma I file EIF possono essere trasferiti tra piattaforme diverse per riprodurre su PC il comportamento di AR Session registrato su un telefono, consentendo il debug senza il dispositivo.

Passaggi successivi

Guide specifiche per piattaforma

Registrare file EIF e usarli per l'esecuzione simulata è strettamente legato alla piattaforma. Fare riferimento alle seguenti guide per lo sviluppo in base alla piattaforma di destinazione: