Table of Contents

Solução de problemas: conteúdo não exibido/ativado

Ao usar reconhecimento de imagens na nuvem, você pode encontrar um problema em que o conteúdo virtual não pode ser exibido ou ativado. Este artigo fornece um método sistemático de solução de problemas. É importante lembrar que, na maioria dos casos, as causas da falha no reconhecimento de imagens na nuvem são exatamente as mesmas da falha no reconhecimento local. Você pode consultar a seção Solução de problemas do tracking de imagens planas. Aqui são adicionados apenas problemas e soluções específicos do reconhecimento na nuvem.

Causas comuns e métodos de solução de problemas

Problemas de conexão de rede

Sintoma: Não há resposta após o envio de uma solicitação de reconhecimento, ou um código de erro é retornado.
Métodos de solução de problemas:

  • Verifique se o dispositivo está conectado à rede (Wi-Fi/4G/5G) e tente abrir uma página web para validar.
  • Verifique se o aplicativo tem a permissão de rede ativada.
  • Capture logs de erros de rede no código.
  • Teste a conectividade da CRS API em um navegador (referência: Health check | GET /ping).

Sugestões de melhoria:

  • Adicione detecção do status da rede no aplicativo e mostre avisos quando a rede estiver fraca.
  • Defina timeout de solicitação e depois faça retry ou downgrade para tracking local.

Erros de configuração de serviço

Sintoma: A solicitação de reconhecimento é rejeitada e retorna Unauthorized ou Invalid Key.
Métodos de solução de problemas:

  • Verifique se o CRS API Key e o Secret preenchidos no código estão corretos.
  • Verifique se o Client-end URL preenchido no código não está incorreto (por exemplo, preenchido por engano como Server-end URL).
  • Confirme que o License Key está ativado e não expirou (verifique no centro de conta do site oficial da EasyAR).

Sugestões de melhoria:

  • Use o botão Copy na CRS image library para copiar sua configuração de serviço relacionada e garantir que ela esteja preenchida corretamente.

Erros de configuração da target library/aplicativo

Sintoma: Uma determinada target image era reconhecida sem problemas antes, mas agora a solicitação de reconhecimento falha.
Métodos de solução de problemas:

  • Obtenha o status do target pela CRS API e confirme que a target image está no estado "activated" ("active":"1").
  • Verifique se o target ID é exatamente igual ao do código (com diferenciação entre maiúsculas e minúsculas).

Sugestões de melhoria:

  • Quando a biblioteca de imagens na nuvem for atualizada/alterada, garanta que os targets específicos do aplicativo estejam sempre ativados.
  • Faça uma revisão cuidadosa do código.

Falha de carregamento local no modo híbrido

Sintoma: O reconhecimento na nuvem é bem-sucedido, mas o tracking local não inicia e o conteúdo não é exibido.
Métodos de solução de problemas:

  • Confirme que nenhuma exceção é lançada quando o ImageTarget local é carregado (verifique os logs).
  • Verifique se ImageTracker está ativado.

Sugestões de melhoria:

  • Envolva a lógica de carregamento local com try-catch, capture exceções e faça retry.
  • Garanta que o conteúdo virtual seja um child object de ImageTarget e não esteja desativado.

Resumo e melhores práticas

Problemas em que o conteúdo de reconhecimento na nuvem não é exibido concentram-se principalmente em três aspectos: rede, configuração de serviço e status do target. No modo híbrido, também é necessário prestar atenção ao carregamento local. Recomenda-se solucionar problemas na seguinte ordem:

  1. Verifique a conexão de rede e confirme a conectividade do serviço CRS;
  2. Verifique configurações de serviço como License, API Key/Secret e Client-end URL.
  3. Verifique o status da target image na CRS image library e garanta que a biblioteca de imagens esteja consistente com o target ID no aplicativo;

Se o problema for complexo, ative os logs de depuração do EasyAR ou entre em contato com o suporte técnico.