Recording eif files and using for simulation

**EIF 파일(EasyAR Input Frame file)**은 EasyAR Sense가 일련의 입력 프레임 데이터를 저장하는 데 사용하는 파일 형식입니다. 이 문서는 EIF 파일을 녹화하고 시뮬레이션 실행에 사용하는 방법을 설명합니다.

EIF files and content

EIF 파일은 녹화 방식에 따라 두 가지 구현이 존재합니다:

원시 EIF 형식(일반적으로 .eif 확장자)

원시 EIF 파일은 EasyAR 내부 정의 데이터 구조로 입력 프레임 데이터(이미지 및 카메라 매개변수, 추적 상태 등 추가 정보)를 프레임 단위로 저장합니다. 이 형식은 비디오 압축을 수행하지 않고 프레임 단위 인코딩(예: JPEG 이미지 데이터)을 사용하여 정확한 재생에 적합합니다.
EIF MKV 형식(일반적으로 .mkveif 확장자)

MKV 컨테이너 기반 비디오 형식으로, 입력 프레임 정보를 MKV 컨테이너에 인코딩합니다. 비디오 인코딩은 H.264를 사용하여 이미지 데이터를 압축하고, IMU 센서 데이터, 위치 데이터 등 입력 프레임의 다른 메타데이터를 스트림 또는 추가 트랙으로 보존합니다. 이를 통해 파일 크기를 크게 줄이고 표준 비디오 스트림 처리가 용이합니다.

EIF MKV 형식은 현재 Android/iOS/macOS/visionOS에서의 녹화 및 Windows/macOS에서의 재생만 지원하며, 기존 EIF 형식에는 이 제한이 없습니다.

EasyAR은 녹화 및 재생을 위한 전체 메커니즘을 다음 컴포넌트를 통해 제공합니다:

녹화된 EIF 파일을 입력 데이터 소스로 사용하는 것은 물리적 카메라 및 관련 센서의 런타임 전체 데이터 스트림을 AR 엔진에 "재생"하는 것과 같습니다. 입력 프레임 시퀀스를 시뮬레이션함으로써:

AR 엔진은 여전히 물리적 카메라 데이터를 수신한다고 인식합니다.

재생된 각 프레임은 원본 타임스탬프, 카메라 매개변수 및 추적 상태를 가지며, 알고리즘이 실시간 데이터처럼 이 프레임을 처리하도록 구동합니다.
비장치 환경(예: PC 또는 Unity 에디터)에서 실제 런타임 동작을 재현할 수 있습니다.

이를 통해 실제 기기가 없어도 Windows/Mac에서 Mega 등의 기능을 시뮬레이션 실행하며 시각적 추적, 공간 맵핑 등의 기능을 디버깅할 수 있습니다.

EIF 시뮬레이션 실행으로 달성 가능한 효과:

실제 데이터 흐름 과정 재현 카메라가 없더라도 평면 이미지 추적, 공간 위치 추정, 밀집 지도 생성 등과 같은 AR 기능을 실제 실행처럼 구동할 수 있습니다.
개발 디버깅 및 진단 용이성 녹화된 EIF 파일은 추적 실패 원인 분석, 특정 입력에서의 AR 알고리즘 동작 또는 성능 변동 검증에 활용될 수 있습니다.
크로스 플랫폼 재생 EIF 파일을 다른 플랫폼 간 전송하여 PC에서 휴대폰으로 녹화된 AR 세션 동작을 재현할 수 있으며, 기기 없이도 디버깅이 가능합니다.

EIF 파일 녹화 및 시뮬레이션 실행은 플랫폼과 밀접하게 연관되어 있습니다. 대상 플랫폼에 따라 다음 가이드를 참고하여 개발하세요: