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 3D object 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 falha de object 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 object recognition

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

  • Verificar qualidade do modelo: certifique-se de que o 3D model e o object atendam aos requisitos de file format, texture, geometry e outros em model preparation.
  • Verificar target object: certifique-se de que a superfície do target object não tenha material reflexivo ou espelhado.
  • Ver logs: verifique application logs e confirme se o target model foi carregado com sucesso.

Sugestões de melhoria:

  • Otimizar o modelo: certifique-se de que textures sejam ricas o suficiente e que a geometry não tenha buracos.
  • Verificar lógica: certifique-se de que a aplicação carregou corretamente o target model. Se o carregamento falhar, consulte target loading failure para inspeção e correção.

Erros de implementação de função

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

Troubleshooting:

  • Verificar configuração de ObjectTarget:
    • Verifique, de acordo com o tipo Source, se aponta para o arquivo correto na pasta StreamingAssets.
    • Verifique se Scale foi modificado de acordo com o tamanho real do object. Por exemplo, se o tamanho BoundingBox calculado pelo arquivo de modelo for 10 x 10 x 30, e o tamanho real do object for 0.1m x 0.1m x 0.3m, então Scale deve ser definido como 0.01.
  • Confirmar hierarquia do prefab:
    • O conteúdo virtual deve estar no mesmo nível do target 3D model, e ambos devem ser child nodes de ObjectTarget. O conteúdo virtual não pode estar desativado.
    • A propriedade Rotation do target 3D model precisa definir a direção Y como 180.
    • A colocação do conteúdo virtual deve ser feita completamente em torno da posição do target 3D model.

Sugestões de melhoria:

  • Redefinir configuração: exclua e recrie ObjectTarget na scene, arraste o prefab conforme a especificação e vincule o 3D model.
  • Verificar logs: procure erros relacionados a ObjectTargetController, 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 ao target object.

Resumo e práticas recomendadas

O problema de conteúdo não exibido geralmente é causado pelo object 3D model, 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. Confirmar a qualidade do target 3D model;
  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.