Table of Contents

Gravar dados EIF: Evidência de alta fidelidade para reproduzir problemas AR

Em aplicações de realidade aumentada (AR), alguns problemas complexos de spatial localization, como jitter de tracking, desalinhamento virtual-real e drift de conteúdo, muitas vezes são difíceis de reproduzir completamente apenas por gravações de tela ou logs. Para isso, fornecemos o recurso de gravação de dados EIF, um formato proprietário de data dump de alta fidelidade que pode registrar de forma sincronizada as seguintes informações essenciais:

  • Informações básicas do dispositivo, como modelo, sistema e versão do SDK
  • Frames de imagem da câmera com timestamp
  • Matriz intrínseca e matriz extrínseca da câmera do dispositivo
  • Dados de sensores IMU
  • Dados adicionais de entradas auxiliares externas, como GNSS

Por que gravar dados EIF é importante?

Importante

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

Os dados EIF podem reproduzir completamente o contexto detalhado no momento em que um problema ocorre, permitindo que a equipe de desenvolvimento reproduza com precisão o cenário encontrado pelo usuário em um ambiente offline e melhore muito a eficiência de localização do problema. Em comparação com gravações de tela ou logs, EIF tem as seguintes vantagens:

  1. Reprodução precisa: desenvolvedores podem reproduzir diretamente dados EIF em ferramentas de debugging para reproduzir o Bug encontrado.
  2. Diagnóstico de baixo nível: por meio da análise abrangente de vários tipos de dados, como imagens, sensores e entradas externas, desenvolvedores podem determinar em qual etapa técnica o problema ocorreu.
  3. Economia de tempo: evita longos ciclos de comunicação e reduz significativamente o ciclo desde o relato do problema até sua resolução.

Como gravar dados EIF

O EasyAR fornece duas formas de gravar dados EIF.

  1. Usar diretamente as APIs fornecidas pelo SDK para implementar a função de gravação de dados EIF em sua aplicação.
  2. Usar o Mega Toolbox App oficial. Geralmente adequado para desenvolvimento EasyAR Mega e feedback de problemas.

Para etapas detalhadas, consulte nossa documentação técnica para obter guias de operação de acordo com seu método de uso e dispositivo.

Dica

Acesse o link a seguir para ver como implementar gravação EIF dentro da aplicação chamando APIs: Input frame recording and simulated runtime.

Acesse o link a seguir para ver o guia de operação usando Mega Toolbox App: Use Toolbox to record mobile EIF files.

Visão geral breve do processo de gravação, usando Mega Toolbox App como exemplo:

  1. Abra o Mega Toolbox App e toque em On-site Verification and Diagnostics Tool.
  2. Faça login em sua conta, selecione sua localization library e comece o teste.
  3. Tente reproduzir seu problema. Encontre um padrão de operação que consiga reproduzir o problema de forma estável, como orientação do dispositivo, modo de navegação ou ponto de captura.
  4. Quando tudo estiver pronto, toque no botão vermelho "Record" para iniciar a gravação.
  5. Depois que o problema aparecer, toque no botão vermelho "Stop and Save".
  6. O sistema gerará automaticamente um arquivo EIF. Conecte o dispositivo ao computador, exporte para armazenamento local e envie.
Nota

Arquivos EIF podem ser grandes, de centenas de MB a vários GB. Recomenda-se gravar apenas o segmento principal que contém o problema, geralmente 10-30 segundos são suficientes.

Sugestões de melhores práticas

Para garantir que seu feedback possa ser processado com eficiência, inclua ao mesmo tempo os quatro tipos de informação a seguir ao enviar:

Tipo de informação Descrição
Arquivo de dados EIF Evidência diagnóstica principal, deve conter o processo de reprodução do problema
Descrição subjetiva do fenômeno Descreva claramente o comportamento observado, como "a seta de navegação pulou repentinamente para o teto ao virar à esquerda"
Gravação de tela ou screenshot Ajuda a visualizar o problema e mostra intuitivamente "o que o usuário finalmente viu"
Informações contextuais auxiliares Inclui:
• Modelo do dispositivo e versão do sistema operacional
• Versão do EasyAR SDK usada por sua aplicação
• Descrição do ambiente onde o problema ocorreu (indoor/outdoor, iluminação, tamanho do espaço)
• Aplicações do tipo Mega precisam fornecer adicionalmente informações da localization library, que podem ser exportadas pela Unity tool
• Aplicações do tipo CRS cloud recognition precisam fornecer adicionalmente informações da cloud recognition library
Dica

Exemplo: "No Apple Vision Pro (visionOS 26) usando EasyAR Sense Unity Plugin 4000.0.1, navegando em um shopping center indoor, a rota de navegação ficou repentinamente incorreta em determinado local. Arquivo EIF gravado: avp_wrong_path_20251218.mkveif, com gravação de tela, fotos do ambiente e informações da localization library anexadas: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."

Ao fornecer o pacote completo de informações acima, você acelerará significativamente o processo de análise e correção do problema. Obrigado pela cooperação!