Table of Contents

Dépannage : contenu non affiché/activé

Lors de l'utilisation de la reconnaissance d'images cloud, vous pouvez rencontrer des problèmes où le contenu virtuel ne s'affiche pas ou ne s'active pas. Cet article fournit une méthode de dépannage systématique. Il est important de noter que, dans la plupart des cas, les raisons d'un échec de reconnaissance cloud sont identiques à celles d'un échec de reconnaissance locale. Reportez-vous au chapitre Dépannage du suivi d'image plane. Seuls les problèmes et solutions spécifiques à la reconnaissance cloud sont complétés ici.

Causes courantes et méthodes de dépannage

Problèmes de connexion réseau

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

  • Vérifiez si l'appareil est connecté à Internet (Wi-Fi/4G/5G), essayez d'ouvrir une page web pour vérifier.
  • Vérifiez si l'application dispose des autorisations d'accès réseau.
  • Capturez les journaux d'erreurs réseau dans le code.
  • Testez la connectivité de l'API CRS dans un navigateur (référence : Vérification d'état | GET /ping).

Recommandation d'amélioration :

  • Ajoutez une détection de l'état du réseau dans l'application, avec une notification en cas de réseau faible.
  • Configurez une nouvelle tentative après expiration du délai de requête ou dégradez vers le suivi local.

Erreur de configuration du service

Symptôme : La requête de reconnaissance est rejetée, retourne Unauthorized ou Invalid Key.
Méthode de dépannage :

  • Vérifiez que la CRS API Key et le Secret saisis dans le code sont corrects.
  • Vérifiez que l'URL Client-end saisie dans le code n'est pas erronée (par exemple, si l'URL Server-end a été saisie par erreur).
  • Confirmez que la License Key est activée et n'a pas expiré (vérifiez dans le centre de compte EasyAR).

Recommandation d'amélioration :

  • Utilisez le bouton Copier dans la galerie CRS pour copier votre configuration de service associée, assurant ainsi une saisie correcte.

Erreur de configuration de la bibliothèque cible/de l'application

Symptôme : Une image cible qui était reconnue sans problème auparavant échoue maintenant.
Méthode de dépannage :

  • Obtenez l'état de la cible via l'API CRS, confirmez que l'image cible est dans l'état "activé" ("active":"1").
  • Vérifiez que l'ID de la cible correspond exactement à celui dans le code (respect de la casse).

Recommandation d'amélioration :

  • Lorsque la galerie cloud est mise à jour/modifiée, assurez-vous que les cibles spécifiques de l'application sont toujours activées.
  • Vérification minutieuse du code.

Échec de chargement local en mode hybride

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

  • Confirmez que le chargement local de ImageTarget ne génère pas d'exception (consultez les journaux).
  • Vérifiez si ImageTracker est activé.

Recommandation d'amélioration :

  • Encapsulez la logique de chargement local dans un try-catch pour capturer les exceptions et retenter.
  • Assurez-vous que le contenu virtuel est un enfant de ImageTarget et n'est pas désactivé.

Résumé et meilleures pratiques

Les problèmes de non-affichage du contenu en reconnaissance cloud se concentrent principalement sur trois aspects : réseau, configuration du service, état de la cible. Le mode hybride nécessite également une attention au chargement local. Il est recommandé de procéder au dépannage dans l'ordre de priorité suivant :

  1. Vérifiez la connexion réseau et la connectivité au service CRS ;
  2. Vérifiez les paramètres de service : License, API Key/Secret, URL Client-end.
  3. Vérifiez l'état de l'image cible dans la galerie CRS, assurez la cohérence de l'ID cible entre la galerie et l'application ;

Si le problème est complexe, activez les journaux de débogage EasyAR ou contactez le support technique.