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 planar image 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 image 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 image recognition

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

  • Comprobar recognition score de la imagen: use la target image detection tool para cargar la image y confirmar la recognition score, que debe alcanzar 4-5 estrellas.
  • Verificar la calidad de la image: asegúrese de que la image cumpla los requisitos de texture, tamaño y proporción en best practices.
  • Comprobar la target image entity: asegúrese de que la superficie de la target image entity, como póster o tarjeta, no tenga reflejos y se mantenga plana sin pliegues.
  • Ver logs: revise los application logs, busque el evento TargetLoad y confirme si la target image se cargó correctamente.

Sugerencias de mejora:

  • Optimizar la image: aumentar el contraste, evitar patrones repetidos y asegurarse de que el sujeto principal ocupe más del 70% de la imagen.
  • Reemplazar la image: si el problema persiste tras optimizarla, use una imagen de prueba del Sample oficial, como namecard.jpg, para verificar si el problema está en la image.
  • Asegurar la entidad física: la target entity debe usar en lo posible una superficie mate o relativamente rugosa, y mantenerse plana sin pliegues ni curvaturas.
  • Comprobar lógica: asegúrese de que la aplicación haya cargado correctamente la target image usada para la prueba.

Errores de implementación de funciones

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

Troubleshooting:

  • Comprobar configuración de ImageTarget:
    • Compruebe si apunta al archivo correcto en la carpeta StreamingAssets según el tipo Source.
    • Compruebe si Scale está establecido en el tamaño físico real.
  • Confirmar jerarquía del prefab: el contenido virtual, como Cube, debe ser un nodo hijo de ImageTarget y no debe estar deshabilitado.

Sugerencias de mejora:

  • Restablecer configuración: elimine y vuelva a crear ImageTarget en la scene, arrastre el prefab según la especificación y vincule la image.
  • Simplificar prueba: elimine temporalmente custom scripts y conserve solo el Cube básico para confirmar la scene mínima ejecutable.
  • Revisar logs: busque errores relacionados con ImageTargetController, 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 la target image entity.

Resumen y mejores prácticas

El problema de contenido no mostrado suele deberse a la image, 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. Verificar la calidad de la target image;
  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.