Table of Contents

이미지 클라우드 인식 소개

이 문서는 EasyAR CRS(Cloud Recognition Service) 클라우드 인식 기능의 핵심 원리, 기대 효과 및 평면 이미지 추적과의 차이점을 소개하여 개발자가 클라우드 인식의 적용 시나리오와 제한 사항을 이해할 수 있도록 돕습니다.

기본 원리

클라우드 인식(Cloud Recognition) 은 인식 프로세스를 클라우드로 이동하는 솔루션으로, 대상 라이브러리가 방대하거나 동적 업데이트가 필요한 시나리오에 적합합니다. 핵심 프로세스는 다음과 같습니다.

갤러리 관리

  1. 갤러리 생성: CRS 콘솔에서 대상 이미지를 업로드합니다. 시스템은 자동으로 대상 이미지의 시각적 특징을 계산하여 백엔드 데이터베이스에 타겟(Target)으로 추가합니다.
  2. 추가/삭제/수정/조회: CRS 콘솔에서 대상 라이브러리에 대한 추가, 삭제, 수정, 조회 등의 작업을 수행할 수 있습니다. 작업 완료 후 클라이언트는 앱을 업데이트할 필요 없이 즉시 사용할 수 있습니다.
중요

클라우드 인식에 사용되는 대상 이미지에 대한 품질 요구사항은 평면 이미지 추적에서의 요구사항과 완전히 동일합니다. 자세한 내용은 대상 이미지 최적 사례를 참조하세요.

인식 프로세스

  1. 이미지 업로드: 클라이언트가 카메라로 현재 화면을 캡처하여 이미지 데이터를 EasyAR CRS 서비스로 전송합니다.
  2. 클라우드 매칭: 서버는 클라우드 대상 라이브러리에서 신속하게 검색하여 사전 저장된 타겟 데이터(개발자가 업로드한 대상 이미지)와 매칭합니다.
  3. 결과 반환: 매칭 성공 시 클라우드는 인식 결과(타겟 ID, 대상 이미지 등)를 클라이언트로 반환합니다. 클라이언트는 이를 기반으로 가상 콘텐츠를 표시하거나 이미지를 활용하여 후속 추적을 진행합니다.

평면 이미지 추적과의 차이

특성 평면 이미지 추적(로컬) 클라우드 인식(클라우드)
인식 계산 디바이스 로컬에서 완료 클라우드 서버에서 완료
대상 라이브러리 크기 메모리 제한 및 로딩 시간의 절충으로, 일반적으로 100장을 초과하지 않는 것이 권장됨 단일 라이브러리 최대 10만 장의 대상 이미지, 수억 장 규모로 확장 가능
대상 업데이트 앱 재패키징 및 재배포 필요 실시간 업로드, 즉시 적용
네트워크 의존성 네트워크 불필요(오프라인 사용 가능) 네트워크 필수(인식 요청 시 네트워크 필요)
기능 중점 인식 및 지속적인 추적(6DoF 포즈 출력) 일회성 인식(대상 매칭)

핵심 설명:

  • 인식(Recognition): "이것이 무슨 대상인가"의 매칭만 수행하며 지속적인 추적을 제공하지 않습니다. 추적이 필요한 경우 로컬 평면 이미지 추적 기능과 결합해야 합니다.
  • 적용 시나리오: 대상 수가 많은 경우(예: 상품 라이브러리, 어린이 그림책), 빈번한 업데이트가 필요한 경우(예: 이벤트 포스터) 또는 기능 요구가 단순한 경우(예: 인식만 필요하고 추적은 필요하지 않은 경우).

서비스 사용 및 관리

EasyAR CRS는 개인 개발부터 엔터프라이즈급 애플리케이션까지 다양한 요구를 지원하는 유연하고 안전한 클라우드 대상 관리 솔루션을 제공합니다.

갤러리 격리 및 보안

  • 다중 갤러리 지원: 독립적인 여러 CRS 갤러리를 생성할 수 있으며, 각 갤러리는 완전히 격리되어 대상이 충돌하지 않습니다. 예시:
    • 갤러리 A: 마케팅 캠페인용, 제품 포스터 저장.
    • 갤러리 B: 교육 훈련용, 교재 삽화 저장.
  • 보안 메커니즘: 각 갤러리는 고유한 API Key와 Secret으로 접근하여 데이터 보안을 보장합니다.

동시 처리량 모드 선택

애플리케이션 규모 및 스캔량 요구에 따라 CRS는 두 가지 동시 모드를 제공합니다:

모드 적용 시나리오 특징 개통 방식
기본 동시 처리량 AR 애플리케이션 QPS < 50, 일반 스캔량 셀프 서비스 개통, 안정적이고 신뢰성 있음 CRS 콘솔에서 온라인 신청
고동시 처리량 AR 애플리케이션 QPS ≥ 50, 대량 트래픽 스캔 전용 리소스 보장, 저지연 EasyAR 기술 지원에 문의하여 평가 후 개통

스타트업 프로젝트 또는 테스트 단계에서는 기본 모드를 선택할 수 있으며, 애플리케이션 출시 후 실제 트래픽(예: QPS 인식 요청량 모니터링)에 따라 업그레이드 여부를 결정하세요.

갤러리 관리 및 API

  • 갤러리 관리: 일상 작업(예: 생성, 삭제, 대상 업로드)은 갤러리 관리 챕터를 참조하세요. 상세 단계 및 스크린샷이 포함되어 있습니다.
  • CRS API: 풍부한 REST API를 제공하여 다음 시나리오를 지원합니다:
    • 헬스 체크: API를 통해 서비스 상태를 조회합니다.
    • 자동화: 대상 일괄 업로드, 삭제, 수정, 조회.
    • 유틸리티: 대상 인식도 점수화, 유사성 충돌 검사.
참고

CRS는 SDK, 위챗 미니프로그램, Web 등을 통해 통합 사용을 지원합니다. SDK를 통한 통합은 EasyAR Sense v2.0.0 이상 버전에서만 지원됩니다.

효과 및 기대 결과

클라우드 인식의 실제 성능을 이해하면 개발자가 프로젝트 목표를 합리적으로 설정할 수 있습니다. 다음은 전형적인 시나리오에서의 효과 설명입니다:

이상적인 효과

  • 인식 속도 빠름: 촬영부터 결과 반환까지 지연 시간 < 1초(네트워크 양호 시).
  • 인식 정확도 높음: 대상 이미지가 선명하고 네트워크가 안정된 경우, 정확률 > 98%.
  • 대규모 대상 라이브러리 지원: 단일 라이브러리로 최대 10만 개의 대상 인식 이미지 관리 가능.
  • 실시간 업데이트: 새 대상 업로드 후 클라이언트 업데이트 없이 즉시 인식 가능(네트워크 연결만 필요).

비이상적인 경우 및 대응

현상 원인 사용자 체감 해결 방안
인식 지연 높음 네트워크 불량, 이미지 업로드 느림 결과가 나타나기까지 수 초 대기 필요 앱에서 적절한 안내 메시지 표시
인식 실패 이미지 흐림, 대상이 클라우드에 업로드되지 않음 가상 콘텐츠가 나타나지 않음 CRS 대상 라이브러리 상태 점검, 사용자에게 디바이스 고정 유도
대상 충돌 대상 라이브러리에 유사 이미지 과다 잘못된 대상 인식 대상 이미지 최적화, 차별성 강화. 또는 유사 이미지를 별도 라이브러리로 분리 관리

기대 결과 검증 방법

  • 개발 단계: EasyAR CRS 콘솔에 테스트 대상 업로드 후 HelloARCRS 샘플로 인식 프로세스 검증 및 애플리케이션 로직 숙지, 이후 자체 애플리케이션에 통합.
  • 테스트 단계: 자체 애플리케이션을 사용하여 약한 네트워크 환경, 대상 이미지 동적 업데이트, 클라우드 갤러리 크기 증가 등 다양한 조건에서 인식 성공률 테스트.

최적 사례

클라우드 인식은 클라우드 컴퓨팅을 통해 대상 라이브러리 용량과 동적 업데이트 능력을 확장하지만, 오프라인 기능과 실시간 추적을 희생합니다. 개발자는 프로젝트 요구사항(대상 수량, 업데이트 빈도, 네트워크 환경 등)에 따라 솔루션을 선택해야 합니다: 소규모 정적 시나리오에는 로컬 추적, 대규모 동적 시나리오에는 클라우드 인식.

CRS 사용 시 다음과 같은 모드로 개발하는 것을 권장합니다:

  • 테스트 단계: 기본 동시 처리량 모드 사용, 소량의 대상으로 프로세스 검증.
  • 출시 전: 예상 동시 처리량 평가, 기술 지원에 미리 문의하여 고동시 처리량 모드로 업그레이드(1~2 영업일 소요).
  • 운영 단계: 정기적으로 API를 사용하여 갤러리 건강 상태 모니터링, 서비스 안정성 보장.
중요

계절성 트래픽 피크 예고: 애플리케이션이 휴일, 대형 이벤트 또는 마케팅 캠페인 기간 동안 일시적인 동시 처리량 급증이 예상되는 경우, 인식 서비스 사용 제한을 피하기 위해 반드시 최소 3영업일 전에 EasyAR 기술 지원에 서비스 업그레이드를 신청하세요.

또한, 애플리케이션에 대규모 갤러리가 필요하면서 대상 이미지 추적 요구사항이 있는 경우, 클라우드 인식과 평면 이미지 추적 기능을 결합하여 사용할 수 있습니다. 구체적인 소개 및 설명은 평면 이미지 추적과 결합 챕터를 참조하세요.

플랫폼 전용 가이드