Table of Contents

Crs perguntas frequentes

A seguir estão perguntas e respostas comuns sobre o uso do recurso de reconhecimento de imagem na nuvem.

Q: Crs suporta carregar modelos 3d/conteúdo virtual da nuvem?

A: Sim, o CRS suporta carregar modelos 3D/conteúdo virtual através de:

  • Atributo meta: Armazenar conteúdo AR no campo meta da imagem de destino como arquivo de texto. Modelos 3D podem ser codificados em Base64 ou salvos como URL de armazenamento em nuvem (ex: Alibaba Cloud OSS, AWS S3).
  • Fluxo de carregamento: Após o cliente obter os dados meta do CRS, use engines 3D (como Unity, Three.js) para analisar e carregar o modelo.
  • Documentação de referência: Consulte Criar alvo de reconhecimento | POST /targets.
Nota

Para arquivos grandes (>2MB), use URLs para evitar corpos de requisição excessivos com codificação Base64.

Q: O crs tem limite de reconhecimentos?

A: Não há limite total de reconhecimentos, mas existem níveis de concorrência:

  • Modo básico: Adequado para aplicações com QPS < 50. Sem limites rígidos, mas deve seguir o princípio de uso justo.
  • Modo alta concorrência: Para QPS ≥ 50, recomenda-se atualizar para serviço de nuvem de recursos dedicados para garantir estabilidade e baixa latência.
Importante

Se sua aplicação enfrentar picos temporários de concorrência (feriados/eventos), contate o suporte EasyAR com pelo menos 3 dias úteis de antecedência para solicitar atualização.

Q: Por que a api web service retorna 404?

A: O erro 404 geralmente indica URL inexistente ou recurso não encontrado. Causas comuns:

  • Formato de URL incorreto: Acesso a endpoint inválido. Ex: http://your_crs_uuid.na1.crs.easyar.com:8888 é inválido; use endpoints completos como http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Resultado vazio: A chamada /search retorna 404 se nenhum alvo for correspondido, com corpo No result: there is no matching.

Etapas de diagnóstico:

  1. Verifique ortografia da URL (UUID e porta).
  2. Teste disponibilidade com /ping.
  3. Confira parâmetros obrigatórios (ex: dados de imagem, API Key).

Solução: Se /search retornar 404, a imagem não corresponde a nenhum alvo. Oriente o usuário a ajustar o ângulo ou verificar se o alvo foi enviado ao CRS.

Q: Quais são as causas comuns para códigos de erro da api web service?

A: Além do 404, estes códigos são frequentes:

  • 400 invalid appId (appKey)

    • Causa: Key incorreta ou falha na verificação de assinatura.
    • Diagnóstico: Confirme se a Key foi copiada do CRS; verifique assinatura em requisições POST; use Content-Type: application/json.

  • 400 invalid date

    • Causa: Timestamp inválido ou diferença excessiva do horário do servidor (geralmente ±5 minutos).
    • Diagnóstico: Verifique precisão do horário do dispositivo (especialmente fuso horário).

  • 415 unsupported media type

    • Causa: Header HTTP sem Content-Type: application/json ou corpo de requisição malformado.
    • Diagnóstico: Garanta que requisições POST tenham Content-Type: application/json e corpo JSON válido.

Recomendação geral: Todas as requisições à API CRS devem seguir estritamente a Documentação da API CRS.

Nota: Este FAQ cobre questões frequentes do CRS. Para reportar novos problemas, entre em contato!