Gravação de dados EIF: Base de alta fidelidade para reproduzir problemas de RA
Em aplicações de realidade aumentada (AR), certos problemas complexos de localização espacial (como tremores no rastreamento, desalinhamento entre o real e o virtual, flutuação do conteúdo etc.) muitas vezes são difíceis de serem completamente reproduzidos apenas por meio de gravações de tela ou logs. Para isso, oferecemos a funcionalidade de gravação de dados EIF — um formato de despejo de dados de alta fidelidade proprietário que pode registrar sincronizadamente as seguintes informações-chave:
- Informações básicas do dispositivo (modelo, sistema, versão do SDK etc.)
- Quadros de imagem da câmera contendo carimbos de data/hora
- Matrizes intrínsecas e extrínsecas da câmera do dispositivo
- Dados do sensor IMU
- Dados extras de entrada auxiliar externa (como 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 podem reproduzir completamente o contexto detalhado no momento em que o problema ocorreu, permitindo que a equipe de desenvolvimento reproduza com precisão o cenário enfrentado pelo usuário em um ambiente offline, o que aumenta significativamente a eficiência na localização do problema. Em comparação com gravações de tela ou logs, o EIF apresenta as seguintes vantagens:
- Reprodução precisa: Os desenvolvedores podem reproduzir diretamente os dados EIF na ferramenta de depuração, reproduzindo o Bug que você encontrou.
- Diagnóstico em nível baixo: Através da análise abrangente de vários tipos de dados (imagens, sensores, entrada externa etc.), os desenvolvedores podem identificar em qual etapa da tecnologia o problema está.
- Economia de tempo: Evita ciclos de comunicação longos e reduz significativamente o ciclo desde o relato do problema até a resolução.
Como gravar dados EIF
O EasyAR oferece dois métodos de gravação de dados EIF.
- Use diretamente a interface da API fornecida pelo SDK para implementar a funcionalidade de gravação de dados EIF em seu aplicativo.
- Use o Mega Toolbox App fornecido oficialmente. Geralmente é adequado para o desenvolvimento do EasyAR Mega e feedback de problemas.
Consulte nossos documentos técnicos para obter instruções de operação específicas para o seu método de uso e dispositivo.
Dica
Acesse o seguinte link para ver como chamar a interface da API para implementar a funcionalidade de gravação de EIF no aplicativo: Gravação de quadros de entrada e execução simulada.
Acesse o seguinte link para ver as instruções de operação do Mega Toolbox App: Usar o Toolbox para gravar arquivos EIF do celular.
Visão geral resumida do fluxo de gravação (tomando o Mega Toolbox App como exemplo):
- Abra o Mega Toolbox App e clique em
Ferramenta de validação e diagnóstico no local. - Faça login em sua conta, selecione sua biblioteca de localização e comece o teste.
- Tente reproduzir o seu problema. Encontre um modo de operação que possa reproduzir o problema de forma estável (como a direção do dispositivo, o modo de navegação, o ponto de captura etc.).
- Quando tudo estiver pronto, clique no botão vermelho "Gravar" para começar a gravar.
- Após a ocorrência do problema, clique no botão vermelho "Parar e salvar".
- O sistema gerará automaticamente um arquivo EIF. Conecte o dispositivo ao computador, exporte-o para o armazenamento local e envie-o.
Nota
Os arquivos EIF podem ser grandes (de centenas de MB a vários GB). Recomendamos gravar apenas o trecho central que contém o problema (geralmente 10–30 segundos são suficientes).
Recomendações de melhores práticas
Para garantir que seu feedback seja processado com eficiência, inclua simultaneamente as seguintes quatro categorias de informações ao enviar:
| Tipo de informação | Descrição |
|---|---|
| Arquivo de dados EIF | Base de diagnóstico central. Certifique-se de incluir o processo de reprodução do problema. |
| Descrição do fenômeno subjetivo | Descreva claramente o comportamento que você observou (por exemplo, "A seta de navegação saltou para o teto quando fez uma curva à esquerda"). |
| Gravação de tela ou captura de tela | Ajuda a visualizar o problema e mostra visualmente "como é a imagem final vista pelo usuário". |
| Informações de contexto auxiliar | Incluem: • O modelo do seu dispositivo e a versão do sistema operacional • A versão do EasyAR SDK usada em seu aplicativo • A descrição do ambiente em que o problema ocorreu (interno/externo, iluminação, tamanho do espaço) • Aplicativos do tipo Mega precisam fornecer informações adicionais da biblioteca de localização, que podem ser exportadas na ferramenta Unity • Aplicativos de reconhecimento em nuvem CRS precisam fornecer informações adicionais da biblioteca de reconhecimento em nuvem |
Dica
Exemplo: "Ao usar o EasyAR Sense Unity Plugin 4000.0.1 no Apple Vision Pro (visionOS 26), durante a navegação em um shopping interno, a rota de navegação apresentou um erro repentino em determinada posição. Já gravei o arquivo EIF: avp_wrong_path_20251218.mkveif, anexe a 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 o pacote de informações completo acima, você acelerará significativamente o processo de análise e resolução do problema. Obrigado pela sua cooperação!