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 データと画面録画こそが問題調査の中核的根拠です。