WeChat Mini Program 문제 보고서

EasyAR가 제공하는 기능(Mega 또는 CRS)을 사용하는 WeChat Mini Program을 개발하거나 사용할 때 발생한 문제를 빠르고 정확하게 파악할 수 있도록, 피드백을 제출하기 전에 이 가이드를 참조하고 필요한 정보와 데이터를 제공하십시오. 이렇게 하면 문제 조사 과정의 왕복 커뮤니케이션 시간을 크게 줄일 수 있습니다.

문제 사전 점검

문제를 보고하기 전에 몇 가지 기본 방법을 시도하거나 문서를 읽어 먼저 빠르게 해결할 수 있는지 확인할 수 있습니다.

Mega 플러그인 사용:

• 2.x 버전의 Mini Program 플러그인을 사용하고 있는지 확인하십시오. 1.x 버전의 Mega Mini Program 플러그인은 더 이상 유지보수되지 않습니다
• Mega 플러그인 알려진 문제 및 제한을 읽고 알려진 문제인지 확인하십시오.
• Mega Sample 또는 CRS Sample의 구현 방식을 참고하여 수정하고 문제가 여전히 존재하는지 확인하십시오.

피드백 시 필요한 데이터

완전한 문제 보고서에는 일반적으로 다음 데이터가 포함되어야 EasyAR 개발팀이 정확한 분석을 수행할 수 있습니다.

실행 환경 데이터

• 기기 모델: wx.getDeviceInfo().model로 가져올 수 있습니다.
• WeChat 클라이언트 플랫폼: wx.getDeviceInfo().system으로 가져옵니다.
• WeChat 버전 번호: wx.getAppBaseInfo().version으로 가져옵니다.
• WeChat Mini Program 클라이언트 base library 버전: wx.getAppBaseInfo().SDKVersion으로 가져옵니다.
• Mega 플러그인을 사용하는 경우 사용한 Mega 플러그인 버전: 프로젝트 app.json 파일의 plugins 필드 안 version 필드에서 가져올 수 있습니다.

[Mega] AR Session dump 파일(매우 중요)

문제를 재현할 수 있는 AR Session dump 파일은 WeChat Mini Program에서 로컬라이제이션 및 tracking 문제를 분석하는 데 가장 중요한 데이터입니다.

dump 파일 기록 및 전달 구현은 Mini Program을 사용하여 AR Session dump 파일을 기록하는 방법을 참조하십시오.

또한 로컬라이제이션 문제를 안정적으로 재현할 수 있다면 Mega toolbox를 사용하여 이 데이터를 기록하고 전달할 수도 있습니다. WeChat Mini Program Mega Toolbox를 사용하여 session dump 데이터 기록 및 전달을 참조하십시오.

화면 녹화(권장)

Mega 플러그인을 사용하는 경우 화면을 녹화하는 동시에 반드시 AR Session dump를 수행하십시오. 이를 통해 비디오의 시각적 현상과 하위 알고리즘 데이터를 정렬할 수 있습니다.

실행 로그

vConsole에 오류가 나타난 경우 자세한 오류 정보를 제출해야 합니다. 자세한 방법은 WeChat Mini Program의 로그 분석을 참조하십시오.

중요

Mega 사용 시 프로그램 예외가 아니라 로컬라이제이션 또는 tracking 관련 문제가 발생한 경우, 반드시 당시의 session dump 파일과 화면 녹화 파일을 제공하십시오. 단순 로그 파일은 보조 참고 자료만 제공할 수 있으며, dump 데이터와 화면 녹화가 문제 조사에 대한 핵심 근거입니다.