Table of Contents

CRS Foire aux questions

Voici les questions fréquentes et leurs réponses concernant l'utilisation de la fonction de reconnaissance d'images cloud.

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

R : Oui, CRS prend en charge le chargement de modèles 3D/contenus virtuels via :

  • Propriété meta : Stocker le contenu AR dans le champ meta de l'image cible, au format fichier texte. Les modèles 3D peuvent être encodés en Base64 ou sauvegardés sous forme d'URL de stockage cloud (ex. Alibaba Cloud OSS, AWS S3).
  • Processus de chargement : Après avoir obtenu les données meta via CRS, le client utilise un moteur 3D (comme Unity, Three.js) pour analyser et charger le modèle.
  • Documentation de référence : Voir Créer une cible de reconnaissance | POST /targets.
Note

Pour les fichiers volumineux (>2Mo), utilisez l'approche par URL pour éviter que le corps de la requête ne devienne trop important à cause du codage Base64.

Q : CRS a-t-il des limites de nombre de reconnaissances ?

R : Il n'y a pas de limite totale de reconnaissances, mais des niveaux de concurrence existent :

  • Mode basique : Adapté aux applications avec QPS < 50. Aucune limite stricte, sous réserve du principe d'utilisation équitable.
  • Mode haute concurrence : Pour QPS ≥ 50, il est recommandé de passer à un service cloud dédié pour garantir stabilité et faible latence.
Important

Si votre application peut subir des pics temporaires de concurrence (ex. jours fériés ou événements majeurs), contactez le support EasyAR au moins 3 jours ouvrés à l'avance pour demander une mise à niveau.

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

R : L'erreur 404 indique généralement que l'URL demandée n'existe pas ou que la ressource est introuvable. Causes courantes :

  • Format d'URL incorrect : Accès à un endpoint inexistant. Ex. : http://your_crs_uuid.na1.crs.easyar.com:8888 est invalide ; utilisez plutôt un endpoint complet comme http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Résultat de reconnaissance vide : L'appel à /search renvoie aussi 404 si aucune cible ne correspond, avec le corps No result: there is no matching.

Procédure de dépannage :

  1. Vérifiez l'orthographe de l'URL, y compris l'UUID et le port.
  2. Testez la disponibilité du service via /ping.
  3. Contrôlez la complétude des paramètres (données d'image, clé API).

Recommandation : Si /search renvoie 404, cela signifie qu'aucune cible n'a été reconnue. Guidez l'utilisateur pour qu'il ajuste l'angle de prise de vue ou vérifie si la cible a bien été uploadée dans CRS.

Q : Quelles sont les causes courantes des codes d'erreur de l'API Web Service ?

R : Outre le 404, ces erreurs sont fréquentes :

  • 400 invalid appId (appKey)

    • Cause : La Key est incorrecte ou la vérification de signature a échoué.
    • Dépannage : Vérifiez que votre Key provient bien de la galerie CRS ; que la requête POST inclut une signature complète ; et que les paramètres utilisent Content-Type: application/json.

  • 400 invalid date

    • Cause : Horodatage invalide ou écart trop important avec l'heure du serveur (tolérance typique : ±5 minutes).
    • Dépannage : Vérifiez l'exactitude de l'heure de l'appareil (surtout le fuseau horaire).

  • 415 unsupported media type

    • Cause : L'en-tête HTTP manque Content-Type: application/json ou le corps de la requête est mal formaté.
    • Dépannage : Assurez-vous que les requêtes POST incluent Content-Type: application/json dans l'en-tête et un JSON valide dans le corps.

Recommandation générale : Toutes les requêtes API CRS doivent strictement suivre la Documentation de l'API CRS.

Note : Cette FAQ couvre les problèmes récurrents avec CRS. Pour signaler un nouveau problème, n'hésitez pas à nous contacter via contactez-nous !