Table of Contents

Perguntas frequentes sobre CRS

A seguir estão perguntas e respostas comuns durante o uso do recurso cloud image recognition.

Q: O CRS oferece suporte ao carregamento de modelos 3D/conteúdo virtual a partir da nuvem?

A: Sim. O CRS oferece suporte ao carregamento de modelos 3D/conteúdo virtual das seguintes maneiras:

  • Propriedade meta: armazene conteúdo AR no campo meta da imagem target, em formato de arquivo de texto. Modelos 3D podem ser codificados como texto via Base64 ou salvos como URLs de cloud storage, como Alibaba Cloud OSS ou AWS S3.
  • Processo de carregamento: depois que o cliente obtém os dados meta do CRS, ele usa um 3D engine, como Unity ou Three.js, para analisar e carregar o modelo.
  • Documentação de referência: veja Criar target de reconhecimento | POST /targets.
Nota

Para arquivos grandes (>2MB), use o método URL para evitar um request body muito grande causado pela codificação Base64.

Q: O CRS tem limite de número de reconhecimentos?

A: Não há limite total de número de reconhecimentos, mas existem níveis de concurrency:

  • Modo básico: adequado para aplicações com QPS < 50. Não há limite rígido, mas o princípio de fair use deve ser seguido.
  • Modo de alta concurrency: quando QPS >= 50, recomenda-se fazer upgrade para cloud service com recursos dedicados, para garantir estabilidade de reconhecimento e baixa latência.
Importante

Se sua aplicação puder enfrentar um aumento temporário de concurrency durante feriados ou grandes eventos, entre em contato com o suporte técnico da EasyAR com pelo menos 3 dias úteis de antecedência para solicitar um upgrade de serviço.

Q: Por que Web Service API retorna 404?

A: Um erro 404 normalmente indica que o caminho URL solicitado não existe ou que o recurso não foi encontrado. As causas comuns são:

  • Formato de URL incorreto: um endpoint inexistente foi acessado. Por exemplo, acessar diretamente http://your_crs_uuid.na1.crs.easyar.com:8888 é inválido. Use um endpoint completo como http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Resultado de reconhecimento vazio: ao chamar a interface /search, se nenhum target corresponder, 404 também será retornado, com o message body No result: there is no matching.

Etapas de troubleshooting:

  1. Confirme se a URL está escrita corretamente, incluindo UUID e porta.
  2. Use a interface /ping para testar a disponibilidade do serviço.
  3. Verifique se os parâmetros da solicitação estão completos, como dados de imagem e API Key.

Sugestão de solução: se /search retornar 404, isso significa que a imagem atual não correspondeu a nenhum target. Você pode orientar o usuário a ajustar o ângulo de captura ou verificar se o target foi enviado para o CRS.

Q: Quais são as causas comuns dos códigos de erro retornados por Web Service API?

A: Além de 404, os seguintes códigos de erro são comuns:

  • 400 invalid appId (appKey)

    • Causa: o Key solicitado está incorreto ou a verificação de signature falhou.
    • Troubleshooting: confirme se seu Key foi copiado da CRS image library; se a solicitação POST contém uma signature completa; e se os parâmetros da solicitação usam Content-Type: application/json.

  • 400 invalid date

    • Causa: o timestamp da solicitação é inválido ou difere demais do horário do servidor, normalmente dentro de +/-5 minutos.
    • Troubleshooting: verifique se o horário do dispositivo está correto, especialmente as configurações de fuso horário.

  • 415 unsupported media type

    • Causa: o HTTP Header não define Content-Type: application/json, ou o formato do request body está incorreto.
    • Troubleshooting: certifique-se de que o Header da solicitação POST contenha Content-Type: application/json e que o Body seja JSON válido.

Sugestão geral: todas as solicitações CRS API devem seguir rigorosamente a documentação CRS API.

Observação: as FAQ acima cobrem problemas frequentes no uso do CRS. Se precisar relatar um novo problema, envie feedback e entre em contato conosco!