EIF 데이터 기록: AR 문제 재현을 위한 고충실도 근거
증강 현실(AR) 애플리케이션에서는 tracking jitter, virtual-real misalignment, content drift 등 일부 복잡한 spatial localization 문제가 화면 녹화나 log만으로는 완전히 재현하기 어려운 경우가 많습니다. 이를 위해 EIF 데이터 기록 기능을 제공합니다. 이는 다음 주요 정보를 동기화하여 기록할 수 있는 proprietary 고충실도 data dump format입니다.
- 디바이스 기본 정보(모델, 시스템, SDK 버전 등)
- timestamp가 포함된 camera image frame
- 디바이스 camera intrinsic matrix 및 extrinsic matrix
- IMU sensor data
- GNSS 등 외부 보조 입력의 추가 데이터
EIF 데이터 기록이 왜 중요한가요?
중요
문제를 재현할 수 있는 EIF 데이터는 매우 귀중합니다.
EIF 데이터는 문제가 발생한 시점의 상세 context를 완전히 재현할 수 있어, 개발 팀이 offline 환경에서 사용자가 겪은 scene을 정확하게 재현하고 문제 localization 효율을 크게 높일 수 있습니다. 화면 녹화나 log와 비교할 때 EIF는 다음 장점이 있습니다.
- 정확한 재현: 개발자는 debugging tool에서 EIF 데이터를 직접 재생하여 사용자가 만난 Bug를 재현할 수 있습니다.
- 저수준 진단: image, sensor, external input 등 다양한 데이터를 종합적으로 분석하여 개발자는 문제가 기술의 어느 단계에서 발생했는지 판단할 수 있습니다.
- 시간 절약: 긴 커뮤니케이션 반복을 피하고 문제 보고부터 해결까지의 주기를 크게 단축합니다.
EIF 데이터 기록 방법
EasyAR는 EIF 데이터 기록 방식 두 가지를 제공합니다.
- SDK에서 제공하는 API interface를 직접 사용하여 애플리케이션에서 EIF 데이터 기록 기능을 구현합니다.
- 공식 Mega Toolbox App을 사용합니다. 일반적으로 EasyAR Mega 개발 및 문제 feedback에 적합합니다.
구체적인 단계는 기술 문서를 참조하여 사용 방식과 디바이스에 맞는 operation guide를 확인하십시오.
팁
API interface 호출로 앱 내 EIF 기록 기능을 구현하는 방법은 다음 링크를 참조하십시오: Input frame recording and simulated runtime.
Mega Toolbox App 사용 guide는 다음 링크를 참조하십시오: Use Toolbox to record mobile EIF files.
간단한 기록 프로세스 개요(Mega Toolbox App 예시):
- Mega Toolbox App을 열고
On-site Verification and Diagnostics Tool을 탭합니다. - 계정에 로그인하고 localization library를 선택한 뒤 테스트를 시작합니다.
- 문제를 재현해 보십시오. 디바이스 방향, browsing 방식, 촬영 위치 등 문제를 안정적으로 재현할 수 있는 operation pattern을 찾습니다.
- 모든 준비가 완료되면 빨간색 "Record" 버튼을 탭하여 기록을 시작합니다.
- 문제가 나타난 후 빨간색 "Stop and Save" 버튼을 탭합니다.
- 시스템이 EIF 파일을 자동으로 생성합니다. 디바이스를 컴퓨터에 연결해 local storage로 내보낸 후 제출합니다.
참고
EIF 파일은 수백 MB에서 수 GB까지 커질 수 있습니다. 문제가 포함된 핵심 구간만 기록하는 것이 좋으며, 일반적으로 10-30초면 충분합니다.
모범 사례 제안
feedback이 효율적으로 처리되도록 제출 시 다음 네 가지 정보를 동시에 포함하십시오.
| 정보 유형 | 설명 |
|---|---|
| EIF 데이터 파일 | 핵심 진단 근거이며, 반드시 문제 재현 과정을 포함해야 합니다 |
| 주관적 현상 설명 | 관찰한 동작을 명확하게 설명합니다. 예: "왼쪽으로 회전할 때 navigation arrow가 갑자기 천장으로 튀었습니다" |
| 화면 녹화 또는 screenshot | 문제 시각화를 보조하고 "사용자가 최종적으로 본 화면"을 직관적으로 보여줍니다 |
| 보조 context 정보 | 포함 항목: • 디바이스 모델 및 운영체제 버전 • 애플리케이션에서 사용하는 EasyAR SDK 버전 번호 • 문제가 발생한 환경 설명(indoor/outdoor, 조명, 공간 크기) • Mega 유형 애플리케이션은 localization library 정보를 추가로 제공해야 하며 Unity tool에서 내보낼 수 있습니다 • CRS cloud recognition 유형 애플리케이션은 cloud recognition library 정보를 추가로 제공해야 합니다 |
팁
예: "Apple Vision Pro(visionOS 26)에서 EasyAR Sense Unity Plugin 4000.0.1을 사용하여 indoor 쇼핑몰에서 navigation 중, 특정 위치에서 navigation route가 갑자기 잘못되었습니다. EIF 파일 기록 완료: avp_wrong_path_20251218.mkveif, 화면 녹화, 환경 사진 및 localization library 정보 첨부: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
위의 완전한 정보 패키지를 제공하면 문제 분석과 수정 프로세스가 크게 빨라집니다. 협조해 주셔서 감사합니다!