진단 및 수정: target 로드 실패
3D object tracking 기능은 입력 3D 모델의 품질에 크게 의존합니다. target model 로드에 실패하면 EasyAR는 개발자가 문제를 찾을 수 있도록 상세 오류 로그를 출력합니다. 이 장에서는 material, texture, model file 세 가지 문제에 대한 일반적인 실패 원인과 해결책을 나열합니다.
Material/Texture Map 파일 오류
이러한 오류는 일반적으로 경로 구성 또는 파일 형식 문제로 인해 발생합니다.
| 로그 정보 | 오류 원인 | 해결 방법 |
|---|---|---|
| Material file not exist | material file(.mtl) 경로가 없거나 올바르게 참조되지 않았습니다 | 모델 폴더에 .mtl 파일이 있는지, .obj 파일의 mtllib 경로가 상대 경로로 올바르게 가리키는지 확인합니다 |
| Current material has no name | material 정의에 이름이 없습니다(newmtl 미지정) |
.mtl 파일에서 각 material에 이름을 추가합니다. 예: newmtl Material1 |
| No texture map exists in material | material에 texture map이 지정되지 않았습니다(map_Ka 또는 map_Kd 누락) |
.mtl 파일에 texture 경로를 추가합니다. 예: map_Kd texture.jpg |
| Read texture map file failed | texture map 파일을 읽을 수 없습니다(경로 오류 또는 지원되지 않는 형식) | texture 파일이 모델 폴더 안에 있고 JPG/PNG 형식이며 경로에 공백이 없는지 확인합니다 |
모델 파일 오류
이러한 오류는 일반적으로 OBJ 파일 형식이 표준에 맞지 않거나 encoding 문제로 인해 발생합니다.
| 로그 정보 | 오류 원인 | 해결 방법 |
|---|---|---|
| Error in opening OBJ file | model file 경로가 없거나 권한이 부족합니다 | 파일 경로를 확인하고 파일을 읽을 수 있는지 확인합니다 |
| Error in reading OBJ file | 파일 읽기 실패(UTF-8이 아닌 encoding 또는 파일 손상) | .obj 파일을 텍스트 편집기로 열고 UTF-8 encoding 형식으로 다시 저장합니다 |
| Material not exist | face가 참조하는 material을 .mtl 파일에서 찾을 수 없습니다 | .obj 파일의 usemtl 필드를 확인하고 .mtl의 newmtl 이름과 일치하는지 확인합니다 |
| Vertex format invalid | vertex 좌표 형식 오류(v 행 데이터가 사양에 맞지 않음) |
v 형식 v x y z(예: v -4.322898 6.063079 -40.241329)을 확인하고 숫자인지 확인합니다 |
| Vertex texture coordinate format invalid | vertex texture coordinate 형식 오류(vt 행 데이터가 사양에 맞지 않음) |
vt 형식 vt u v(예: vt 0.929688 0.094622)을 확인하고 값이 0과 1 사이인지 확인합니다 |
| Face format invalid | face vertex 수가 3보다 작음(f 행 데이터가 유효하지 않음) |
f 행을 확인하고 각 face가 최소 3개의 vertex를 포함하는지 확인합니다 |
| Both vertex index and vertex texture coordinate index are required | face 형식 오류(vertex 또는 texture index 누락) | f 행 형식을 확인하고 vertex와 texture index를 포함하는지 확인합니다(예: f 1/1 2/2 3/3) |
| Vertex index format invalid | face vertex index 오류(index가 범위를 벗어나거나 정수가 아님) | f 행의 vertex index를 확인하고 양의 정수이며 전체 vertex 수를 초과하지 않는지 확인합니다 |
| Vertex texture coordinate index format invalid | face vertex texture coordinate index 오류 | f 행의 texture index를 확인하고 양의 정수이며 전체 texture coordinate 수를 초과하지 않는지 확인합니다 |
모범 사례
로드 오류가 발생하면 위 표의 정보에 따라 점검하십시오. 일반적으로 다음 기본 지침을 따라야 합니다.
- 모델을 Blender나 Maya 같은 전문 도구에서 내보낸 경우 export 시 "write materials"와 "include UVs"(또는 유사 옵션)를 반드시 선택하고 모든 파일이 같은 폴더에 있는지 확인합니다.
- 도구가 내보낸 모델 파일 내부의 참조 경로가 절대 경로일 수 있습니다. 반드시 확인하여 상대 경로로 바꾸고, 파일명에 공백을 피하며, 파일 encoding이 UTF-8인지 확인합니다.
- 모델 형식 및 사양의 자세한 요구 사항은 모델 준비 장을 참조하십시오.
팁: 문제가 여전히 해결되지 않으면 모델 파일과 오류 로그를 패키징하여 EasyAR 공식 포럼 또는 기술 지원을 통해 도움을 받는 것이 좋습니다.