Table of Contents

Questions fréquentes CRS

Voici les questions et réponses courantes lors de l'utilisation de la fonction cloud image recognition.

Q: CRS prend-il en charge le chargement de modèles 3D/contenus virtuels depuis le cloud?

A: Oui. CRS prend en charge le chargement de modèles 3D/contenus virtuels des manières suivantes:

  • Propriété meta: stockez le contenu AR dans le champ meta de l'image target, au format fichier texte. Les modèles 3D peuvent être encodés en texte via Base64, ou enregistrés comme URL de stockage cloud, par exemple Alibaba Cloud OSS ou AWS S3.
  • Processus de chargement: après avoir obtenu les données meta depuis CRS, le client utilise un 3D engine, comme Unity ou Three.js, pour analyser et charger le modèle.
  • Documentation de référence: voir Créer un target de reconnaissance | POST /targets.
Note

Pour les fichiers volumineux (>2MB), utilisez la méthode URL afin d'éviter un request body trop grand causé par l'encodage Base64.

Q: CRS a-t-il une limite du nombre de reconnaissances?

A: Il n'y a pas de limite totale du nombre de reconnaissances, mais il existe des niveaux de concurrency:

  • Mode de base: adapté aux applications avec QPS < 50. Il n'y a pas de limite stricte, mais le principe de fair use doit être respecté.
  • Mode haute concurrency: lorsque QPS >= 50, il est recommandé de passer à un cloud service à ressources dédiées pour garantir la stabilité de reconnaissance et une faible latence.
Important

Si votre application peut subir une hausse temporaire de concurrency pendant des jours fériés ou de grands événements, contactez impérativement le support technique EasyAR au moins 3 jours ouvrés à l'avance pour demander une mise à niveau du service.

Q: Pourquoi Web Service API renvoie-t-elle 404?

A: Une erreur 404 signifie généralement que le chemin URL demandé n'existe pas ou que la ressource est introuvable. Les causes courantes sont les suivantes:

  • Format d'URL incorrect: un endpoint inexistant a été consulté. Par exemple, accéder directement à http://your_crs_uuid.na1.crs.easyar.com:8888 est invalide. Utilisez un endpoint complet comme http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Résultat de reconnaissance vide: lors de l'appel de l'interface /search, si aucun target ne correspond, 404 est également renvoyé, avec le message body No result: there is no matching.

Étapes de dépannage:

  1. Confirmez que l'URL est correctement écrite, y compris UUID et port.
  2. Utilisez l'interface /ping pour tester la disponibilité du service.
  3. Vérifiez que les paramètres de requête sont complets, comme les données d'image et API Key.

Suggestion de solution: si /search renvoie 404, cela signifie que l'image actuelle ne correspond à aucun target. Vous pouvez guider l'utilisateur pour ajuster l'angle de prise de vue ou vérifier que le target a été téléversé vers CRS.

Q: Quelles sont les causes courantes des codes d'erreur renvoyés par Web Service API?

A: En dehors de 404, les codes d'erreur suivants sont courants:

  • 400 invalid appId (appKey)

    • Cause: le Key demandé est incorrect, ou la vérification de signature a échoué.
    • Dépannage: confirmez que votre Key a été copié depuis la CRS image library; que la requête POST contient une signature complète; et que les paramètres de requête utilisent Content-Type: application/json.

  • 400 invalid date

    • Cause: le timestamp de la requête est invalide ou trop différent de l'heure du serveur, généralement dans une plage de +/-5 minutes.
    • Dépannage: vérifiez que l'heure de l'appareil est exacte, en particulier les paramètres de fuseau horaire.

  • 415 unsupported media type

    • Cause: le HTTP Header ne définit pas Content-Type: application/json, ou le format du request body est incorrect.
    • Dépannage: assurez-vous que le Header de la requête POST contient Content-Type: application/json et que le Body est un JSON valide.

Suggestion générale: toutes les requêtes CRS API doivent suivre strictement la documentation CRS API.

Remarque: la FAQ ci-dessus couvre les problèmes fréquents d'utilisation de CRS. Si vous devez signaler un nouveau problème, n'hésitez pas à envoyer un retour et à nous contacter!