Table of Contents

Como gravar e encaminhar arquivos de dump de sessão AR

O arquivo de dump de sessão AR é a base central para a equipe do EasyAR investigar e localizar problemas.

Antes de começar

O que é um arquivo de dump de sessão AR

Importante

O arquivo de dump de sessão AR é a base mais importante para analisar e resolver problemas de posicionamento e rastreamento do Mega em miniprogramas do WeChat.

O arquivo de dump de sessão AR registra o contexto espaço-temporal crítico quando o miniprograma faz uma solicitação de posicionamento Mega.

Como gravar e encaminhar

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

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

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

/**
 * Processa a lógica de gravação da sessão
 * @param signal true para iniciar gravação, false para parar e encaminhar
 */
dumpSession(signal: boolean): void {
  // Chama a interface para obter o caminho
  const recordPath = session.dumpSession(signal);
  // Quando signal é true, retorna string vazia (indicando gravação)
  if (recordPath.length == 0) {
      wx.showToast({
          title: 'Iniciando gravação de dados',
          icon: 'success',
          duration: 2000
      });
      return;
  }
  // Quando signal é false, processa o caminho retornado
  wx.shareFileMessage({
      filePath: recordPath,
      success() {
          wx.showToast({
              title: 'Gravação encaminhada com sucesso',
              icon: 'success',
              duration: 2000
          });
      },
      fail() {
          wx.showToast({
              title: 'Falha ao encaminhar gravação',
              icon: 'error',
              duration: 2000
          });
      }
  })
}

Este exemplo demonstra como usar o método session.dumpSession() no componente xr-frame para gravar e encaminhar arquivos de dump de sessão AR, com feedback visual via Toast.

Nota

Devido às limitações de espaço local em miniprogramas (geralmente 200MB), recomenda-se não gravar por períodos muito longos. O tempo máximo de gravação não deve exceder 10 minutos.

Tópicos relacionados