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) 때문에 단일 기록 시간이 너무 길지 않도록 권장하며, 최대 기록 시간은 10분을 초과할 수 없습니다.

관련 주제