Recopilación de datos de diagnóstico de Mega
Esta guía tiene como objetivo proporcionar instrucciones estandarizadas para la recopilación de datos sobre anomalías visuales. Mediante una recopilación y retroalimentación estandarizadas, se ayuda a los desarrolladores a describir problemas con precisión y se asiste al equipo técnico de EasyAR en la identificación, reproducción y resolución eficiente de fallos técnicos relacionados con el posicionamiento visual.
Contenido introductorio
Durante la integración del servicio de posicionamiento EasyAR Mega, la recolección precisa de datos es un requisito central para el diagnóstico de problemas. Esta guía cubre los siguientes aspectos clave:
- Identificación de problemas: Clasificación y evaluación preliminar de fenómenos anómalos comunes.
- Normas de captura de pantalla y grabación: Métodos de recopilación de evidencia visual para diferentes plataformas de dispositivos.
- Recolección de datos de ejecución: Extracción y exportación de datos del entorno de ejecución en varias plataformas.
- Estándares de retroalimentación: Garantizar el "conjunto mínimo de información" necesario para que el equipo técnico pueda reproducir el problema.
Clasificación de anomalías y juicio preliminar
Antes de informar un problema, identifique el fenómeno anómalo según las siguientes categorías:
Manifestaciones anómalas comunes
- Incapacidad total para posicionar: No se reconoce la escena, el estado muestra continuamente "NotFound".
- Desviación en la precisión del posicionamiento: El posicionamiento es exitoso pero la precisión es insuficiente, con desplazamientos espaciales evidentes.
- Inestabilidad en el posicionamiento: La imagen presenta vibraciones, deriva o pérdida frecuente de seguimiento.
- Anomalía regional: Rendimiento deficiente en áreas o puntos específicos.
- Diferencias de compatibilidad del dispositivo: Rendimiento inferior en ciertos modelos específicos.
Posibles causas
- Relacionadas con la escena: Ubicación desplazada del contenido, baja calidad del mapeo, iluminación ambiental deficiente o puntos característicos escasos (como paredes blancas extensas), interferencia de puntos similares.
- Entorno técnico: Fluctuaciones de red, servicio no pagado, exceso de QPS, compatibilidad de la versión del SDK, errores en la lógica de llamadas API.
- Permisos de hardware: Sensores del dispositivo (IMU) no compatibles con el seguimiento de movimiento, permisos de cámara o almacenamiento no habilitados.
Flujo de retroalimentación estandarizado
Para mejorar la eficiencia en la resolución de problemas, recomendamos encarecidamente enviar un paquete de retroalimentación completo que incluya las siguientes tres partes:
Lista de información básica (conjunto mínimo de información)
- Identificadores de recursos: Información de cuenta, Mega AppId, Block Id.
- Información de versión: Versión de EasyAR Sense SDK o versión del complemento de mini-programa.
- Descripción detallada del problema: Descripción exhaustiva del fenómeno anómalo y sus condiciones de activación.
- Parámetros ambientales: Modelo del dispositivo, versión del SO, versión de WeChat, entorno de red actual (4G/5G/WiFi).
Evidencia visual (video y capturas)
- Grabación del proceso de reproducción: Registro completo desde el inicio hasta la ocurrencia de la anomalía durante el posicionamiento.
- Capturas de fotogramas clave: Instantáneas en el momento exacto de la anomalía.
- Registros multiángulo: Referencias visuales desde diferentes ubicaciones y condiciones de iluminación.
Datos de tiempo de ejecución (base central para la investigación)
- Datos EIF: Registros en tiempo de ejecución basados en EasyAR Sense, compatibles con reproducción y análisis en PC.
- Datos Dump: Instantánea específica del estado de ejecución en mini-programas de WeChat.
- Registros de la aplicación: Logs de ejecución de la App (Logcat/Consola) y trazas de error.
Consejo
Lectura adicional: Cómo comunicar claramente un problema detallado
Entorno de ejecución y métodos de recolección clasificados
Los métodos de recolección de datos varían según el dispositivo y la plataforma de ejecución. Seleccione la guía correspondiente según su entorno real.
Explicación de la clasificación de dispositivos
- Dispositivos móviles: Teléfonos inteligentes (iOS/Android).
- Dispositivos de visualización montados (head-mounted):
- OST (Optical See-Through): Transparencia óptica (ej. XREAL, Rokid).
- VST (Video See-Through): Transparencia de video (ej. Apple Vision Pro, PICO).
Guía para capturas de pantalla y grabaciones
| Tipo de plataforma | Guía de referencia |
|---|---|
| Teléfono / Mini-programa WeChat | Captura de pantalla, grabación y exportación en móviles |
| Dispositivos OST | Grabación y exportación OST |
| Dispositivos VST | Grabación y exportación VST |
Recolección de datos de ejecución (EIF/Dump)
| Tipo de escenario | Plan de recolección |
|---|---|
| Aplicación nativa EasyAR Sense | Grabación EIF para App móvil / Grabación EIF para dispositivos montados |
| Mini-programa WeChat | Grabación y exportación de datos Dump para mini-programas |
| Herramienta de recolección rápida | Grabación EIF con Mega Toolbox / Grabación Dump con Toolbox |
Función de recolección automática (próximamente)
Próximamente mejoraremos el soporte para funciones de recolección y retroalimentación automática, ofreciendo métodos más convenientes para enviar datos:
- Grabación en segundo plano: Inicie la recolección del conjunto de datos necesario según demanda.
- Carga automática: Empaquetado y envío automático al equipo técnico de EasyAR.
- Captura bajo demanda: Detección autónoma en tiempo real de estados anómalos.
- Seguimiento de progreso: Clasificación y monitoreo continuo.
Resumen de navegación de guías operativas
Según su plataforma y necesidades del dispositivo, vaya directamente a las guías operativas detalladas:
| Tipo | Guía de recolección de capturas/grabaciones | Guía de recolección de datos de ejecución |
|---|---|---|
| Aplicación móvil | Captura de pantalla, grabación y exportación en móviles | Grabación EIF para App móvil, Grabación EIF con Mega Toolbox, Instrucciones para exportar datos EIF |
| Dispositivos OST | Grabación y exportación OST | Grabación y exportación EIF para dispositivos montados |
| Dispositivos VST | Grabación y exportación VST | Grabación y exportación EIF para dispositivos montados |
| Mini-programa WeChat | Captura de pantalla, grabación y exportación en móviles | Grabación y exportación Dump para mini-programas WeChat, Grabación Dump con Toolbox para mini-programas |
Recomendaciones de mejores prácticas
- Flujo de investigación previa: Antes del lanzamiento del proyecto, se recomienda que los miembros del equipo se familiaricen con el proceso de recolección de datos.
- Autoverificación preliminar: Antes de reportar, confirme si se han descartado problemas de entorno técnico, ubicación de contenido o permisos del dispositivo.
- Integridad de datos: Recolecte datos completos de manera estandarizada: incluya el conjunto mínimo de información, videos y capturas de anomalías visuales, y datos de tiempo de ejecución.
- Comunicación oportuna: Después de enviar datos completos, mantenga comunicación con el equipo técnico de EasyAR.
Canales de soporte técnico
- Documentación de ayuda: Consulte la Documentación Mega o Solución de problemas.
- Soporte técnico: Consultar ahora o enviar correo a support@sightp.com.
Siguiente tema: Métodos de captura de pantalla, grabación y exportación en móviles