Table of Contents

Diagnóstico y solución: vibración de contenido

Este documento aborda el problema de vibración, desplazamiento o saltos en el contenido virtual durante el seguimiento de imágenes planas, ayudando a los desarrolladores a distinguir entre vibraciones normales y anormales, y proporcionando un enfoque sistemático para la investigación y mejora.

Distinguir la "vibración normal"

Comprender los siguientes escenarios ayuda a evitar optimizaciones excesivas o diagnósticos erróneos:

Desplazamiento leve (normal)

  • Manifestación: Ligero flotar o rotación lenta del contenido virtual (pocos píxeles).
  • Escenarios:
    • Iluminación no uniforme (ej: cambios de luz/sombra en interiores)
    • Ajustes automáticos de enfoque o exposición de la cámara
    • Temblor leve de la mano (sin trípode)
  • Expectativa: Difícil de evitar en estos casos, no requiere tratamiento especial.

Vibración breve (normal)

  • Manifestación: Vibración de 0.5~1 segundo al mover rápidamente el dispositivo o la imagen objetivo, seguida de estabilización.
  • Escenarios:
    • Transición de estático a dinámico
    • Fase inicial de reconocimiento de la imagen objetivo
  • Expectativa: Parte del proceso de convergencia del algoritmo, normal si se recupera rápidamente.

Vibración en bordes (normal)

  • Manifestación: Ligero salto del contenido virtual cuando la imagen está en el borde del campo visual o cerca de perderse.
  • Escenarios:
    • Oclusión parcial (ej: dedo cubriendo el borde)
    • Extrapolación del campo visual de la cámara
  • Expectativa: Resultado de información faltante en el seguimiento, se recomienda guiar al usuario a mantener la imagen centrada.

Causas comunes de vibración anormal y mejoras

Las siguientes vibraciones son problemáticas y requieren solución:

Calidad deficiente de la imagen objetivo

Fenómeno: Vibración continua de alta frecuencia, saltos irregulares o desapariciones frecuentes.
Método de investigación:

Mejoras sugeridas:

  • Optimizar la imagen:
    • Aumentar el contraste local.
    • Evitar áreas de color sólido; añadir texturas sutiles.
    • Evitar texturas repetitivas.

Rendimiento de hardware insuficiente

Fenómeno: Vibración notable en dispositivos de gama baja comparado con gama media/alta, o pérdida más frecuente.
Método de investigación:

  • Verificar uso de CPU: Monitorear tasa de uso con herramientas Profiler.

Mejoras sugeridas:

  • Habilitar modo rendimiento: Configurar ImageTrackerMode como PreferPerformance, sacrificando mínima precisión por fluidez.
  • Reducir seguimientos simultáneos: Disminuir el Número Simultáneo si se rastrean múltiples objetivos.
  • Adaptar por plataforma: Ofrecer escenarios simplificados para dispositivos de gama baja.

Interferencia ambiental

Fenómeno: Vibración en condiciones específicas de luz/fondo; normal al cambiar de entorno.
Método de investigación:

  • Prueba de iluminación: Evaluar en luz uniforme (ej: día nublado) vs. luz fuerte/sombras.
  • Interferencia de fondo: Verificar si el fondo es muy caótico (ej: personas moviéndose).
  • Reflexiones: Superficies físicas reflectantes (ej: vidrio, metal).

Mejoras sugeridas:

  • Controlar iluminación: Recomendar uso en entornos con luz uniforme; evitar luz directa o sombras fuertes.
  • Optimizar físicamente: Cubrir superficies reflectantes con película mate o imprimir la imagen objetivo.

Vibración localizada en el contenido

Fenómeno: Contenido virtual cercano a la imagen física estable, pero con vibración notable en áreas distantes.
Método de investigación:

  • Reducir escala: Disminuir el Scale del contenido virtual y repetir pruebas en mismas condiciones.

Mejoras sugeridas:

  • Ajustar contenido: El contenido virtual extenso amplifica errores angulares en distancias lejanas (ej: error de 0.1° se traduce en 0.1cm cerca, pero en 10cm lejos). Ajuste el tamaño relativo del contenido virtual respecto a la imagen física.

Resumen y mejores prácticas

La vibración de contenido requiere distinguir entre normal y anormal. La normal (desplazamiento leve, recuperación breve) no necesita acción; la anormal (saltos frecuentes, pérdidas) afecta la experiencia de usuario. Investigar en este orden:

  1. Calidad de la imagen objetivo;
  2. Rendimiento específico del dispositivo;
  3. Interferencias ambientales (luz, escenas dinámicas, reflexiones);
  4. Tamaño excesivo del contenido virtual.

Si persiste el problema, contacte al foro oficial de EasyAR o soporte técnico con registros o grabaciones para análisis.