Table of Contents

Diagnóstico y corrección: el contenido no se muestra

Este artículo aborda problemas comunes en los que el contenido virtual no puede mostrarse en 3D object tracking. Proporciona métodos sistemáticos de troubleshooting y sugerencias de mejora para ayudar a los desarrolladores a localizar y resolver problemas rápidamente.

Causas comunes y métodos de troubleshooting

Que el contenido no se muestre suele implicar fallo de object recognition, errores de implementación de funciones o restricciones de permission. A continuación se indican las causas principales y los pasos de troubleshooting:

Fallo de object recognition

Síntoma: después de apuntar la cámara al target object, el contenido virtual no aparece en absoluto. Troubleshooting:

  • Comprobar la calidad del modelo: asegúrese de que el 3D model y el object cumplen los requisitos de file format, texture, geometry y otros en model preparation.
  • Comprobar el target object: asegúrese de que la superficie del target object no tenga material reflectante o de espejo.
  • Ver logs: revise los application logs y confirme si el target model se cargó correctamente.

Sugerencias de mejora:

  • Optimizar el modelo: asegúrese de que las textures sean suficientemente ricas y que la geometry no tenga agujeros.
  • Comprobar lógica: asegúrese de que la aplicación haya cargado correctamente el target model. Si la carga falla, consulte target loading failure para inspección y reparación.

Errores de implementación de funciones

Síntoma: el object ha sido reconocido, pero el contenido virtual no se muestra o su posición es anormal.

Troubleshooting:

  • Comprobar configuración de ObjectTarget:
    • Compruebe si apunta al archivo correcto en la carpeta StreamingAssets según el tipo Source.
    • Compruebe si Scale se modificó según el tamaño real del object. Por ejemplo, si el tamaño BoundingBox calculado a partir del archivo de modelo es 10 x 10 x 30 y el tamaño real del object es 0.1m x 0.1m x 0.3m, Scale debe establecerse en 0.01.
  • Confirmar jerarquía del prefab:
    • El contenido virtual debe estar al mismo nivel que el target 3D model, y ambos deben ser nodos hijos de ObjectTarget. El contenido virtual no debe estar deshabilitado.
    • La propiedad Rotation del target 3D model debe establecer la dirección Y en 180.
    • La colocación del contenido virtual debe rodear completamente la posición del target 3D model.

Sugerencias de mejora:

  • Restablecer configuración: elimine y vuelva a crear ObjectTarget en la scene, arrastre el prefab según la especificación y vincule el 3D model.
  • Revisar logs: busque errores relacionados con ObjectTargetController, como fail to load target data.

Problemas de permission

Síntoma: originalmente funcionaba con normalidad, pero después de ejecutarse durante un tiempo el contenido desaparece. Troubleshooting: Confirme si pertenece a una de las siguientes situaciones:

  • Uso en XR headset
  • Uso de custom camera
  • Uso de AR Engine/ARFoundation en un teléfono

Si se trata de una de estas situaciones, es posible que esté usando una License de prueba.

Sugerencias de mejora:

  • Use una License oficial.

Problemas de contenido virtual

Síntoma: el contenido se muestra normalmente al principio, pero no se ve cuando la cámara está muy cerca o muy lejos del target object. Troubleshooting:

  • Comprobar ajustes de near y far clipping: asegúrese de que los ajustes de near y far clipping al renderizar contenido virtual estén dentro de un rango razonable.
  • Comprobar tamaño del content model: cuando el content model es demasiado grande, acercarse al target object puede hacer que la cámara atraviese el modelo y el contenido no se vea; cuando el content model es demasiado pequeño, alejarse del target object puede hacer que se vea demasiado pequeño para distinguirse.

Sugerencias de mejora:

  • Configure near y far clipping adecuados.
  • El tamaño físico del contenido virtual debe ser adecuado en comparación con el target object.

Resumen y mejores prácticas

El problema de contenido no mostrado suele deberse al object 3D model, la implementación del programa, permission o el propio contenido. Se recomienda hacer troubleshooting en este orden:

  1. Comprobar si la License es una versión oficial;
  2. Comprobar si el contenido virtual es adecuado;
  3. Confirmar la calidad del target 3D model;
  4. Confirmar si hay problemas en la implementación del programa o en la configuración de desarrollo.

Si el problema persiste, proporcione log files, grabaciones de pantalla y otros materiales mediante el foro oficial de EasyAR o soporte técnico para un análisis adicional.