Table of Contents

Como gravar e encaminhar arquivos AR Session dump

Arquivos AR Session dump são a base principal para a equipe EasyAR diagnosticar problemas de localização e tracking.

Antes de começar

O que é um arquivo AR Session dump

Importante

Arquivos AR Session dump são a base mais importante para analisar e resolver problemas de localização e tracking Mega em mini programs WeChat.

Um arquivo AR Session dump registra o contexto espaço-temporal principal quando o mini program envia uma solicitação de localização Mega.

Como gravar e encaminhar

Controle o processo de gravação chamando a interface session.dumpSession(signal: boolean):

  • Passar true: inicia a gravação.
  • Passar false: para a gravação e retorna o caminho temporário do arquivo (tempFilePath) gerado.

Normalmente recomenda-se vincular a lógica de gravação a um botão de UI. Ao iniciar a gravação, use wx.showToast() para indicar o início. Ao terminar, use wx.shareFileMessage() para encaminhar o arquivo gravado via chat do WeChat.

/**
 * processa a logica de gravacao de Session
 * @param signal true inicia a gravacao; false encerra a gravacao e encaminha
 */
dumpSession(signal: boolean): void {
  // chama a interface para obter o caminho
  const recordPath = session.dumpSession(signal);
  // quando signal e true, a interface retorna uma string vazia para indicar que esta gravando
  if (recordPath.length == 0) {
      wx.showToast({
          title: '开始记录数据',
          icon: 'success',
          duration: 2000
      });
      return;
  }
  // quando signal e false, processa o caminho de arquivo retornado
  wx.shareFileMessage({
      filePath: recordPath,
      success() {
          wx.showToast({
              title: '记录转发成功',
              icon: 'success',
              duration: 2000
          });
      },
      fail() {
          wx.showToast({
              title: '记录转发失败',
              icon: 'error',
              duration: 2000
          });
      }
  })
}

Este exemplo demonstra como usar session.dumpSession() em um componente xr-frame para gravar e encaminhar um arquivo AR Session dump, fornecendo os prompts Toast correspondentes.

Nota

Devido aos limites de espaço local de mini programs (geralmente 200 MB), recomenda-se que uma gravação individual não seja muito longa, e a duração máxima não deve exceder 10 minutos.

Tópicos relacionados