진단과 수정: 콘텐츠 미표시

이 문서는 3D 오브젝트 트래킹에서 가상 콘텐츠가 표시되지 않는 일반적인 문제에 대한 체계적인 진단 방법과 개선 제안을 제공하여 개발자가 신속하게 문제를 파악하고 해결할 수 있도록 돕습니다.

일반적인 원인과 문제 해결 방법

콘텐츠 미표시는 일반적으로 오브젝트 인식 실패, 기능 구현 오류 또는 권한 제한과 관련됩니다. 다음은 주요 원인 및 진단 단계입니다:

오브젝트 인식 실패

현상: 카메라가 타겟 오브젝트에 정렬된 후에도 가상 콘텐츠가 전혀 나타나지 않음.
진단 방법:

• 모델 품질 확인: 3D 모델 및 오브젝트가 모델 준비의 파일 형식, 텍스처 지오메트리 등 요구 사항을 충족하는지 확인.
• 타겟 오브젝트 확인: 타겟 오브젝트 표면에 반사나 미러 효과가 없는지 확인.
• 로그 확인: 애플리케이션 로그를 확인하여 타겟 모델이 성공적으로 로드되었는지 검토.

개선 제안:

• 모델 최적화: 텍스처가 충분히 풍부하고 지오메트리에 구멍이 없는지 확인.
• 로직 점검: 애플리케이션이 타겟 모델을 올바르게 로드했는지 확인. 로드 실패 시 타겟 로딩 실패 장을 참고하여 점검 및 수정.

기능 구현 오류

현상: 오브젝트는 인식되었으나 가상 콘텐츠가 표시되지 않거나 위치가 이상함.

• Unity
• 네이티브

진단 방법:

• ObjectTarget 구성 확인:
  • Source 유형에 따라 StreamingAssets 폴더 내 올바른 파일을 가리키는지 확인.
  • Scale이 실제 오브젝트 크기에 맞게 조정되었는지 확인 (예: 모델 파일의 BoundingBox 계산 값이 10 x 10 x 30인데 실제 오브젝트 크기가 0.1m x 0.1m x 0.3m라면 Scale은 0.01로 설정되어야 함).
• 프리팹 계층 구조 확인:
  • 가상 콘텐츠는 타겟 3D 모델과 동일한 레벨에 위치하며, 모두 ObjectTarget의 자식 노드여야 함. 가상 콘텐츠가 비활성화되지 않았는지 확인.
  • 타겟 3D 모델의 Rotation 속성에서 Y 축을 180으로 설정.
  • 가상 콘텐츠 배치는 타겟 3D 모델 위치를 완전히 중심으로 이루어져야 함.

개선 제안:

• 구성 재설정: 씬의 ObjectTarget을 삭제하고 재생성한 후 프리팹을 규격에 맞게 드래그 앤 드롭하여 3D 모델 바인딩.
• 로그 확인: ObjectTargetController 관련 오류 (예: fail to load target data) 검색.

권한 문제

현상: 정상 작동하던 기능이 일정 시간 후 콘텐츠가 사라짐.
진단 방법:
다음 상황에 해당하는지 확인:

• XR 헤드셋 사용
• 커스텀 카메라 사용
• 모바일에서 AR Engine/ARFoundation 사용

위 상황 중 하나라면, 평가판 License를 사용 중일 수 있습니다.

개선 제안:

• 정식 License 사용.

가상 콘텐츠 문제

현상: 콘텐츠가 정상 표시되나 카메라가 타겟 오브젝트에 매우 가깝거나/멀리 떨어졌을 때 보이지 않음.
진단 방법:

• 근거리/원거리 클리핑 설정 확인: 가상 콘텐츠 렌더링 시 근거리/원거리 클리핑 설정이 적절한 범위 내에 있는지 확인.
• 콘텐츠 모델 크기 확인: 콘텐츠 모델이 지나치게 클 경우 타겟 근접 시 모델 관통(clipping)으로 인해 보이지 않을 수 있음. 반대로 모델이 너무 작으면 멀리서 볼 때 식별 불가능할 수 있음.

개선 제안:

• 적절한 근거리/원거리 클리핑 값 설정.
• 가상 콘텐츠의 물리적 크기가 타겟 오브젝트 대비 적절한지 확인.

요약 및 모범 사례

콘텐츠 미표시 문제는 일반적으로 오브젝트 3D 모델, 프로그램 구현, 권한 또는 콘텐츠 자체에 의해 발생합니다. 다음 순서로 진단을 권장합니다:

1. License가 정식 버전인지 확인
2. 가상 콘텐츠 자체의 적절성 검토
3. 타겟 3D 모델 품질 확인
4. 프로그램 구현 또는 개발 구성 문제 확인

문제가 지속될 경우, EasyAR 공식 포럼 또는 기술 지원에 로그 파일, 화면 녹화 등을 제공하여 추가 분석을 요청하십시오.