Table of Contents

Gravação de dados EIF: evidência de alta fidelidade para reprodução de problemas AR

Em aplicações de realidade aumentada (AR), certos problemas complexos de rastreamento espacial (como tremores de rastreamento, desalinhamento entre real e virtual, deriva de conteúdo, etc.) geralmente são difíceis de reproduzir integralmente apenas com gravações de tela ou logs. Para isso, oferecemos a funcionalidade de gravação de dados EIF — um formato proprietário de despejo de dados de alta fidelidade que registra sincronizadamente as seguintes informações essenciais:

  • Informações básicas do dispositivo (modelo, sistema, versão do SDK, etc.)
  • Quadros de imagem da câmera com carimbos de tempo
  • Matriz de parâmetros intrínsecos e extrínsecos da câmera do dispositivo
  • Dados dos sensores IMU
  • Dados adicionais de entradas auxiliares externas (ex: GNSS)

Por que a gravação de dados EIF é crucial?

Importante

Dados EIF capazes de reproduzir o problema são inestimáveis.

Os dados EIF permitem reconstruir integralmente o contexto detalhado quando o problema ocorre, permitindo que a equipe de desenvolvimento reproduza com precisão o cenário enfrentado pelo usuário em ambiente offline, aumentando significativamente a eficiência na identificação do problema. Comparado a gravações de tela ou logs, o EIF oferece as seguintes vantagens:

  1. Reprodução precisa: os desenvolvedores podem reproduzir diretamente os dados EIF em ferramentas de depuração, replicando o bug que você encontrou.
  2. Diagnóstico de baixo nível: através da análise abrangente de diversos dados (imagem, sensores, entradas externas, etc.), os desenvolvedores podem determinar em qual parte da tecnologia o problema reside.
  3. Economia de tempo: evita ciclos de comunicação prolongados, reduzindo drasticamente o período entre o relato e a resolução do problema.

Como gravar dados EIF

O EasyAR oferece duas maneiras de gravar dados EIF.

  1. Utilizar diretamente a interface de API fornecida pelo SDK, implementando a funcionalidade de gravação de dados EIF na sua aplicação.
  2. Utilizar o aplicativo oficial Mega Toolbox App. Geralmente adequado para desenvolvimento com EasyAR Mega e feedback de problemas.

Consulte nossa documentação técnica para obter etapas operacionais específicas adaptadas ao seu modo de uso e dispositivo.

Dica

Acesse o seguinte link para ver como implementar a gravação de EIF dentro do aplicativo usando a API: Gravação e simulação de quadros de entrada.

Acesse o seguinte link para ver o guia operacional usando o Mega Toolbox App: Gravar arquivos EIF no celular com o Toolbox.

Visão geral resumida do fluxo de gravação (exemplo com Mega Toolbox App):

  1. Abra o Mega Toolbox App, clique em "Teste de localização no local & Gravação de dados para feedback de problemas de localização".
  2. Faça login na sua conta, selecione sua biblioteca de localização e inicie o teste.
  3. Tente reproduzir o seu problema. Encontre um padrão de operação que reproduza o problema de forma estável (ex: orientação do dispositivo, modo de navegação, pontos de captura, etc.).
  4. Com tudo pronto, clique no botão vermelho "Gravar" para iniciar a gravação.
  5. Após a ocorrência do problema, clique no botão vermelho "Parar e salvar".
  6. O sistema gerará automaticamente um arquivo EIF. Após conectar o dispositivo ao computador, exporte-o para o armazenamento local e envie-o.
Nota

Os arquivos EIF podem ser grandes (centenas de MB a GBs). Recomenda-se gravar apenas o trecho central que contém o problema (normalmente 10–30 segundos são suficientes).

Melhores práticas recomendadas

Para garantir que seu feedback seja processado com eficiência, inclua simultaneamente as quatro categorias de informações abaixo ao enviar:

Tipo de informação Descrição
Arquivo de dados EIF Evidência central de diagnóstico. Deve conter o processo de reprodução do problema.
Descrição subjetiva do fenômeno Descreva claramente o comportamento observado (ex: "A seta de navegação subitamente saltou para o teto ao virar à esquerda").
Gravação de tela ou captura Auxilia na visualização do problema, mostrando intuitivamente "o que o usuário viu na tela".
Informações contextuais auxiliares Inclua:
• Modelo do seu dispositivo e versão do sistema operacional
• Número da versão do EasyAR SDK usado na sua aplicação
• Descrição do ambiente onde o problema ocorreu (interior/exterior, iluminação, tamanho do espaço)
• Aplicações tipo Mega exigem informações adicionais da biblioteca de localização (exportáveis via ferramenta Unity)
• Aplicações de reconhecimento em nuvem (CRS) exigem informações adicionais da biblioteca de reconhecimento em nuvem
Dica

Exemplo: "Usando o EasyAR Sense Unity Plugin 4000.0.1 no Apple Vision Pro (visionOS 26), durante navegação em shopping center interno, a rota de navegação apresentou erro repentino em um ponto específico. Arquivo EIF gravado: avp_wrong_path_20251218.mkveif. Anexo: gravação de tela, fotos do ambiente e informações da biblioteca de localização: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."

Ao fornecer este pacote completo de informações, você acelerará significativamente o processo de análise e correção do problema. Agradecemos sua colaboração!