Table of Contents

진단 및 수정: 콘텐츠가 표시되지 않음

이 문서는 3D object tracking에서 가상 콘텐츠를 표시할 수 없는 일반적인 문제를 다룹니다. 개발자가 문제를 빠르게 찾고 해결할 수 있도록 체계적인 troubleshooting 방법과 개선 제안을 제공합니다.

일반적인 원인과 troubleshooting 방법

콘텐츠가 표시되지 않는 문제는 일반적으로 object recognition 실패, 기능 구현 오류 또는 permission 제한과 관련됩니다. 주요 원인과 troubleshooting 단계는 다음과 같습니다.

Object recognition 실패

증상: 카메라를 target object에 맞춘 후 가상 콘텐츠가 전혀 나타나지 않습니다. Troubleshooting:

  • 모델 품질 확인: 3D model 및 object가 model preparation의 file format, texture, geometry 등 요구 사항을 충족하는지 확인합니다.
  • target object 확인: target object 표면에 반사 또는 거울 같은 material이 없는지 확인합니다.
  • logs 확인: application logs를 확인하고 target model이 성공적으로 로드되었는지 확인합니다.

개선 제안:

  • 모델 최적화: textures가 충분히 풍부하고 geometry에 구멍이 없는지 확인합니다.
  • 로직 확인: 애플리케이션이 target model을 올바르게 로드했는지 확인합니다. 로드 실패 시 target loading failure를 참고하여 검사하고 수정합니다.

기능 구현 오류

증상: object가 인식되었지만 가상 콘텐츠가 표시되지 않거나 위치가 비정상입니다.

Troubleshooting:

  • ObjectTarget 구성 확인:
    • Source 타입에 따라 StreamingAssets 폴더의 올바른 파일을 가리키는지 확인합니다.
    • Scale이 object의 실제 크기에 따라 수정되었는지 확인합니다. 예를 들어 모델 파일에서 계산된 BoundingBox 크기가 10 x 10 x 30이고 object의 실제 크기가 0.1m x 0.1m x 0.3m라면 Scale은 0.01로 설정해야 합니다.
  • prefab hierarchy 확인:
    • 가상 콘텐츠는 target 3D model과 같은 레벨에 있어야 하며, 둘 다 ObjectTarget의 child nodes여야 합니다. 가상 콘텐츠는 비활성화되어 있으면 안 됩니다.
    • target 3D model의 Rotation 속성은 Y 방향을 180으로 설정해야 합니다.
    • 가상 콘텐츠의 배치는 target 3D model의 위치를 완전히 기준으로 해야 합니다.

개선 제안:

  • 구성 재설정: scene의 ObjectTarget을 삭제하고 다시 생성한 뒤, 규격에 따라 prefab을 드래그하고 3D model을 바인딩합니다.
  • logs 확인: ObjectTargetController 관련 오류, 예를 들어 fail to load target data를 검색합니다.

Permission 문제

증상: 원래 정상적으로 사용되었지만 일정 시간 실행 후 콘텐츠가 사라집니다. Troubleshooting: 다음 상황 중 하나에 해당하는지 확인하십시오.

  • XR headset에서 사용
  • custom camera 사용
  • 휴대폰에서 AR Engine/ARFoundation 사용

위 상황 중 하나라면 trial License를 사용 중일 수 있습니다.

개선 제안:

  • 공식 License를 사용합니다.

가상 콘텐츠 문제

증상: 콘텐츠가 원래 정상적으로 표시되었지만 카메라가 target object에 매우 가깝거나 멀 때 콘텐츠가 보이지 않습니다. Troubleshooting:

  • near/far clipping 설정 확인: 가상 콘텐츠를 rendering할 때 near/far clipping 설정이 합리적인 범위에 있는지 확인합니다.
  • content model 크기 확인: content model이 너무 크면 target object에 가까워질 때 모델을 통과해 콘텐츠가 보이지 않을 수 있습니다. content model이 너무 작으면 target object에서 멀어질 때 표시가 너무 작아 명확히 보기 어려울 수 있습니다.

개선 제안:

  • 적절한 near/far clipping을 설정합니다.
  • target object의 물리 크기와 비교해 가상 콘텐츠의 물리 크기가 적절해야 합니다.

요약 및 모범 사례

콘텐츠가 표시되지 않는 문제는 일반적으로 object 3D model, 프로그램 구현, permission 또는 콘텐츠 자체로 인해 발생합니다. 다음 순서로 troubleshooting하는 것을 권장합니다.

  1. License가 공식 버전인지 확인;
  2. 가상 콘텐츠 자체가 적절한지 확인;
  3. target 3D model 품질 확인;
  4. 프로그램 구현 또는 개발 구성에 문제가 있는지 확인.

문제가 계속되면 EasyAR 공식 포럼 또는 기술 지원을 통해 log files, 화면 녹화 등 자료를 제공하여 추가 분석을 진행할 수 있습니다.