Table of Contents

Diagnóstico y reparación: contenido no visible

Este artículo proporciona métodos sistemáticos de verificación y sugerencias de mejora para problemas comunes de visualización de contenido virtual en el seguimiento de imágenes planas, ayudando a los desarrolladores a localizar y resolver problemas rápidamente.

Causas comunes y métodos de verificación

La falta de visualización de contenido generalmente involucra fallos en el reconocimiento de imágenes, errores de implementación funcional o restricciones de permisos. A continuación se detallan las principales causas y pasos de verificación:

Fallo en el reconocimiento de imágenes

Síntoma: El contenido virtual no aparece en absoluto después de apuntar la cámara hacia la imagen objetivo.
Métodos de verificación:

  • Verifique la reconocibilidad de la imagen: Utilice la herramienta de detección de imágenes objetivo para cargar la imagen y confirme su puntuación de reconocibilidad (debe ser de 4~5 estrellas).
  • Valide la calidad de la imagen: Asegúrese de que la imagen cumple con los requisitos de textura, tamaño y proporción descritos en las mejores prácticas.
  • Verifique la entidad física de la imagen objetivo: Confirme que la superficie del soporte físico (póster, tarjeta, etc.) no refleje luz y esté plana sin dobleces.
  • Revise los registros: Consulte los registros de la aplicación, busque el evento TargetLoad para confirmar si la imagen objetivo se cargó correctamente.

Sugerencias de mejora:

  • Optimice la imagen: Aumente el contraste, evite patrones repetitivos, asegure que el sujeto ocupe más del 70% del área.
  • Reemplace la imagen: Si el problema persiste tras optimizarla, pruebe con imágenes de prueba del Sample oficial (ej. namecard.jpg) para verificar si el problema radica en la imagen original.
  • Asegure la entidad física: Utilice superficies mate o rugosas, manténgalas planas sin dobleces ni curvaturas.
  • Verifique la lógica: Confirme que la aplicación haya cargado correctamente la imagen objetivo utilizada en la prueba.

Error en la implementación funcional

Síntoma: La imagen es reconocida, pero el contenido virtual no se muestra o aparece en posición anómala.

Métodos de verificación:

  • Verifique la configuración de ImageTarget:
    • Según el tipo de Source, compruebe que apunte al archivo correcto dentro de la carpeta StreamingAssets.
    • Confirme que Scale esté configurado con el tamaño físico real.
  • Valide la jerarquía del prefab: El contenido virtual (ej. Cube) debe ser un nodo hijo de ImageTarget y no estar desactivado.

Sugerencias de mejora:

  • Restablezca la configuración: Elimine y vuelva a crear el ImageTarget en la escena, arrastre el prefab siguiendo las normas y vincule la imagen.
  • Simplifique la prueba: Elimine temporalmente scripts personalizados, mantenga solo un Cube básico para confirmar un escenario mínimo funcional.
  • Revise registros: Busque errores relacionados con ImageTargetController, como fail to load target data.

Problemas de permisos

Síntoma: El contenido desaparece tras funcionar correctamente durante un tiempo.
Métodos de verificación:
Confirme si corresponde a alguno de estos escenarios:

  • Uso en visores XR
  • Uso de cámara personalizada
  • Uso de AR Engine/ARFoundation en móviles

Si pertenece a alguno de estos casos, probablemente esté utilizando una licencia de prueba.

Sugerencias de mejora:

  • Utilice una licencia oficial.

Problemas con el contenido virtual

Síntoma: El contenido se visualiza normalmente, pero desaparece cuando la cámara está muy cerca/lejos del objetivo.
Métodos de verificación:

  • Verifique los planos de recorte near/far: Asegúrese de que los planos de recorte near/far durante el renderizado del contenido estén en un rango razonable.
  • Compruebe el tamaño del modelo de contenido: Modelos demasiado grandes pueden causar "clipping" al acercarse; modelos muy pequeños pueden volverse imperceptibles al alejarse.

Sugerencias de mejora:

  • Configure planos de recorte near/far adecuados.
  • Ajuste el tamaño del contenido virtual según las dimensiones físicas de la entidad de la imagen objetivo.

Resumen y mejores prácticas

Los problemas de visualización suelen originarse por imágenes, implementación, permisos o el contenido mismo. Se recomienda verificar en este orden:

  1. Confirme si la licencia es oficial.
  2. Verifique la idoneidad del contenido virtual.
  3. Valide la calidad de la imagen objetivo.
  4. Detecte errores en la implementación o configuración de desarrollo.

Si el problema persiste, solicite análisis adicional mediante registros, grabaciones de pantalla, etc., a través del foro oficial de EasyAR o soporte técnico.