Mega 진단 데이터 수집
이 가이드는 표준화된 시각적 이상 현상 데이터 수집 지침을 제공하기 위해 만들어졌습니다. 정형화된 데이터 수집과 피드백을 통해 개발자가 문제를 정확히 기술하고, EasyAR 기술팀이 시각적 위치 추적 관련 기술 장애를 효율적으로 파악, 재현 및 해결하는 데 도움을 줍니다.
내용 소개
EasyAR Mega 위치 서비스 통합 과정에서 정확한 데이터 수집은 문제 진단의 핵심 전제입니다. 본 가이드는 다음 주요 단계를 다룹니다:
- 문제 식별: 흔한 이상 현상을 분류하고 초기 평가합니다.
- 화면 캡처 및 녹화 규정: 다양한 기기 플랫폼에 대한 시각적 입증 방법입니다.
- 실행 데이터 수집: 각 플랫폼의 런타임 환경 데이터 추출 및 내보내기.
- 정보 피드백 기준: 기술팀이 문제를 재현하는 데 필요한 "최소 정보 집합"을 보장합니다.
이상 현상 분류 및 초기 판단
문제를 피드백하기 전에 아래 분류에 따라 이상 현상을 먼저 확인하십시오:
흔한 이상 증상
- 완전히 위치 추적 불가: 장면 인식 불가, 상태가 지속적으로 "NotFound"로 표시됩니다.
- 위치 정확도 오차: 위치 추적 성공했으나 정확도 부족, 뚜렷한 공간적 오프셋이 존재합니다.
- 위치 추적 불안정: 화면 떨림, 드리프트 발생 또는 빈번한 추적 손실.
- 지역적 이상: 특정 구역 또는 지점에서 위치 추적 성능이 저하됩니다.
- 기기 호환성 차이: 특정 모델에서 성능이 낮게 나타납니다.
가능한 원인 추측
- 장면 관련: 콘텐츠 배치 위치 오차, 맵핑 품질 저하, 환경 조명 또는 특징점(예: 대규모 흰 벽) 희소, 유사 지점 간섭 존재.
- 기술 환경: 네트워크 지터링, 서비스 미납, QPS 초과, SDK 버전 호환성, API 호출 로직 오류.
- 하드웨어 권한: 기기 센서(IMU)가 모션 추적 미지원, 카메라 또는 저장소 권한 미활성화.
정형화된 피드백 절차
문제 해결 효율성을 높이기 위해, 다음 세 부분을 포함한 완전한 피드백 패키지 제출을 강력히 권장합니다:
기본 정보 목록 (최소 정보 집합)
- 리소스 식별자: 계정 정보, Mega AppId, Block Id.
- 버전 정보: EasyAR Sense SDK 버전 또는 미니프로그램 플러그인 버전.
- 문제 상세 설명: 이상 현상의 상세 기술 및 발생 조건.
- 환경 파라미터: 기기 모델, OS 버전, WeChat 버전, 현재 네트워크 환경(4G/5G/WiFi).
시각적 증거 (동영상 및 스크린샷)
- 재현 과정 녹화: 시작부터 이상 발생까지의 전체 위치 추적 과정을 기록합니다.
- 키 프레임 스크린샷: 이상 발생 순간의 화면 스냅샷을 캡처합니다.
- 다중 각도 기록: 다른 위치, 다양한 조명 조건에서의 시각적 참고 자료를 제공합니다.
런타임 데이터 (핵심 문제 해결 근거)
- EIF 데이터: EasyAR Sense 기반 런타임 기록, PC에서 재생 분석 지원.
- Dump 데이터: WeChat 미니프로그램 전용 실행 상태 스냅샷.
- 애플리케이션 로그: App 실행 로그(Logcat/Console) 및 오류 스택.
팁
추가 읽기: 문제 상세 소통 방법
실행 환경 및 수집 방법 분류
데이터 수집 방법은 실행 기기와 플랫폼에 따라 다르므로, 실제 환경에 맞는 지침을 선택하십시오.
기기 분류 설명
- 모바일 기기: 스마트폰(iOS/Android).
- 헤드셋 기기:
- OST(Optical See-Through): 광학 투시(예: XREAL, Rokid).
- VST(Video See-Through): 비디오 투시(예: Apple Vision Pro, PICO)
스크린샷 및 화면 녹화 지침
| 플랫폼 유형 | 참고 가이드 |
|---|---|
| 휴대폰 / WeChat 미니프로그램 | 휴대폰 스크린샷 녹화 및 내보내기 |
| OST 헤드셋 | OST 녹화 및 내보내기 |
| VST 헤드셋 | VST 녹화 및 내보내기 |
런타임 데이터 수집 (EIF/Dump)
| 시나리오 유형 | 수집 솔루션 |
|---|---|
| EasyAR Sense 네이티브 앱 | 휴대폰 App EIF 녹화 / 헤드셋 EIF 녹화 |
| WeChat 미니프로그램 | 미니프로그램 Dump 데이터 녹화 및 내보내기 |
| 빠른 수집 도구 | Mega Toolbox로 EIF 녹화 / Toolbox로 Dump 녹화 |
자동 수집 기능 (출시 예정)
자동 수집 및 피드백을 지원하는 기능을 곧 업그레이드할 예정이며, 더 편리한 데이터 제출 방식을 제공합니다:
- 백그라운드 녹화: 필요 시 백그라운드에서 필요한 데이터 세트 수집 시작
- 자동 업로드: 자동 패키징 후 EasyAR 기술팀에 업로드
- 주문형 캡처: 셀프 서비스 실시간 이상 상태 캡처
- 진행 상황 추적: 분류 및 지속적 추적
작업 지침 내비게이션 요약
기기 플랫폼 요구 사항에 따라 상세 작업 가이드로 직접 이동하십시오:
| 유형 | 녹화/스크린샷 수집 가이드 | 런타임 데이터 수집 가이드 |
|---|---|---|
| 휴대폰 앱 | 휴대폰 스크린샷 녹화 및 내보내기 | 휴대폰 앱 EIF 녹화, Mega Toolbox로 EIF 녹화, EIF 데이터 내보내기 설명 |
| OST 헤드셋 | OST 녹화 및 내보내기 | 헤드셋 기기 EIF 녹화 및 내보내기 |
| VST 헤드셋 | VST 녹화 및 내보내기 | 헤드셋 기기 EIF 녹화 및 내보내기 |
| WeChat 미니프로그램 | 휴대폰 스크린샷 녹화 및 내보내기 | WeChat 미니프로그램 Dump 녹화 및 내보내기, WeChat 미니프로그램 Toolbox로 Dump 녹화 |
모범 사례 제안
- 사전 연구 절차: 프로젝트 출시 전 팀원이 데이터 수집 절차를 숙지할 것을 권장합니다.
- 사전 자체 점검: 피드백 전 기술 환경 문제, 콘텐츠 배치 문제 또는 기기 권한 문제 등을 배제했는지 확인합니다.
- 데이터 완전성: 정형화된 완전한 데이터 수집: 최소 정보 집합, 시각적 이상 동영상 및 스크린샷, 런타임 데이터를 피드백합니다.
- 적시 소통: 완전한 데이터 제출 후 EasyAR 기술팀과의 지속적 소통을 유지하십시오.
기술 지원 채널
- 도움말 문서: Mega 문서 또는 문제 해결 참조.
- 기술 지원: 즉시 문의 또는 support@sightp.com으로 이메일 발송.
다음 주제: 휴대폰 스크린샷 녹화 및 내보내기 방법