Table of Contents

Dépannage : contenu non affiché/activé

Lors de l'utilisation de la reconnaissance d'images dans le cloud, vous pouvez rencontrer un problème où le contenu virtuel ne peut pas être affiché ou activé. Cet article fournit une méthode de dépannage systématique. Il faut rappeler que, dans la plupart des cas, les causes d'échec de la reconnaissance d'images dans le cloud sont exactement les mêmes que celles de la reconnaissance locale. Vous pouvez consulter la section Dépannage du suivi d'images planes. Ici, seuls les problèmes et solutions propres à la reconnaissance cloud sont ajoutés.

Causes courantes et méthodes de dépannage

Problèmes de connexion réseau

Symptôme : aucune réponse après l'envoi d'une requête de reconnaissance, ou retour d'un code d'erreur.
Méthodes de dépannage :

  • Vérifiez si l'appareil est connecté au réseau (Wi-Fi/4G/5G) et essayez d'ouvrir une page web pour le vérifier.
  • Vérifiez si l'application dispose de l'autorisation réseau.
  • Capturez les logs d'erreur réseau dans le code.
  • Testez la connectivité de CRS API dans un navigateur (référence : Health check | GET /ping).

Suggestions d'amélioration :

  • Ajoutez dans l'application une détection de l'état du réseau et affichez une invite lorsque le réseau est faible.
  • Définissez un timeout de requête, puis réessayez ou basculez vers le tracking local.

Erreurs de configuration du service

Symptôme : la requête de reconnaissance est rejetée et retourne Unauthorized ou Invalid Key.
Méthodes de dépannage :

  • Vérifiez si CRS API Key et Secret renseignés dans le code sont corrects.
  • Vérifiez que le Client-end URL renseigné dans le code n'est pas erroné (par exemple saisi par erreur comme Server-end URL).
  • Confirmez que le License Key est activé et n'a pas expiré (vérifiez dans le centre de compte du site officiel EasyAR).

Suggestions d'amélioration :

  • Utilisez le bouton Copy dans la CRS image library pour copier votre configuration de service correspondante et vous assurer qu'elle est correctement renseignée.

Erreurs de configuration de la bibliothèque de targets/application

Symptôme : une target image était reconnue correctement auparavant, mais la requête de reconnaissance échoue maintenant.
Méthodes de dépannage :

  • Obtenez l'état du target via CRS API et confirmez que la target image est à l'état "activated" ("active":"1").
  • Vérifiez si le target ID correspond exactement à celui du code (sensible à la casse).

Suggestions d'amélioration :

  • Lorsque la bibliothèque d'images cloud est mise à jour/modifiée, assurez-vous que les targets spécifiques de l'application sont toujours activés.
  • Effectuez une vérification attentive du code.

Échec de chargement local en mode hybride

Symptôme : la reconnaissance cloud réussit, mais le tracking local ne démarre pas et le contenu ne s'affiche pas.
Méthodes de dépannage :

  • Confirmez qu'aucune exception n'est levée lors du chargement du ImageTarget local (consultez les logs).
  • Vérifiez si ImageTracker est activé.

Suggestions d'amélioration :

  • Encapsulez la logique de chargement local avec try-catch, capturez les exceptions et réessayez.
  • Assurez-vous que le contenu virtuel est un child object de ImageTarget et qu'il n'est pas désactivé.

Résumé et bonnes pratiques

Les problèmes où le contenu de reconnaissance cloud ne s'affiche pas se concentrent principalement sur trois aspects : réseau, configuration du service et état du target. En mode hybride, il faut également faire attention au chargement local. Il est recommandé de dépanner dans l'ordre suivant :

  1. Vérifier la connexion réseau et confirmer la connectivité du service CRS ;
  2. Vérifier les paramètres du service tels que License, API Key/Secret et Client-end URL.
  3. Vérifier l'état de la target image dans la CRS image library et s'assurer que la bibliothèque d'images correspond au target ID dans l'application ;

Si le problème est complexe, activez les logs de debug EasyAR ou contactez le support technique.