Gravar arquivos Eif e usá-los para simulação
Arquivos EIF (EasyAR Input Frame file) são um formato de arquivo usado pelo EasyAR Sense para armazenar uma sequência de dados de quadros de entrada. Este artigo descreve como gravar arquivos EIF e usá-los para simulação.
Arquivos eif e conteúdo
Arquivos EIF possuem duas implementações dependendo do método de gravação:
Formato EIF original (geralmente com extensão .eif)
O arquivo EIF original armazena dados de quadros de entrada quadro a quadro usando estruturas de dados internas do EasyAR, incluindo imagens e informações adicionais (como parâmetros da camera e estado de rastreamento). Este formato não aplica compressão de vídeo, mas codifica quadro a quadro (ex: dados de imagem JPEG), sendo ideal para reprodução precisa.
Formato EIF MKV (geralmente com extensão .mkveif)
Formato de vídeo baseado no contêiner MKV, que codifica informações do quadro de entrada no contêiner. A codificação de vídeo usa H.264 para comprimir dados de imagem, enquanto preserva outros metadados do quadro de entrada (como dados de sensores IMU, dados de localização, etc.) como fluxos ou faixas adicionais. Isso reduz significativamente o tamanho do arquivo e facilita o processamento de fluxo de vídeo padrão.
Nota
O formato EIF MKV atualmente suporta gravação apenas em Android/iOS/macOS/visionOS e reprodução em Windows/macOS. O formato EIF tradicional não possui essa limitação.
Gravação e reprodução de eif
O EasyAR fornece um mecanismo completo para gravação e reprodução, controlado principalmente pelos seguintes componentes:
InputFrameRecorder / InputFramePlayer
Uso
Corresponde aos componentes de gravação e reprodução do formato EIF original.
Características
Durante a gravação, todos os quadros de entrada recebidos são serializados e salvos, incluindo imagem, parâmetros, estado de rastreamento, etc.
VideoInputFrameRecorder / VideoInputFramePlayer
Uso
Corresponde aos componentes de gravação e reprodução do formato EIF MKV.
Características
Durante a gravação, suporta mais fluxos de dados de sensores (como giroscópio, acelerômetro, dados de localização, etc.) e os encapsula juntos no arquivo EIF MKV. O lado da reprodução pode optar por emitir esses dados, facilitando a simulação completa de várias entradas no PC.
Princípio e efeitos alcançáveis ao usar eif para simulação
Usar um arquivo EIF gravado como fonte de dados de entrada equivale a "repassar" ao mecanismo de AR o fluxo completo de dados de sensores e câmera física durante a execução. Ao simular a sequência de quadros de entrada:
O mecanismo de AR acredita que ainda está obtendo dados da câmera física
Cada quadro reproduzido possui carimbo de data/hora original, parâmetros da câmera e estado de rastreamento, fazendo com que os algoritmos processem esses quadros como dados em tempo real.
É possível reproduzir comportamentos de tempo de execução real em ambientes não-dispositivo (como PC ou editor Unity)
Isso permite depurar funções como rastreamento visual, mapas espaciais, etc., sem necessidade de dispositivo físico, podendo simular recursos como Mega em Windows/Mac.
Efeitos alcançáveis ao usar EIF para simulação:
Reprodução do processo real de fluxo de dados Mesmo sem câmera, é possível acionar funções de AR como rastreamento de imagem plana, localização espacial, geração de mapa denso, etc., como em execução real.
Facilita desenvolvimento, depuração e diagnóstico Arquivos EIF gravados podem ser usados para analisar causas de falhas de rastreamento, verificar comportamento de algoritmos de AR em entradas específicas ou flutuações de desempenho.
Reprodução multi-plataforma Transferir arquivos EIF entre plataformas permite reproduzir comportamentos de sessão AR gravada em celular diretamente no PC, depurando sem necessidade de dispositivo.
Próximas etapas
Guias específicos de plataforma
Gravar arquivos EIF e usá-los para simulação está intimamente relacionado à plataforma. Consulte os guias abaixo conforme sua plataforma-alvo: