Table of Contents

Grabación de datos EIF: evidencia de alta fidelidad para reproducir problemas de RA

En aplicaciones de realidad aumentada (RA), ciertos problemas complejos de posicionamiento espacial (como temblores en el seguimiento, desajustes entre elementos virtuales y reales, deriva de contenido, etc.) suelen ser difíciles de reproducir completamente solo mediante capturas de pantalla o registros. Por ello, ofrecemos la función de grabación de datos EIF: un formato de volcado de datos patentado de alta fidelidad que registra sincrónicamente la siguiente información clave:

  • Información básica del dispositivo (modelo, sistema, versión del SDK, etc.)
  • Fotogramas de imagen de la cámara con marca de tiempo
  • Matriz de parámetros intrínsecos y extrínsecos de la cámara del dispositivo
  • Datos del sensor IMU
  • Datos adicionales de entradas auxiliares externas (como GNSS)

¿Por qué es crucial grabar datos EIF?

Importante

Los datos EIF que permiten reproducir un problema son invaluables.

Los datos EIF pueden recrear completamente el contexto detallado cuando ocurre un problema, permitiendo al equipo de desarrollo reproducir con precisión el escenario que encontró el usuario en un entorno offline, mejorando enormemente la eficiencia en la identificación de problemas. En comparación con capturas de pantalla o registros, EIF ofrece las siguientes ventajas:

  1. Reproducción precisa: los desarrolladores pueden reproducir directamente los datos EIF en herramientas de depuración, recreando el error que usted encontró.
  2. Diagnóstico de bajo nivel: mediante el análisis exhaustivo de diversos datos (imágenes, sensores, entradas externas, etc.), los desarrolladores pueden determinar en qué parte del flujo técnico reside el problema.
  3. Ahorro de tiempo: evita largos ciclos de comunicación, reduciendo significativamente el período desde el reporte hasta la solución del problema.

Cómo grabar datos EIF

EasyAR ofrece dos métodos para grabar datos EIF.

  1. Usar directamente la interfaz API proporcionada por el SDK, implementando la función de grabación EIF en su aplicación.
  2. Usar la aplicación oficial Mega Toolbox App. Normalmente aplicable para el desarrollo de EasyAR Mega y la retroalimentación de problemas.

Consulte nuestra documentación técnica para obtener instrucciones específicas según su método de uso y dispositivo.

Consejo

Acceda al siguiente enlace para ver cómo implementar la grabación EIF dentro de la aplicación mediante la API: Grabación y simulación de fotogramas de entrada.

Acceda al siguiente enlace para ver la guía de uso de Mega Toolbox App: Grabación de archivos EIF en teléfono con Toolbox.

Resumen del flujo de grabación (ejemplo con Mega Toolbox App):

  1. Abra Mega Toolbox App, haga clic en "Prueba de posicionamiento en sitio y grabación de datos para retroalimentación de problemas de posicionamiento".
  2. Inicie sesión con su cuenta, seleccione su biblioteca de posicionamiento y comience la prueba.
  3. Intente reproducir su problema. Encuentre un patrón de acciones que reproduzca el problema de manera estable (como orientación del dispositivo, modo de navegación, puntos de captura, etc.).
  4. Cuando todo esté listo, haga clic en el botón rojo "Grabar" para comenzar.
  5. Después de que aparezca el problema, haga clic en el botón rojo "Detener y guardar".
  6. El sistema generará automáticamente un archivo EIF. Conecte el dispositivo a una computadora, expórtelo al almacenamiento local y envíelo.
Nota

Los archivos EIF pueden ser grandes (cientos de MB a varios GB), se recomienda grabar solo el fragmento central que contiene el problema (normalmente 10-30 segundos son suficientes).

Mejores prácticas recomendadas

Para garantizar que su retroalimentación se procese de manera eficiente, al enviarla incluya simultáneamente los siguientes cuatro tipos de información:

Tipo de información Descripción
Archivo de datos EIF Evidencia central de diagnóstico, debe incluir el proceso de reproducción del problema
Descripción subjetiva del fenómeno Explique claramente el comportamiento observado (ej: "La flecha de navegación salta repentinamente al techo al girar a la izquierda")
Captura de pantalla o grabación Ayuda a visualizar el problema, mostrando de manera intuitiva "qué es lo que el usuario finalmente ve"
Información contextual auxiliar Incluya:
• Modelo de su dispositivo y versión del sistema operativo
• Número de versión del EasyAR SDK utilizado por su aplicación
• Descripción del entorno donde ocurrió el problema (interior/exterior, iluminación, tamaño del espacio)
• Aplicaciones tipo Mega requieren información adicional de la biblioteca de posicionamiento, puede exportarla desde la herramienta Unity
• Aplicaciones de reconocimiento en la nube (CRS) requieren información adicional de la biblioteca de reconocimiento en la nube
Consejo

Ejemplo: "En Apple Vision Pro (visionOS 26) usando EasyAR Sense Unity Plugin 4000.0.1, durante navegación en centro comercial interior, la ruta de navegación falló repentinamente en una ubicación. Archivo EIF grabado: avp_wrong_path_20251218.mkveif, adjunto grabación de pantalla, fotos del entorno e información de la biblioteca de posicionamiento: MegaStudio_ServiceInfo_myaccount_2025-12-18_10-33-26.json."

Al proporcionar este paquete completo de información, acelerará significativamente el proceso de análisis y solución de problemas. ¡Gracias por su colaboración!