EIF 파일을 기록하고 시뮬레이션 실행에 사용하기

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

EIF 파일과 내용

EIF 파일은 기록 방식에 따라 두 가지 구현이 있습니다.

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

원본 EIF 파일은 EasyAR 내부에서 정의한 데이터 구조를 사용해 입력 프레임 데이터를 프레임 단위로 저장합니다. 여기에는 이미지와 camera 매개변수, 추적 상태 등의 추가 정보가 포함됩니다. 이 형식은 비디오 압축을 사용하지 않고 JPEG 이미지 데이터와 같이 프레임별로 인코딩하므로 정확한 재생에 적합합니다.
EIF MKV 형식(일반적으로 확장자는 .mkveif)

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

EIF MKV 형식은 현재 Android/iOS/macOS/visionOS에서의 기록과 Windows/macOS에서의 재생만 지원합니다. 기존 EIF 형식에는 이러한 제한이 없습니다.

EasyAR는 기록과 재생을 위한 완전한 메커니즘을 제공하며, 주로 다음 컴포넌트를 통해 제어됩니다.

기록된 EIF 파일을 입력 데이터 소스로 사용하는 것은 런타임에 물리 카메라와 관련 센서의 전체 데이터 스트림을 AR engine에 "다시 재생"하는 것과 같습니다. 입력 프레임 시퀀스를 시뮬레이션하면:

AR engine은 여전히 물리 카메라의 데이터를 얻고 있다고 판단합니다

재생 출력의 각 프레임에는 원본 타임스탬프, camera 매개변수, 추적 상태가 포함되어 알고리즘이 실시간 데이터처럼 이러한 프레임을 처리하도록 합니다.
PC 또는 Unity Editor와 같은 비디바이스 환경에서 실제 런타임 동작을 재현할 수 있습니다

따라서 실제 기기 없이 visual tracking, spatial map 등의 기능을 디버그할 수 있으며, Windows/Mac에서 Mega 등의 기능을 시뮬레이션 실행할 수 있습니다.

EIF를 사용한 시뮬레이션 실행으로 다음 효과를 얻을 수 있습니다.

실제 데이터 흐름 재현 카메라가 없어도 planar image tracking, spatial localization, dense map generation 등 AR 기능을 실제 실행처럼 구동할 수 있습니다.
개발, 디버깅, 진단 편의성 향상 기록된 EIF 파일은 추적 실패 원인 분석, 특정 입력에서 AR 알고리즘의 동작 검증, 성능 변동 확인에 사용할 수 있습니다.
크로스 플랫폼 재생 EIF 파일을 서로 다른 플랫폼 간에 전송하여 휴대폰에서 기록한 AR Session 동작을 PC에서 재현할 수 있으므로, 기기 없이 디버깅할 수 있습니다.

EIF 파일을 기록하고 시뮬레이션 실행에 사용하는 것은 플랫폼과 밀접한 관련이 있습니다. 대상 플랫폼에 따라 다음 가이드를 참조하여 개발하십시오.