Table of Contents

AR Session dump ファイルを記録して転送する方法

AR Session dump ファイルは、EasyAR チームがローカライズおよびトラッキング問題を調査するための中核的な根拠です。

始める前に

AR Session dump ファイルとは

重要

AR Session dump ファイルは、WeChat ミニプログラム上で Mega のローカライズおよびトラッキング問題を分析・解決するための最も重要な根拠です。

AR Session dump ファイルは、ミニプログラムが Mega ローカライズリクエストを行う際の重要な時空間コンテキストを記録します。

記録と転送の方法

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 プロンプトを表示する方法を示しています。

注記

ミニプログラムのローカル容量制限（通常 200 MB）のため、1 回の記録時間は長すぎないようにし、最長記録時間は 10 分を超えないようにしてください。

関連トピック