Mega 진단 데이터 수집
이 가이드는 시각 효과 이상에 대한 데이터를 표준화해서 수집하기 위한 지침을 제공합니다. 표준화된 데이터 수집과 피드백 은 개발자가 문제를 정확히 설명하도록 돕고, EasyAR 기술팀이 시각 위치 추정 관련 기술 장애 를 효율적으로 찾고, 재현하고, 해결하도록 돕습니다.
소개
EasyAR Mega 위치 추정 서비스 를 통합하는 과정에서 정확한 데이터 수집은 문제 진단의 핵심 전제입니다. 이 가이드는 다음 핵심 단계를 다룹니다.
- 문제 식별: 일반적인 이상 현상을 분류하고 초기 평가합니다.
- 스크린샷 및 화면 녹화 규범: 다양한 장치 플랫폼 에 대한 시각 증거 방법.
- 런타임 데이터 수집: 각 플랫폼의 런타임 환경 데이터 추출 및 export.
- 피드백 정보 표준: 기술팀이 문제를 재현하는 데 필요한 "최소 정보 세트" 을 보장합니다.
이상 현상 분류 및 초기 판단
문제를 피드백 하기 전에 다음 분류에 따라 이상 현상을 명확히 하십시오.
일반적인 이상 증상
- 완전히 위치 추정 불가: 장면 을 인식할 수 없고 상태 가 계속 "NotFound" 로 표시됩니다.
- 위치 추정 정확도 편차: 위치 추정 은 성공하지만 정확도 가 부족하며 뚜렷한 공간 오프셋 이 있습니다.
- Unstable 위치 추정: 화면 에 흔들림 또는 드리프트 가 발생하거나 트래킹 을 자주 잃습니다.
- 영역별 이상: 특정 영역 또는 특정 지점에서 위치 추정 효과가 좋지 않습니다.
- 장치 호환성 차이: 특정 장치 모델 에서 성능이 좋지 않습니다.
가능한 원인 추정
- 장면 관련: 콘텐츠 배치 오프셋, 낮은 지도 작성 품질, 환경 조명 또는 특징점 부족(예: 넓은 흰 벽), 유사 지점 간섭.
- 기술 환경: network 흔들림, 서비스 요금 미납, QPS 제한 초과, SDK 버전 호환성, API 호출 로직 오류.
- 하드웨어 권한: 장치 센서(IMU)가 motion 트래킹 을 지원하지 않거나 카메라/저장소 권한 이 활성화되지 않음.
표준화된 피드백 절차
문제 해결 효율을 높이기 위해, 다음 세 부분을 포함한 완전한 피드백 패키지 제출을 강력히 권장합니다.
기본 정보 체크리스트(최소 정보 세트)
- 리소스 식별자: 계정 정보, Mega AppId, Block Id.
- 버전 정보: EasyAR Sense SDK version 또는 Mini Program 플러그인 버전.
- 문제 상세: 이상 현상에 대한 자세한 설명 및 트리거 조건.
- 환경 파라미터: 장치 모델, OS 버전, WeChat 버전, 현재 네트워크 환경(4G/5G/WiFi).
시각 증거(동영상 및 스크린샷)
- 재현 과정 화면 녹화: 시작부터 이상 발생까지 위치 추정 과정을 완전하게 녹화합니다.
- Key-frame 스크린샷s: 이상 발생 순간의 화면 snapshot 을 캡처합니다.
- 다중 각도 기록: 서로 다른 위치와 조명 조건에서의 시각 참조 를 제공합니다.
런타임 데이터(핵심 문제 해결 근거)
- EIF 데이터: EasyAR Sense 기반 런타임 기록 로, PC 에서 재생 분석을 지원합니다.
- Dump 데이터: WeChat Mini Program 고유의 런타임 상태 스냅샷.
- 애플리케이션 로그: App 실행 로그(Logcat/Console) 및 오류 스택.
팁
추가 읽기: 문제 세부 정보를 명확하게 전달하는 방법
런타임 환경 및 수집 방법 분류
데이터 수집 방법은 실행 device 와 platform 에 따라 다릅니다. 실제 environment 에 맞는 가이드를 선택하십시오.
Device 분류 설명
- 모바일 장치: 스마트폰(iOS/Android).
- 헤드셋 장치:
- OST (Optical See-Through): Optical see-through, 예: XREAL, Rokid.
- VST (Video See-Through): Video see-through, 예: Apple Vision Pro, PICO.
Screenshot 및 화면 녹화 가이드
| 플랫폼 유형 | 참조 가이드 |
|---|---|
| 휴대폰 / WeChat Mini Program | 휴대폰 스크린샷, 화면 녹화 및 export |
| OST headset | OST 녹화 및 내보내기 |
| VST headset | VST 녹화 및 내보내기 |
런타임 데이터 수집 (EIF/Dump)
| 시나리오 유형 | 수집 방안 |
|---|---|
| EasyAR Sense 네이티브 애플리케이션 | 휴대폰 app EIF recording / Headset EIF recording |
| WeChat Mini Program | Mini Program Dump 데이터 녹화 및 내보내기 |
| 빠른 수집 도구 | Mega Toolbox EIF recording / Toolbox Dump recording |
자동 수집 기능(출시 예정)
자동 수집 및 피드백 지원을 곧 업그레이드하여 더 편리한 데이터 제출 방식을 제공할 예정입니다.
- 백그라운드 녹화: 필요한 데이터 세트 를 백그라운드에서 필요 시 수집 시작
- 자동 업로드: 데이터를 자동으로 패키징하고 EasyAR 기술팀으로 업로드
- 필요 시 캡처: 이상 상태 를 실시간 으로 직접 캡처
- Progress 트래킹: 분류하고 진행 상황 를 지속적으로 추적
작업 가이드 탐색 요약
장치 플랫폼 요구 사항에 따라 상세 작업 가이드 로 바로 이동하십시오.
| Type | Screen recording and 스크린샷 collection guide | 런타임 데이터 수집 guide |
|---|---|---|
| 휴대폰 application | 휴대폰 스크린샷, 화면 녹화 및 export | 휴대폰 app EIF recording, Mega Toolbox EIF recording, EIF 데이터 export instructions |
| OST headset | OST 녹화 및 내보내기 | Headset EIF 녹화 및 내보내기 |
| VST headset | VST 녹화 및 내보내기 | Headset EIF 녹화 및 내보내기 |
| WeChat Mini Program | 휴대폰 스크린샷, 화면 녹화 및 export | WeChat Mini Program Dump 녹화 및 내보내기, WeChat Mini Program Toolbox Dump recording |
모범 사례 권장 사항
- 사전 조사 절차: 프로젝트 출시 전에 팀 구성원이 데이터 수집 절차 에 익숙해지는 것을 권장합니다.
- 먼저 자체 점검: 피드백 전에 기술 환경 문제, 콘텐츠 배치 문제 또는 장치 권한 문제 를 배제했는지 확인하십시오.
- 데이터 완전성: 피드백 최소 정보 세트, 시각 이상 동영상 및 스크린샷, 런타임 데이터 를 표준화된 방식으로 완전하게 수집하십시오.
- 적시 커뮤니케이션: 완전한 데이터를 제출한 후 EasyAR 기술팀과의 커뮤니케이션을 유지하십시오.
기술 지원 채널
- 도움말 문서: Mega 문서 또는 문제 해결을 확인하십시오.
- 기술 지원: 지금 문의하기 또는 support@sightp.com 으로 이메일을 보내십시오.
다음 주제: 휴대폰 스크린샷, 화면 녹화 및 export 방법