Mega 맵핑 실패 문제 해결 가이드
맵핑 과정에서 업로드 실패, 생성 실패 등의 맵핑 실패 상황이 발생할 수 있으며, 대부분의 문제는 수집 데이터 품질 저하에서 비롯됩니다. 데이터 수집 시 데이터 수집 문서 요구사항을 엄격히 준수하면 장치 매개변수 오류, 경로 계획 부적절 등으로 인한 문제를 방지할 수 있습니다. 수집 문서에 따라 엄격히 수집을 수행했음에도 맵핑 과정에서 여전히 문제가 발생한다면, 본 문서를 참고하여 추가로 문제를 해결하십시오.
What is the normal mapping process
EasyAR Mega Block의 맵핑 프로세스는 주로 데이터 업로드, 경로 생성, 위치 인식 맵 및 조밀 맵 생성 단계로 나뉩니다.
데이터 업로드
GoPro Max/Max2로 수집한 파일 용량이 비교적 큽니다(1시간 동영상 기준 약 30GB). 따라서 네트워크 상태에 따라 업로드 시간이 길어질 수 있습니다. 업로드가 성공하면
Mega Block 맵핑작업의 작업 표시줄에서업로드 파일 보기를 통해 로컬 파일과 파일명 및 수량이 일치하는지 확인해야 합니다. 데이터가 일치하면 데이터 업로드가 정상적으로 이루어진 것입니다. 업로드 성공 후 맵핑 상태는대기 중또는생성 중으로 표시될 수 있으며,.LRV형식 동영상을 온라인으로 재생할 수도 있습니다.
참고
데이터 업로드 과정에서 업로드한 데이터를 검증합니다. 이 과정은 비교적 빠르며, 중간에 오류가 보고되지 않았다면 이 과정을 무시해도 됩니다.
경로 생성
Mega Block 맵핑 시스템은 데이터 수집 시의 경로를 복원해야 하며, 이는 시간이 소요될 수 있습니다. 맵핑 프로세스가 정상적이라면 경로 생성 또는 맵핑 완료 후
Block 맵핑에서 맵핑 경로를 확인할 수 있습니다.사용자가 수집 경로 정상 여부를 확인할 수 있도록, EasyAR은 경로 미리보기 기능을 제공합니다. 맵핑이 완료된 모든 GoPro Max/Max2 데이터에 대해
공간 경로 미리보기기능을 제공하므로, 공간 경로를 통해 데이터 누락 여부를 확인할 수 있습니다.
야외 수집 데이터의 경우 EasyAR은
GPS 경로 미리보기기능도 제공합니다.
Mega Block 맵 생성
Mega Block 맵 생성은 계산량이 많아 이 단계가 상대적으로 오래 걸립니다. 맵핑이 완료되면 작업 상태가
작업 완료로 표시됩니다. 동시에 EasyAR이 제공하는 맵핑 보고서도 확인할 수 있습니다.
GoPro Max/Max2 맵핑 실패 현상 및 처리 방안
데이터 업로드 실패
데이터 업로드 단계에서 네트워크 또는 데이터 영향으로 두 가지 문제가 발생할 수 있습니다: 네트워크 상태가 나쁘면 업로드 진행률 멈춤, 네트워크 중단 등의 문제가 발생할 수 있으며; 수집 데이터에 문제가 있으면 파일 검증을 통과할 수 없습니다.
파일 업로드 실패
대표적 증상: 업로드 진행률이 멈추거나, 되돌아가거나, 네트워크 중단을 알립니다.
발생 원인: 일반적으로 네트워크 환경이 불안정하여 발생하며, 사용자가 직접 처리할 수 있습니다.
먼저 페이지 새로고침 또는 재로그인 시도(로그인 시간 초과 방지)
다시 업로드 클릭: 데이터 폴더를 다시 선택하여 모든 파일 처음부터 업로드(업로드 초기 실패 시 적합).
업로드 계속 클릭: 이전 업로드 실패 데이터 폴더 선택(폴더 내 파일 변경 불가), 실패 파일부터 업로드 재개.
네트워크 최적화: 업로드 중 브라우저 창을 활성 상태로 유지하고, 브라우저 종료, 페이지 새로고침 또는 다른 메뉴 클릭을 금지하며, 네트워크 연결 안정화 및 대용량 네트워크 활동 자제.
참고
EasyAR은 유선 또는 안정적인 무선 네트워크 환경에서 맵핑 데이터를 업로드할 것을 권장합니다. GoPro Max/Max2 파일 용량이 크므로 데이터 통신 사용은 권장하지 않습니다.
파일 검증 미통과
대표적 알림: XXX 동영상이 손상되었습니다!, 다음 파일에서 오류가 감지됨: XXX, XXX 파일명 동영상 프레임 속도 설정 오류!
발생 원인: 동영상 파일 업로드 후 EasyAR 시스템이 파일을 신속 검증하여 부적합 데이터를 선별함으로써 사용자 대기 시간을 단축합니다. 수집 요구사항 미준수, SD 카드 손상 또는 GoPro 장치 문제로 인해 발생할 수 있습니다.
XXX 동영상이 손상되었습니다!또는다음 파일에서 오류가 감지됨: XXX발생 시- GoPro 메모리 카드에서 파일 복사 후 재업로드 시도
- 다른 컴퓨터 또는 브라우저에서 업로드 시도
- 비정상 종료 등 수집 문제 발생 시 재수집 권장
XXX 파일명 동영상 프레임 속도 설정 오류!발생 시- GoPro Max 설정 가이드 또는 GoPro Max2 설정 가이드에 따라 올바른 프레임 속도 설정
참고
페이지 새로고침 후에도 검증을 통과하지 못한다면, EasyAR 수집 규범에 따라 데이터를 재수집해야 합니다.
맵핑 실패
Block 맵핑 상태에서 생성 실패가 표시되면 맵핑 실패 보고서를 확인하십시오.
입력 파일 손상 여부 확인(동영상 화면 깨짐으로 인한 가능성 있음)발생 시 동영상 파일 화면 깨짐 문제 확인 필요.입력 파일 손상 여부 확인(비정상 종료 또는 촬영 시 TF 카드 기록 지연으로 인한 가능성 있음)【동영상 오류 시간: xx s】발생 시 오류 시간 근처 동영상에 이상 유무 확인.내부 오류, 피드백 요청(촬영 과정 중 카메라 미끄러짐, 충돌, 급격한 이동, 완전 암흑 환경 통과, 엘리베이터 이용으로 인한 가능성 있음)발생 시 수집 과정에서 카메라 미끄러짐, 충돌 등 급격한 이동이 발생했거나, 수집원이 엘리베이터를 이용해 비정상 가속도를 얻었거나, 수집 경로에 완전 암흑 환경이 존재함을 의미.입력 파일 손상 여부 확인발생 시 동영상 플레이어로 수집한 동영상을 재생하여 이상 유무 확인.서버 오류, 잠시 후 재시도발생 시 잠시 기다린 후 맵핑 재시도.
팁
맵핑 보고서에 내부 오류, 피드백 요청이 표시되거나 맵핑 보고서에 원인이 명시되지 않은 경우, 맵핑 보고서를 EasyAR 담당자에게 피드백하십시오.
참고
맵핑 보고서에 동영상 오류 시간이 제공되고 입력이 다중 동영상인 경우, 해당 동영상 오류 시점을 직접 환산하십시오.
휴대폰 맵핑 실패
휴대폰 맵핑은 일반적으로 성공률이 높습니다. 실패 시 우선 확인:
- 수집 시 한 자리에 계속 머물렀는지 여부
- 환경 조명이 충분한지 여부
- 카메라를 가렸는지 여부
수집이 정확함을 확인했음에도 실패한다면, 맵핑 보고서를 EasyAR 담당자에게 피드백하십시오.
문제 피드백
상기 자가진단을 완료하고 데이터 자체에 명백한 품질 문제(화면 깨짐 없음, 매개변수 오류 없음)가 없음을 확인했음에도 맵핑이 계속 실패한다면, 아래 표준 절차에 따라 EasyAR 팀에 피드백하십시오.
문제 처리 및 피드백
진짜 문제를 발견했다면, 아래 방식으로 정보 수집 후 피드백하여 기술 팀이 신속히 위치 파악 및 수정할 수 있도록 하십시오:
피드백 정보
기술 팀의 신속한 문제 파악을 위해 반드시 다음 정보를 제공하십시오:
맵핑 보고서: Mega 개발 센터에서 형식의 맵핑 보고서 다운로드(작업 ID, 오류 정보 포함).
수집 계획 경로도: 수집 계획 스크린샷 또는 동영상 제공 시 문제 파악이 더 빠름.
상기 자료를 압축하여 담당 EasyAR 기술 지원 담당자에게 발송하십시오.
피드백 처리 예상
기술진은 맵핑 보고서를 바탕으로 로그 및 원본 데이터를 확인하고 가능한 원인을 분석합니다:
- 심각한 수집 위반(심한 흔들림, 완전 암흑 등): 규범에 따라 재수집 필요
- 알고리즘 매개변수 적응 문제: 고급 맵핑 모드 활성화, 클라우드 매개변수 조정 후 Block 맵 재생성 시도
일반적인 매개변수 조정이 무효할 경우, R&D 팀이 개입하여 해당 데이터가 특정 시나리오 알고리즘 사각지대(극도로 약한 텍스처 등)에 속하는지 분석하고 알고리즘 반복을 통한 수정 가능성 평가합니다.