Table of Contents

Wechat mini program issue reporting

To quickly and accurately locate issues you encounter during development or while using EasyAR capabilities (Mega or CRS) in your WeChat mini program, please refer to this guide and provide essential information and data before submitting feedback. This will significantly reduce back-and-forth communication time for troubleshooting.

Problem pre-check

Before reporting an issue, try resolving it through basic methods or by reading documentation.

When using the Mega plugin:

  • Confirm you are using the 2.x version of the mini program plugin (version 1.x of the Mega mini program plugin is no longer maintained)
  • Check Mega plugin known issues and limitations to confirm if it's a known issue.
  • Refer to the implementation in Mega Sample or CRS Sample and verify if the issue persists.

Required data for feedback

A complete issue report typically includes the following data to enable accurate analysis by the EasyAR development team.

Runtime environment data

  • Device model: Can be obtained via wx.getDeviceInfo().model.
  • WeChat client platform: Obtained through wx.getDeviceInfo().system.
  • WeChat version number: Obtained via wx.getAppBaseInfo().version.
  • WeChat mini program client base library version: Obtained via wx.getAppBaseInfo().SDKVersion.
  • (If using Mega plugin) Mega plugin version: Can be found in the version field under plugins in the project's app.json file.

[Mega] AR Session dump file (critical)

A reproducible AR Session dump file is the most crucial data for analyzing localization and tracking issues in WeChat mini programs.

Refer to How to record AR Session dump files with your mini program to implement dump file recording and forwarding.

Additionally, if the issue is stably reproducible, you can also record this data via the Mega toolbox and forward it. Refer to Recording and forwarding session-dump data using the WeChat mini program Mega Toolbox.

When using the Mega plugin, always perform AR Session dump while screen recording. This allows us to correlate visual phenomena in the video with underlying algorithm data.

Runtime logs

If errors appear in vConsole, you need to submit detailed error information. Refer to Log analysis on WeChat mini programs for detailed methods.

Important

If encountering localization or tracking-related issues (not program exceptions) when using Mega, always provide the session-dump file and screen recording. Log files alone offer only peripheral references; dump data and screen recordings are the core evidence for troubleshooting.