微信小程序問題報告

為了能夠快速、準確地定位您在開發或使用使用 EasyAR 提供的能力（Mega 或 CRS）的微信小程序時遇到的問題，在提交反饋前參考本指南提供必要的訊息和數據以顯著減少排查問題的往返溝通時間。

問題預檢

在報告問題前，可以先嘗試通過一些基本手段或閱讀文件快速解決問題。

使用 Mega 插件：

• 確認使用 2.x 版本的小程序插件（1.x 版本的 Mega 小程序插件已不再維護）
• 閱讀 Mega 插件已知問題和限制確認是否為已知問題。
• 參考修改為 Mega Sample 或 CRS Sample 中的實現方式，確認問題依然存在。

反饋問題時需要的數據

一份完整的問題報告通常需要包含以下數據，使 EasyAR 開發團隊能夠進行準確的分析。

運行環境數據

• 設備型號：可以嘗試通過 wx.getDeviceInfo().model 獲取。
• 微信客戶端平台：通過 wx.getDeviceInfo().system 獲取。
• 微信版本號: 通過 wx.getAppBaseInfo().version 獲取。
• 微信小程序客戶端基礎庫版本：通過 wx.getAppBaseInfo().SDKVersion 獲取。
• （若使用 Mega 插件）使用的 Mega 插件版本：可以通過工程 app.json 文件中的 plugins 字段中的 version 獲取。

[Mega] AR Session dump 文件（至關重要）

能夠復現問題的 AR Session dump 文件是分析微信小程序上定位、追蹤問題最重要的數據。

參考 如何使用你的小程序錄製 AR Session dump 文件實現 dump 文件的記錄與轉發。

此外若定位問題可以穩定復現，您也可以通過 Mega toolbox 來錄製這段數據並轉發，參考使用微信小程序 Mega Toolbox 記錄與轉發 session dump 數據。

螢幕錄製（建議）

若使用 Mega 插件，請務必在錄製螢幕的同時進行 AR Session dump。這能讓我們將影片中的視覺現象與底層演算法數據對齊。

運行日誌

若在 vConsole 中出現了報錯，您需要提交詳細的錯誤訊息，詳細方法參考 微信小程序上的日誌分析

重要事項

如果使用 Mega 時遇到定位或追蹤相關的問題而不是程序異常，請務必提供當時的 session dump 文件和錄屏文件。純日誌文件僅能提供側面參考，dump 數據與錄屏才是排查問題的核心依據。