Table of Contents

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

이 문서는 평면 이미지 추적에서 가상 콘텐츠가 표시되지 않는 일반적인 문제에 대한 체계적인 점검 방법과 개선 제안을 제공하여 개발자가 신속하게 문제를 파악하고 해결할 수 있도록 돕습니다.

일반적인 원인과 점검 방법

콘텐츠가 표시되지 않는 문제는 일반적으로 이미지 인식, 기능 구현 오류 또는 권한 제한과 관련됩니다. 다음은 주요 원인 및 점검 단계입니다:

이미지 인식 실패

증상: 카메라가 대상 이미지에 정렬된 후 가상 콘텐츠가 전혀 나타나지 않음.
점검 방법:

  • 이미지 인식도 확인: 타겟 이미지 검사 도구를 사용하여 이미지를 업로드하고 인식도 점수(4~5점 필요)를 확인하세요.
  • 이미지 품질 검증: 이미지가 모범 사례의 질감, 크기 및 비율 요구사항을 충족하는지 확인하세요.
  • 대상 이미지 실물 확인: 대상 이미지 실물(포스터, 카드 등)의 표면에 반사가 없고, 접힘 없이 평평한 상태인지 확인하세요.
  • 로그 확인: 애플리케이션 로그를 확인하고 TargetLoad 이벤트를 검색하여 대상 이미지가 성공적으로 로드되었는지 확인하세요.

개선 제안:

  • 이미지 최적화: 대비 증가, 반복 패턴 피하기, 주체가 화면의 70% 이상 차지하도록 하기.
  • 이미지 교체: 이미지 최적화 후에도 문제가 지속되면, 공식 샘플의 테스트 이미지(예: namecard.jpg)를 사용하여 문제가 이미지 자체에 있는지 확인하세요.
  • 실물 확인: 대상 실물은 무광 또는 거친 표면을 사용하고, 접히거나 휘어짐 없이 평평한 상태를 유지하세요.
  • 로직 확인: 애플리케이션이 테스트에 사용된 대상 이미지를 올바르게 로드했는지 확인하세요.

기능 구현 오류

증상: 이미지는 인식되었으나 가상 콘텐츠가 표시되지 않거나 위치가 이상함.

점검 방법:

  • ImageTarget 구성 확인:
    • Source 유형에 따라 StreamingAssets 폴더 내 올바른 파일을 가리키는지 확인하세요.
    • Scale이 실제 물리적 크기로 설정되었는지 확인하세요.
  • 프리팹 계층 구조 확인: 가상 콘텐츠(예: Cube)는 반드시 ImageTarget의 자식 노드여야 하며 비활성화되지 않았는지 확인하세요.

개선 제안:

  • 구성 재설정: 씬의 ImageTarget을 삭제하고 재생성한 후, 프리팹을 규정에 따라 드래그 앤 드롭하고 이미지를 바인딩하세요.
  • 테스트 간소화: 사용자 정의 스크립트를 일시적으로 제거하고 기본 Cube만 남겨 최소 실행 가능 씬을 확인하세요.
  • 로그 확인: ImageTargetController 관련 오류(예: fail to load target data)를 검색하세요.

권한 문제

증상: 원래 정상 작동했으나, 일정 시간 실행 후 콘텐츠가 사라짐.
점검 방법:
다음 중 하나에 해당하는지 확인하세요:

  • XR 헤드셋에서 사용 중
  • 사용자 정의 카메라 사용 중
  • 휴대폰에서 AR Engine/ARFoundation 사용 중

위 경우 중 하나라면, 평가판 라이선스를 사용 중일 수 있습니다.

개선 제안:

  • 정식 라이선스를 사용하세요.

가상 콘텐츠 문제

증상: 콘텐츠가 원래 정상 표시되었으나, 카메라가 대상 물체에 매우 가깝거나/멀리 있을 때 콘텐츠가 보이지 않음.
점검 방법:

  • 근/원거리 클리핑(near/far clip) 설정 확인: 가상 콘텐츠 렌더링 시 근/원거리 클리핑 설정이 합리적인 범위 내에 있는지 확인하세요.
  • 콘텐츠 모델 크기 확인: 콘텐츠 모델이 지나치게 클 경우, 대상 물체에 가까워지면 모델을 뚫고 지나가 콘텐츠가 보이지 않을 수 있습니다. 모델이 지나치게 작을 경우, 대상 물체에서 멀어지면 너무 작게 표시되어 보이지 않을 수 있습니다.

개선 제안:

  • 적절한 근/원거리 클리핑 값을 설정하세요.
  • 가상 콘텐츠의 크기가 대상 이미지 실물의 물리적 크기에 비해 적절한지 확인하세요.

요약 및 모범 사례

콘텐츠 미표시 문제는 일반적으로 이미지, 프로그램 구현, 권한 또는 콘텐츠 자체에 의해 발생합니다. 다음 순서대로 점검할 것을 권장합니다:

  1. 라이선스가 정식 버전인지 확인
  2. 가상 콘텐츠 자체가 적절한지 확인
  3. 대상 이미지 품질 검증
  4. 프로그램 구현 또는 개발 구성에 문제가 없는지 확인

문제가 지속되면, EasyAR 공식 포럼 또는 기술 지원을 통해 로그 파일, 화면 녹화 등을 제공하여 추가 분석을 요청하세요.