Table of Contents

How to record and forward AR Session dump files

AR Session dump ファイルは、EasyAR チームが問題を調査・特定するための核心的な根拠です。

Before you begin

What is an AR Session dump file

重要

AR Session dump ファイルは、WeChat Mini Program 上で Mega の位置特定・トラッキング問題を分析・解決するための最も重要な根拠です。

AR Session dump ファイルは、Mini Program が Mega 位置特定リクエストを行う際の重要な時空間コンテキストを記録します。

How to record and forward

session.dumpSession(signal: boolean) インターフェースを呼び出して記録プロセスを制御します:

  • true を渡す: 記録を開始します。
  • false を渡す: 記録を停止し、生成されたファイル一時パス (tempFilePath) を返します。

通常は記録ロジックを UI ボタンにバインドし、記録開始時に wx.showToast() メソッドで記録開始を通知し、記録終了時に wx.shareFileMessage() メソッドで記録ファイルを WeChat チャット経由で転送することを推奨します。

/**
 * Session 記録ロジックを処理
 * @param signal true は記録開始、false は記録終了と転送
 */
dumpSession(signal: boolean): void {
  // インターフェースを呼び出してパスを取得
  const recordPath = session.dumpSession(signal);
  // signal が true の場合、インターフェースは空文字列を返し、記録中を示す
  if (recordPath.length == 0) {
      wx.showToast({
          title: 'データ記録を開始',
          icon: 'success',
          duration: 2000
      });
      return;
  }
  // signal が false の場合、返されたファイルパスを処理
  wx.shareFileMessage({
      filePath: recordPath,
      success() {
          wx.showToast({
              title: '記録転送成功',
              icon: 'success',
              duration: 2000
          });
      },
      fail() {
          wx.showToast({
              title: '記録転送失敗',
              icon: 'error',
              duration: 2000
          });
      }
  })
}

この例は、xr-frame コンポーネントで session.dumpSession() メソッドを使用して AR Session dump ファイルを記録・転送し、対応する Toast 通知を表示する方法を示しています。

注記

Mini Program のローカルストレージ制限（通常 200MB）のため、単回の記録時間は長くなりすぎないようにし、最長記録時間は 10 分を超えないでください。