Table of Contents

Diagnosis and repair: content jittering

이 문서는 평면 이미지 트래킹에서 가상 콘텐츠가 떨림, 표류 또는 점프하는 문제를 해결하기 위한 것으로, 개발자가 정상적인 떨림과 비정상적인 떨림을 구분하고 체계적인 점검 및 개선 방안을 제공합니다.

Distinguishing "normal jittering"

다음 상황을 이해하면 과도한 최적화나 문제 오판을 피하는 데 도움이 됩니다:

Minor displacement (normal)

  • 현상: 가상 콘텐츠가 몇 픽셀 단위로 약간 떠다니거나 천천히 회전합니다.
  • 시나리오:
    • 조도 불균일(실내 조명 변화)
    • 카메라 자동 초점 또는 노출 조정 시
    • 기기 미세한 흔들림(삼각대 미사용)
  • 예상: 이러한 시나리오는 피하기 어렵고, 특별한 조치가 필요하지 않습니다.

Brief jittering (normal)

  • 현상: 기기를 빠르게 움직이거나 타겟 이미지를 이동할 때 가상 콘텐츠가 0.5~1초간 떨린 후 안정화됩니다.
  • 시나리오:
    • 정적 상태에서 동적 상태로 전환되는 과정
    • 타겟 이미지가 시야에 진입하는 초기 인식 단계
  • 예상: 알고리즘 수렴 과정에 속하며, 단시간 내 복구되면 정상입니다.

Edge jittering (normal)

  • 현상: 이미지가 카메라 시야 가장자리에 위치하거나 손실 직전일 때 가상 콘텐츠가 미세하게 점프합니다.
  • 시나리오:
    • 이미지 일부가 가려진 경우(손가락으로 가장자리 가림)
    • 카메라 시야 외곽으로 밀려날 때
  • 예상: 트래킹 정보 부분적 손실로 인한 알고리즘 경계 현상으로, 사용자에게 이미지를 시야 중앙에 유지하도록 안내하는 것이 좋습니다.

Anomalous jittering: common causes and improvements

다음 떨림은 문제에 해당하며 대상별 해결이 필요합니다:

Poor target image quality

현상: 가상 콘텐츠가 지속적 고주파 떨림, 불규칙 점프 또는 빈번한 소멸을 보입니다.
점검 방법:

개선 권장:

  • 이미지 최적화:
    • 지역적 대비 증가.
    • 단색 영역 피하고 미세 텍스처 추가.
    • 반복적 텍스처 회피.

Insufficient hardware performance

현상: 중저가 기기에서 고사양 기기 대비 뚜렷한 떨림 또는 더 빈번한 추적 손실 발생.
점검 방법:

  • CPU 사용량 확인: Profiler 도구로 애플리케이션의 CPU 점유율 모니터링.

개선 권장:

  • 성능 모드 활성화: ImageTrackerMode를 PreferPerformance로 설정해 정밀도 일부 희생하여 유연성 확보.
  • 트래킹 수 감소: 다중 타겟 동시 트래킹 활성화 시 Simultaneous Number 적절히 감축.
  • 플랫폼별 최적화: 저사양 기기에 단순화된 장면 제공.

Environmental interference

현상: 특정 조명/배경에서 떨림 발생, 환경 변경 시 정상화.
점검 방법:

  • 조명 테스트: 균일 조명(흐린 날)과 강광/음영 대비 환경에서 각각 테스트.
  • 배경 간섭: 카메라 배경이 지나치게 복잡한지 확인(다수 인원 이동).
  • 반사 간섭: 타겟 이미지 물리적 표면이 반사되는지(유리, 금속).

개선 권장:

  • 조명 제어: 사용자에게 균일 조명 환경에서 사용 권장, 직사광/강한 그림자 회피.
  • 물리적 최적화: 반사 표면의 이미지 경우 무광 코팅 적용 또는 인쇄물로 제작.

Localized content jittering

현상: 가상 콘텐츠 장면이 크고, 타겟 이미지 물리적 개체 근처에서는 떨림이 작으나, 멀어질수록 뚜렷한 떨림 발생.
점검 방법:

  • 콘텐츠 축소: 장면 내 가상 콘텐츠의 Scale을 통일해 축소한 후 동일 환경/조건에서 재테스트.

개선 권장:

  • 콘텐츠 적절 조정: 과대한 가상 콘텐츠는 타겟 개체에서 멀어질수록 각도 오차 증폭 효과 발생(예: 0.1° 각도 오차가 근처에서는 0.1cm 정렬 오차이나, 원거리에서는 10cm로 증폭). 가상 콘텐츠를 설계할 때 타겟 이미지의 물리적 크기 대비 적절히 조정 필요.

Summary and best practices

콘텐츠 떨림은 정상적 떨림(미세 변위, 일시적 복구 등)과 비정상적 떨림(고주파 점프, 빈번한 손실 등)을 구분해야 합니다. 전자는 특별 조치 불필요, 후자는 사용자 경험에 영향을 주므로 다음 순서로 점검 권장:

  1. 타겟 이미지 품질 확인;
  2. 특정 기기 성능 한계에 의한 현상인지 확인;
  3. 환경 요인(조명, 동적 장면, 반사 표면 등) 간섭 배제;
  4. 가상 콘텐츠 자체의 과대 여부 확인.

문제 지속 시 EasyAR 공식 포럼 또는 기술 지원을 통해 로그 파일, 화면 녹화 등을 제공해 추가 분석 가능.