Eif 데이터 기록: AR 문제 재현을 위한 고품질 증거
증강 현실(AR) 애플리케이션에서 특정 복잡한 공간 위치 문제(추적 흔들림, 가상-실체 오정렬, 콘텐츠 이동 등)는 화면 녹화나 로그만으로 완전히 재현하기 어려운 경우가 많습니다. 이를 위해 EIF 데이터 녹화 기능을 제공합니다—특허 출원된 고품질 데이터 덤프 포맷으로, 다음 주요 정보를 동시에 기록합니다:
- 디바이스 기본 정보(모델, OS, SDK 버전 등)
- 타임스탬프가 포함된 카메라 이미지 프레임
- 디바이스의 카메라 내부 파라미터 행렬, 외부 파라미터 행렬
- IMU 센서 데이터
- 외부 보조 입력 추가 데이터(예: GNSS)
왜 Eif 데이터 기록이 중요한가?
중요
문제를 재현할 수 있는 EIF 데이터는 그 가치를 측정할 수 없습니다.
EIF 데이터는 문제 발생 시의 상세한 컨텍스트를 완벽하게 재현하여, 개발 팀이 오프라인 환경에서 사용자가 경험한 시나리오를 정확히 재현할 수 있게 합니다. 이는 문제 진단 효율을 극대화합니다. 화면 녹화나 로그에 비해 EIF는 다음과 같은 장점을 가집니다:
- 정밀 재현: 개발자는 디버깅 도구에서 EIF 데이터를 직접 재생하여 발생한 버그를 재현할 수 있습니다.
- 근본적 진단: 포괄적인 데이터 분석(이미지, 센서, 외부 입력 등)을 통해 기술적 문제 지점을 판단할 수 있습니다.
- 시간 절약: 긴 소통 주기를 피함으로써 문제 보고부터 해결까지의 주기를 크게 단축합니다.
Eif 데이터를 녹화하는 방법
EasyAR은 EIF 데이터 녹화를 위한 두 가지 방법을 제공합니다.
- SDK에서 제공하는 API 인터페이스를 직접 사용하여 애플리케이션 내에 EIF 데이터 녹화 기능을 구현합니다.
- 공식 제공되는 Mega Toolbox App을 사용합니다. 일반적으로 EasyAR Mega 개발 및 문제 보고에 적합합니다.
구체적인 단계는 기술 문서를 참고하여 사용 방식 및 디바이스에 맞는 가이드를 확인하세요.
팁
API 호출을 통해 앱 내 EIF 녹화를 구현하는 방법은 다음 링크 참조: 입력 프레임 녹화 및 시뮬레이션 실행.
Mega Toolbox App 사용 가이드는 다음 링크 참조: Toolbox로 모바일 EIF 파일 녹화하기.
간략한 녹화 절차 개요(Mega Toolbox App 예시):
- Mega Toolbox App 실행 → "현장 위치 테스트 & 위치 문제 보고 데이터 녹화" 클릭.
- 계정 로그인 → 위치 라이브러리 선택 → 테스트 시작.
- 문제를 재현하세요. 안정적으로 문제를 재현할 수 있는 동작 패턴(디바이스 방향, 탐색 방식, 촬영 지점 등)을 찾으세요.
- 준비 완료 시 빨간색 "녹화" 버튼 클릭.
- 문제 발생 후 빨간색 "중지 및 저장" 버튼 클릭.
- 시스템이 자동으로 EIF 파일 생성 → 디바이스를 PC에 연결하여 로컬 저장 후 제출.
참고
EIF 파일 크기가 클 수 있음(수백 MB ~ 수 GB). 문제가 발생하는 핵심 구간만 녹화할 것을 권장(일반적으로 10~30초면 충분).
모범 사례 제안
피드백 처리 효율성을 위해 제출 시 반드시 다음 네 가지 정보를 포함하세요:
| 정보 유형 | 설명 |
|---|---|
| EIF 데이터 파일 | 핵심 진단 근거. 문제 재현 과정이 포함되어야 함 |
| 주관적 현상 설명 | 관찰된 동작 명확히 기술(예: "내비게이션 화살표가 좌회전 시 갑자기 천장으로 이동") |
| 화면 녹화 또는 스크린샷 | 문제 시각화 보조. "사용자가 실제로 본 화면"을 직관적으로 보여줌 |
| 보조 컨텍스트 정보 | 포함 내용: • 디바이스 모델 및 OS 버전 • 애플리케이션에 사용된 EasyAR SDK 버전 • 문제 발생 환경 설명(실내/외부, 조도, 공간 크기) • Mega 앱은 추가 위치 라이브러리 정보 필요(Unity 도구에서 내보내기 가능) • CRS 클라우드 인식 앱은 추가 클라우드 인식 라이브러리 정보 필요 |
팁
예시: "Apple Vision Pro(visionOS 26)에서 EasyAR Sense Unity Plugin 4000.0.1 사용, 실내 쇼핑몰 내비게이션 중 특정 위치에서 내비게이션 경로 갑작스러운 오류 발생. EIF 파일: avp_wrong_path_20251218.mkveif 첨부, 화면 녹화, 환경 사진 및 위치 라이브러리 정보: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."
위 정보 패키지를 완전히 제공하면 문제 분석 및 해결 프로세스가 크게 가속화됩니다. 협조해 주셔서 감사합니다!