Diagnóstico y reparación: contenido no visible

Este artículo aborda problemas comunes en los que el contenido virtual no se muestra durante el seguimiento de objetos 3D, proporcionando métodos sistemáticos de diagnóstico y sugerencias para ayudar a los desarrolladores a identificar y resolver problemas rápidamente.

Causas comunes y métodos de diagnóstico

La falta de visualización del contenido suele implicar fallos en el reconocimiento de objetos, errores en la implementación de funciones o restricciones de permisos. A continuación se presentan las causas principales y los pasos para diagnosticarlas:

Fallo en el reconocimiento del objeto

Síntoma: El contenido virtual no aparece en absoluto cuando la cámara apunta al objeto objetivo.
Métodos de diagnóstico:

• Verificar la calidad del modelo: Asegúrese de que el modelo 3D y el objeto cumplen con los requisitos de formato de archivo, texturas, geometría, etc., descritos en Preparación de modelos.
• Verificar el objeto objetivo: Confirme que la superficie del objeto objetivo no tenga materiales reflectantes o especulares.
• Revisar registros: Consulte los registros de la aplicación para verificar si el modelo objetivo se cargó correctamente.

Sugerencias de mejora:

• Optimizar el modelo: Asegúrese de que las texturas sean suficientemente ricas y que la geometría no tenga agujeros.
• Verificar lógica: Confirme que la aplicación haya cargado correctamente el modelo objetivo. Si falla la carga, consulte el capítulo Fallo en la carga del objetivo para diagnosticar y solucionar.

Error en la implementación de funciones

Síntoma: El objeto se reconoce, pero el contenido virtual no se muestra o aparece en una posición anómala.

• Unity
• Nativo

Métodos de diagnóstico:

• Verificar la configuración de ObjectTarget:
  • Según el tipo de Source, compruebe si apunta al archivo correcto dentro de la carpeta StreamingAssets.
  • Asegúrese de que Scale se ajustó según las dimensiones reales del objeto (por ejemplo, si las dimensiones calculadas del BoundingBox del archivo del modelo son 10 x 10 x 30, pero el objeto real mide 0.1m x 0.1m x 0.3m, entonces Scale debe establecerse en 0.01).
• Confirmar jerarquía del prefabricado:
  • El contenido virtual debe estar en el mismo nivel que el modelo 3D objetivo, y ambos deben ser nodos secundarios de ObjectTarget. El contenido virtual no debe estar deshabilitado.
  • La propiedad Rotation del modelo 3D objetivo debe tener la dirección Y configurada en 180.
  • La colocación del contenido virtual debe basarse completamente en la posición del modelo 3D objetivo.

Sugerencias de mejora:

• Restablecer configuración: Elimine y vuelva a crear el ObjectTarget en la escena, arrastre el prefabricado siguiendo las normas y vincule el modelo 3D.
• Verificar registros: Busque errores relacionados con ObjectTargetController, como fail to load target data.

Problemas de permisos

Síntoma: El contenido funcionaba correctamente, pero desaparece después de un tiempo de uso.
Métodos de diagnóstico:
Confirme si se encuentra en alguno de estos casos:

• Uso en cascos XR
• Uso de cámaras personalizadas
• Uso de AR Engine/ARFoundation en móviles

Si pertenece a uno de estos casos, es posible que esté utilizando una licencia de prueba.

Sugerencias de mejora:

• Utilice una licencia de versión oficial.

Problemas con el contenido virtual

Síntoma: El contenido se mostraba correctamente, pero no es visible cuando la cámara está muy cerca/lejos del objeto objetivo.
Métodos de diagnóstico:

• Verificar configuración de recorte cercano/lejano: Asegúrese de que los valores de recorte cercano y lejano (near/far clipping) durante el renderizado del contenido estén en un rango razonable.
• Verificar tamaño del modelo de contenido: Si el modelo de contenido es demasiado grande, al acercarse al objeto puede producirse "clipping" y ocultarlo; si es demasiado pequeño, al alejarse puede volverse imperceptible.

Sugerencias de mejora:

• Establezca valores adecuados de recorte cercano/lejano.
• Asegúrese de que el tamaño físico del contenido virtual sea proporcional al del objeto objetivo.

Resumen y mejores prácticas

Los problemas de visualización de contenido suelen deberse al modelo 3D del objeto, implementación del programa, permisos o al propio contenido. Se recomienda diagnosticar en este orden:

1. Verifique si la licencia es oficial.
2. Compruebe si el contenido virtual es adecuado.
3. Confirme la calidad del modelo 3D objetivo.
4. Detecte si hay errores en la implementación del programa o configuración de desarrollo.

Si el problema persiste, contacte a través del foro oficial de EasyAR o soporte técnico, facilitando registros, grabaciones de pantalla, etc., para un análisis más detallado.