Table of Contents

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

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

일반적인 원인과 troubleshooting 방법

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

Image recognition 실패

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

  • image recognition score 확인: target image detection tool을 사용하여 image를 업로드하고 recognition score를 확인합니다. 4-5성에 도달해야 합니다.
  • image 품질 검증: image가 best practices의 texture, 크기 및 비율 요구 사항을 충족하는지 확인합니다.
  • target image entity 확인: poster, card 등 target image entity의 표면이 반사되지 않고 평평하며 접힌 부분이 없는지 확인합니다.
  • logs 확인: application logs를 확인하고 TargetLoad event를 검색하여 target image가 성공적으로 로드되었는지 확인합니다.

개선 제안:

  • image 최적화: 대비를 높이고 반복 pattern을 피하며 주요 피사체가 화면의 70% 이상을 차지하도록 합니다.
  • image 교체: image 최적화 후에도 문제가 계속되면 공식 Sample의 테스트 image, 예를 들어 namecard.jpg를 사용해 문제가 image 자체에 있는지 확인합니다.
  • 물리 entity 보장: target entity는 가능한 한 무광 또는 비교적 거친 표면을 사용하고, 표면을 평평하게 유지하며 접힘이나 휘어짐이 없어야 합니다.
  • 로직 확인: 애플리케이션이 테스트에 사용한 target image를 올바르게 로드했는지 확인합니다.

기능 구현 오류

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

Troubleshooting:

  • ImageTarget 구성 확인:
    • Source 타입에 따라 StreamingAssets 폴더의 올바른 파일을 가리키는지 확인합니다.
    • Scale이 실제 물리 크기로 설정되었는지 확인합니다.
  • prefab hierarchy 확인: Cube와 같은 가상 콘텐츠는 ImageTarget의 child node여야 하며 비활성화되어 있으면 안 됩니다.

개선 제안:

  • 구성 재설정: scene의 ImageTarget을 삭제하고 다시 생성한 뒤, 규격에 따라 prefab을 드래그하고 image를 바인딩합니다.
  • 테스트 단순화: custom scripts를 임시로 제거하고 기본 Cube만 남겨 최소 실행 scene을 확인합니다.
  • logs 확인: ImageTargetController 관련 오류, 예를 들어 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 image entity의 물리 크기와 비교해 가상 콘텐츠의 물리 크기가 적절해야 합니다.

요약 및 모범 사례

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

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

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