Table of Contents

Eif 데이터 기록: AR 문제 재현을 위한 고품질 증거

증강 현실(AR) 애플리케이션에서 특정 복잡한 공간 위치 문제(추적 흔들림, 가상-실체 오정렬, 콘텐츠 이동 등)는 화면 녹화나 로그만으로 완전히 재현하기 어려운 경우가 많습니다. 이를 위해 EIF 데이터 녹화 기능을 제공합니다—특허 출원된 고품질 데이터 덤프 포맷으로, 다음 주요 정보를 동시에 기록합니다:

  • 디바이스 기본 정보(모델, OS, SDK 버전 등)
  • 타임스탬프가 포함된 카메라 이미지 프레임
  • 디바이스의 카메라 내부 파라미터 행렬, 외부 파라미터 행렬
  • IMU 센서 데이터
  • 외부 보조 입력 추가 데이터(예: GNSS)

왜 Eif 데이터 기록이 중요한가?

중요

문제를 재현할 수 있는 EIF 데이터는 그 가치를 측정할 수 없습니다.

EIF 데이터는 문제 발생 시의 상세한 컨텍스트를 완벽하게 재현하여, 개발 팀이 오프라인 환경에서 사용자가 경험한 시나리오를 정확히 재현할 수 있게 합니다. 이는 문제 진단 효율을 극대화합니다. 화면 녹화나 로그에 비해 EIF는 다음과 같은 장점을 가집니다:

  1. 정밀 재현: 개발자는 디버깅 도구에서 EIF 데이터를 직접 재생하여 발생한 버그를 재현할 수 있습니다.
  2. 근본적 진단: 포괄적인 데이터 분석(이미지, 센서, 외부 입력 등)을 통해 기술적 문제 지점을 판단할 수 있습니다.
  3. 시간 절약: 긴 소통 주기를 피함으로써 문제 보고부터 해결까지의 주기를 크게 단축합니다.

Eif 데이터를 녹화하는 방법

EasyAR은 EIF 데이터 녹화를 위한 두 가지 방법을 제공합니다.

  1. SDK에서 제공하는 API 인터페이스를 직접 사용하여 애플리케이션 내에 EIF 데이터 녹화 기능을 구현합니다.
  2. 공식 제공되는 Mega Toolbox App을 사용합니다. 일반적으로 EasyAR Mega 개발 및 문제 보고에 적합합니다.

구체적인 단계는 기술 문서를 참고하여 사용 방식 및 디바이스에 맞는 가이드를 확인하세요.

API 호출을 통해 앱 내 EIF 녹화를 구현하는 방법은 다음 링크 참조: 입력 프레임 녹화 및 시뮬레이션 실행.

Mega Toolbox App 사용 가이드는 다음 링크 참조: Toolbox로 모바일 EIF 파일 녹화하기.

간략한 녹화 절차 개요(Mega Toolbox App 예시):

  1. Mega Toolbox App 실행 → "현장 위치 테스트 & 위치 문제 보고 데이터 녹화" 클릭.
  2. 계정 로그인 → 위치 라이브러리 선택 → 테스트 시작.
  3. 문제를 재현하세요. 안정적으로 문제를 재현할 수 있는 동작 패턴(디바이스 방향, 탐색 방식, 촬영 지점 등)을 찾으세요.
  4. 준비 완료 시 빨간색 "녹화" 버튼 클릭.
  5. 문제 발생 후 빨간색 "중지 및 저장" 버튼 클릭.
  6. 시스템이 자동으로 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."

위 정보 패키지를 완전히 제공하면 문제 분석 및 해결 프로세스가 크게 가속화됩니다. 협조해 주셔서 감사합니다!