빠르게 실행하기: 위챗 미니프로그램 Mega 플러그인 예제 프로젝트

이 글은 위챗 미니프로그램 Mega 플러그인 예제 프로젝트를 빠르게 실행하는 방법을 소개합니다. 다음을 배우게 됩니다:

예제 프로젝트의 개발 환경 구축 및 구성.
예제의 일부 기능 실행: Mega 클라우드 로컬라이제이션 사용하기.

시작하기 전에

문서 내 로컬라이제이션 라이브러리를 사용할 수 있나요?를 참고하여 로컬라이제이션 라이브러리가 올바르게 생성되고 Mega Block이 추가되었는지 확인하세요.

미니프로그램 주체가 기업 주체인지 확인

[!중요] Mega 미니프로그램 플러그인은 기업 주체의 위챗 미니프로그램만 지원합니다. 개인 주체 유형의 미니프로그램은 Mega 미니프로그램 플러그인을 사용할 수 없습니다.

미니프로그램 백엔드에서 설정 > 기본 정보 > 주체 정보가 기업 법인 또는 개인사업자로 표시되는지 확인해야 합니다.

Mega 기능은 미니프로그램 플러그인 형태로 제공되므로, 호스트 환경으로 사용할 기업 주체의 위챗 미니프로그램을 보유해야 합니다.

제공된 예제 프로젝트를 실행하기 위해서조차도, 개발자 도구에서 디버깅 및 미리 보기를 하려면 자신의 위챗 미니프로그램 AppID를 구성해야 합니다.

예제 프로젝트 다운로드

개발 도구 다운로드 페이지로 이동합니다.
_EasyAR 개인정보 보호정책_을 확인한 후 다운로드를 클릭합니다.
다운로드가 완료되면 로컬에서 .zip 패키지의 압축을 풉니다.

예제 프로젝트 구성

위챗 미니프로그램 개발자 도구에 로그인합니다.
위챗 미니프로그램 개발자 도구를 사용하여 샘플 프로젝트를 가져옵니다.
- 개발자 도구를 연 후 가져오기 버튼을 클릭하고, 로컬에서 압축 해제된 디렉터리를 선택하세요.
- AppID가 Mega 라이선스를 신청할 때 작성한 AppID와 일치하는지 확인하고, 개발 모드를 미니프로그램으로 설정한 후 생성(Create)을 클릭하세요.
참고

AppID가 불일치하면 라이선스 검증이 실패합니다.
Mega 라이선스 및 클라우드 서비스 구성

miniprogram/components/sample-data/easyar-settings.ts 파일을 열고, 준비 작업에서 얻은 라이선스 및 서비스 정보를 해당 파일의 해당 필드에 입력하세요:
- Mega 라이선스
```
/** 귀하의 미니프로그램 Mega 라이선스 */
export const EasyARLicenseKey: string = "";
```
Mega 위챗 미니프로그램 라이선스 획득 방법

EasyAR 개발 센터에서 Mega 위챗 미니프로그램을 선택하세요.

목록에 사용하려는 Mega 위챗 미니프로그램 라이선스가 있어야 합니다. (사용 가능한 라이선스가 없는 경우, 귀하의 계정과 Mega 위치 데이터베이스 생성에 사용된 계정이 동일한지 확인하세요.)

미니프로그램 이름을 클릭하여 해당 미니프로그램의 Mega 라이선스를 얻을 수 있습니다. (오른쪽의 복사 버튼을 클릭한 후 easyar-settings.ts 파일의 EasyARLicenseKey 값으로 붙여넣으세요.) 그리고 연결된 AppID가 귀하의 위챗 미니프로그램 AppID와 완전히 일치하는지 확인하세요.
- 클라우드 서비스 API Key 및 Seceret
```
/** 귀하의 클라우드 서비스 API Key 및 Seceret */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
클라우드 서비스 API Key 및 Seceret 획득 방법

EasyAR 개발 센터에서 클라우드 서비스 API KEY를 선택하세요.

이전에 클라우드 서비스 API Key 및 Seceret을 생성한 적이 있다면, 여기서 오른쪽의 복사 버튼을 차례로 클릭하여 easyar-settings.ts 파일의 EasyARAPIKey 및 EasyARAPISecret 값으로 붙여넣으세요.

이전에 클라우드 서비스 API Key 및 Seceret을 생성한 적이 없다면 다음 방법으로 생성할 수 있습니다:

EasyAR 개발 센터에서 클라우드 서비스 API KEY > API KEY 생성을 선택하세요.

애플리케이션 이름을 입력하고, 사용할 클라우드 서비스: Mega Block 및/또는 Mega Landmark 를 선택한 후 확인을 클릭하세요.
- 클라우드 서비스 ServerAddress 및 AppID:
```
/** 귀하의 Mega 클라우드 위치 데이터베이스의 ServerAddress 및 AppID */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
Mega 클라우드 위치 데이터베이스의 ServerAddress 및 AppID 획득 방법

EasyAR 개발 센터에서 Block 클라우드 위치를 선택한 후, 귀하의 Mega 클라우드 위치 서비스 그룹을 선택하세요.

귀하의 Mega 클라우드 위치 데이터베이스를 선택하세요:

**키(Key)**를 클릭하고, 아래에서 클라우드 위치 데이터베이스의 AppID와 Server Address를 차례로 획득하세요 (오른쪽의 복사 버튼을 클릭한 후 easyar-settings.ts 파일의 MegaTrackerAppID 및 MegaTrackerServerAddress 값으로 붙여넣으세요).

실제 기기에서 예제 실행

개발 도구 상단 바의 실기 프리뷰 버튼을 클릭하여 QR 코드를 스캔해 개발용 휴대폰에 로드합니다.

주의

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

참고

위챗 개발자 도구에서 샘플 프로젝트를 처음 실행할 때, 플러그인 권한이 아직 부여되지 않은 경우 도구가 일반적으로 플러그인 미승인 팝업을 표시합니다. 위챗 개발자 도구를 통해 자동으로 권한을 부여하거나 플러그인 접속 절차를 참조할 수 있습니다.
EasyAR Mega Samples를 클릭해 샘플 프로젝트의 AR 장면으로 진입합니다.

참고

샘플 프로젝트의 AR 장면으로 진입할 수 없는 경우, 현재 기기가 위챗의 시각 알고리즘 컴포넌트 VisionKit를 지원하지 않기 때문일 수 있습니다. 자세한 내용은 기종 제한을 참조하세요.
화면에 EasyAR Session is initializing이 표시되면 위챗 평면 감지가 초기화 중임을 의미합니다.

팁

충분한 빛이 있는 환경에서 테스트하고, 대면적 단색 벽이나 바닥을 피하세요.

이 과정을 가속화하려면 바닥이나 다른 평면을 향해 휴대폰을 일정하게 좌우로 움직이세요.
초기화 완료 후, 휴대폰을 수직으로 세워 카메라가 정상적인 실제 화면을 촬영하도록 합니다. 추적에 성공하면 디버그 정보에 Found가 나타나고, 우하단 상태 표시기가 흰색에서 녹색으로 변합니다.

Table of Contents