Table of Contents

EIF 데이터 기록: AR 문제 재현을 위한 고해상도 근거

증강 현실(AR) 애플리케이션에서 일부 복잡한 공간 위치 지정 문제(추적 떨림, 가상과 현실의 위치 불일치, 콘텐츠 흔들림 등)는 종종 화면 녹화나 로그만으로는 완전하게 재현하기 어렵습니다. 이를 위해 우리는 EIF 데이터 기록 기능을 제공합니다. 이는 전용 고해상도 데이터 덤프 형식으로 다음과 같은 핵심 정보를 동시에 기록할 수 있습니다.

  • 기기 기본 정보(모델, 시스템, 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 파일을 생성하며, 기기를 컴퓨터에 연결하여 로컬 저장소로 내보낸 후 제출하세요.
참고

EIF 파일이 크게 될 수 있습니다(수백 MB에서 수 GB). 따라서 문제가 포함된 핵심 부분만 기록하는 것이 좋습니다(일반적으로 10 - 30초면 충분합니다).

모범 사례 제안

피드백이 효율적으로 처리되도록 제출할 때 다음 네 가지 유형의 정보를 함께 포함하세요.

정보 유형 설명
EIF 데이터 파일 핵심 진단 근거이며, 문제 재현 과정이 반드시 포함되어야 합니다.
주관적 현상 설명 관찰한 행동을 명확하게 설명합니다(예: “좌회전 시 내비게이션 화살표가 갑자기 천장으로 점프함”).
화면 녹화 또는 스크린샷 문제를 시각적으로 보조하며, “사용자가 최종적으로 보는 화면이 어떻게 되는지”를 직관적으로 보여줍니다.
보조 상황 정보 다음을 포함합니다.
• 기기 모델 및 운영 체제 버전
• 애플리케이션에서 사용하는 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.”

위의 완전한 정보 패키지를 제공하면 문제 분석 및 수정 프로세스를 현저하게 가속화할 수 있습니다. 협조해 주셔서 감사합니다!