Table of Contents

Diagnóstico e correção: conteúdo não exibido

Este artigo trata de problemas comuns em que o conteúdo virtual não pode ser exibido no planar image tracking. Ele fornece métodos sistemáticos de troubleshooting e sugestões de melhoria para ajudar desenvolvedores a localizar e resolver problemas rapidamente.

Causas comuns e métodos de troubleshooting

Conteúdo não exibido geralmente envolve image recognition, erros de implementação de função ou restrições de permission. A seguir estão as principais causas e etapas de troubleshooting:

Falha de image recognition

Sintoma: depois que a câmera aponta para a target image, o conteúdo virtual não aparece. Troubleshooting:

  • Verificar recognition score da imagem: use a target image detection tool para enviar a image e confirmar o recognition score, que deve alcançar 4-5 estrelas.
  • Verificar qualidade da image: certifique-se de que a image atenda aos requisitos de texture, tamanho e proporção em best practices.
  • Verificar target image entity: certifique-se de que a superfície da target image entity, como pôster ou cartão, não tenha reflexão e permaneça plana, sem dobras.
  • Ver logs: verifique application logs, procure o event TargetLoad e confirme se a target image foi carregada com sucesso.

Sugestões de melhoria:

  • Otimizar a image: aumentar contraste, evitar padrões repetidos e garantir que o assunto principal ocupe mais de 70% da imagem.
  • Substituir a image: se o problema persistir após a otimização, use uma imagem de teste do Sample oficial, como namecard.jpg, para verificar se o problema está na própria image.
  • Garantir a entidade física: a target entity deve usar, sempre que possível, uma superfície fosca ou relativamente áspera, mantendo a superfície plana sem dobras ou curvaturas.
  • Verificar lógica: certifique-se de que a aplicação carregou corretamente a target image usada para teste.

Erros de implementação de função

Sintoma: a image foi reconhecida, mas o conteúdo virtual não é exibido ou sua posição é anormal.

Troubleshooting:

  • Verificar configuração de ImageTarget:
    • Verifique, de acordo com o tipo Source, se aponta para o arquivo correto na pasta StreamingAssets.
    • Verifique se Scale está definido como o tamanho físico real.
  • Confirmar hierarquia do prefab: conteúdo virtual, como Cube, deve ser child node de ImageTarget e não pode estar desativado.

Sugestões de melhoria:

  • Redefinir configuração: exclua e recrie ImageTarget na scene, arraste o prefab conforme a especificação e vincule a image.
  • Simplificar teste: remova temporariamente custom scripts e mantenha apenas o Cube básico para confirmar a scene mínima executável.
  • Verificar logs: procure erros relacionados a ImageTargetController, como fail to load target data.

Problemas de permission

Sintoma: funcionava normalmente no início, mas depois de executar por algum tempo o conteúdo desaparece. Troubleshooting: Confirme se você pertence a uma das situações a seguir:

  • Uso em XR headset
  • Uso de custom camera
  • Uso de AR Engine/ARFoundation no telefone

Se for uma dessas situações, você pode estar usando uma License de teste.

Sugestões de melhoria:

  • Use uma License oficial.

Problemas de conteúdo virtual

Sintoma: o conteúdo era exibido normalmente no início, mas não pode ser visto quando a câmera está muito perto ou muito longe do target object. Troubleshooting:

  • Verificar configurações de near e far clipping: certifique-se de que as configurações de near e far clipping ao renderizar conteúdo virtual estejam em uma faixa razoável.
  • Verificar tamanho do content model: quando o content model é grande demais, aproximar-se do target object pode causar atravessamento do modelo e tornar o conteúdo invisível; quando o content model é pequeno demais, afastar-se do target object pode torná-lo pequeno demais para ver claramente.

Sugestões de melhoria:

  • Defina near e far clipping apropriados.
  • O tamanho físico do conteúdo virtual deve ser adequado em comparação à target image entity.

Resumo e práticas recomendadas

O problema de conteúdo não exibido geralmente é causado pela image, implementação do programa, permissions ou pelo próprio conteúdo. Recomenda-se troubleshooting nesta ordem:

  1. Verificar se a License é uma versão oficial;
  2. Verificar se o próprio conteúdo virtual é adequado;
  3. Verificar a qualidade da target image;
  4. Confirmar se há problemas na implementação do programa ou configuração de desenvolvimento.

Se o problema persistir, forneça log files, gravações de tela e outros materiais pelo fórum oficial EasyAR ou suporte técnico para análise adicional.