Table of Contents

완전히 실행하는 위챗 미니프로그램 Mega 플러그인 샘플 엔지니어링

이 글은 위챗 미니프로그램 Mega 플러그인의 샘플 프로젝트(주석 사용 포함)를 완전히 실행하는 방법을 소개합니다.

시작하기 전에

  • 샘플 엔지니어링 빠르게 실행을 완료합니다.

  • Unity의 Mega Studio로 3D 콘텐츠 배치를 완료하여 주석 데이터 패키지 ID와 주석 포인트 ID를 획득합니다.

    [Block 클라우드 위치 지정] > [주석 데이터] 에서 클라우드 위치 지정 라이브러리 목록의 ID가 주석 데이터 패키지 ID입니다.

    클라우드 위치 지정 라이브러리의 주석 정보

    오른쪽 **[보기]**를 클릭하면 업로드된 주석 데이터 이름과 ID를 확인할 수 있으며, 이 페이지 목록의 ID가 주석 포인트 ID입니다.

    클라우드 위치 지정 라이브러리의 주석 데이터 이름

Mega 주석 데이터 패키지 ID 구성

miniprogram/components/sample-data/easyar-settings.ts에 주석 데이터 패키지 ID를 입력합니다:

/** Mega 주석 데이터 패키지 ID 입력 */
export const MegaAnnotationId: string = "";

주석 포인트에 표시할 모델 구성

miniprogram/components/sample-data/annotation-metadata.ts에서 key를 주석 포인트 id로 변경하여 교체할 주석을 구성합니다. 여러 개를 교체하려면 쉼표로 구분합니다.

export const AnnotationMetaData: Record<string, any> = {
    /** 주석 포인트 ID 입력 */
    "aaaaaaaa-bbbb-cccc-dddd-123456789012": {
        assetId: "panda",
        scale: "1 1 1"
    },
    "aaaaaaaa-bbbb-cccc-dddd-123456789013": {
        assetId: "panda",
        scale: "1 1 1"
    }
};

주석 포인트 ID 기록 및 대응 방법은 주석 데이터 확인을 참조하세요.

실제 기기에서 실행

  1. 미니프로그램 개발 도구 상단 바의 실제 기기 미리보기 버튼을 클릭하여 QR 코드 스캔으로 로드합니다.

    참고

    AR 기능이 있는 xr-frame 컴포넌트는 개발 도구에서 직접 시뮬레이션 실행할 수 없습니다.

    QR 코드 로딩

  2. EasyAR Mega Samples를 클릭하여 샘플 프로젝트의 AR 씬으로 진입합니다.

    샘플 입구

  3. 화면에 EasyAR Session is initializing이 표시되면 위챗 평면 감지가 초기화 중임을 의미합니다.

    팁

    충분한 조명 환경에서 테스트하고, 대면적 단색 벽이나 단색 바닥은 피하세요.

    바닥이나 다른 평면을 향해 휴대폰을 일정한 속도로 좌우로 움직여 이 과정을 가속화하세요.

    초기화

  4. 초기화가 완료되면 휴대폰을 세로로 세워 카메라가 정상적인 현실 화면을 촬영하게 합니다. 위치 지정이 성공하면 debug 정보에 Found 문구가 나타나고 오른쪽 하단 상태 표시기가 녹색으로 변합니다.

    위치 지정

  5. 주석 위치에 GLTF 모델 또는 정육면체(assetId 구성 여부에 따라)가 로드 및 렌더링됩니다.

    실행 효과:

관련 주제