Table of Contents

이미지 클라우드 인식 위챗 미니프로그램 개발자 가이드

이 장에서는 EasyAR 클라우드 인식과 위챗 미니프로그램의 결합을 통한 주요 기능 및 구현 방법을 소개합니다.

기능 및 사용

위챗 미니프로그램 XR-FRAME은 위챗 공식에서 출시한 XR/3D 애플리케이션 개발 솔루션으로, 하이브리드 렌더링 기술을 통해 네이티브에 가까운 성능을 구현합니다. 시각적 효과와 개발 편의성을 모두 갖추고 있어 AR 애플리케이션을 신속하게 구축할 수 있습니다. 이 프레임워크는 이미지 트래킹, 3D 모델 로딩, 애니메이션 제어, 비디오 재생 및 파티클 효과 등 핵심 기능을 지원하며, WXML 템플릿 기반 프로그래밍을 주요 개발 모델로 합니다. 최소한의 로직 코드만으로도 고품질 시각 효과를 구현할 수 있습니다.

EasyAR 클라우드 인식(CRS) 서비스는 대규모 이미지 라이브러리의 이미지 기반 검색 시나리오에 특화되어 있습니다. 클라우드 기반 알고리즘을 통해 효율적인 타겟 인식을 구현하며, 높은 비용 효율성과 낮은 접근 장벽을 특징으로 합니다. 개발자는 신속하게 통합하여 기능 개발을 완료할 수 있습니다.

데이터 흐름

flowchart TB

B[API or EasyAR Web] --> A[Cloud recognition CRS] <-->  D[Device end WeChat Mini Program]

C[Virtual content] <-->  D[Device end WeChat Mini Program]

XR-FRAME과 클라우드 인식을 결합하면 로컬 장치는 더 이상 타겟 이미지 수의 제약을 받지 않으며, 초대규모 범위 요구 사항을 해결할 수 있습니다.

구현 절차

  1. 클라우드 인식 서비스 호출

    • EasyAR 클라우드 인식(CRS) API를 통해 이미지 인식 요청 시작
    • 인식 결과 처리(성공/실패, 메타 데이터 처리 등)

  2. 트래킹 이미지 구성

    • 인식 결과의 trackingImage를 기반으로 xr-ar-tracker 동적 설정

  3. 가상 리소스 로딩

    • 메타 데이터의 리소스 식별자 파싱
    • xr-asset을 사용하여 3D 모델 또는 비디오 등 가상 자산 다운로드
    • 가상 자산을 장면에 추가하고 리소스 속성 구성(예: 스케일, 초기 위치)

  4. AR 콘텐츠 표시

    • 가상 자산과 인식 마커를 공간적으로 바인딩
    • 가상-실제 융합 렌더링 효과 구현
    • 사용자 상호작용 이벤트 처리(예: 클릭, 드래그)

일반적인 기능

클라우드 인식 결과 획득 후, 위챗 미니프로그램에서 일반적으로 사용되는 AR 기능은 다음과 같습니다:

  • 인식만 수행하고 결과 표시
  • 인식만 수행하고 타겟 이미지와 연동된 비디오, 애니메이션, 모델, 스크립트 표시
  • 인식 + 트래킹을 통한 비디오/애니메이션/모델/스크립트 오버레이

관련 주제