Table of Contents

Fehlerbehebung: Inhalte werden nicht angezeigt/aktiviert

Bei der Verwendung der Cloud-basierten Bilderkennung kann es vorkommen, dass virtuelle Inhalte nicht angezeigt oder aktiviert werden. Dieser Artikel bietet eine systematische Fehlerbehebungsmethode. Es ist wichtig zu beachten, dass die Ursachen für ein Scheitern der Cloud-basierten Bilderkennung in den meisten Fällen identisch mit denen des lokalen Erkennungsversagens sind. Bitte konsultieren Sie das Kapitel Fehlerbehebung für die Tracking von ebenen Bildern. Hier werden nur cloud-spezifische Probleme und Lösungen ergänzt.

Häufige ursachen und lösungsansätze

Netzwerkverbindungsprobleme

Symptom: Nach dem Senden der Erkennungsanfrage keine Antwort oder Rückgabe eines Fehlercodes.
Lösungsansatz:

  • Überprüfen Sie, ob das Gerät mit dem Internet verbunden ist (Wi-Fi/4G/5G), versuchen Sie, eine Webseite zu öffnen.
  • Überprüfen Sie, ob die App die Berechtigung zum Internetzugriff hat.
  • Fangen Sie Netzwerkfehlerprotokolle im Code ab.
  • Testen Sie die Erreichbarkeit der CRS-API im Browser (Referenz: Health Check | GET /ping).

Verbesserungsvorschlag:

  • Fügen Sie in der App eine Netzwerkstatusprüfung hinzu, mit Hinweis bei schwachem Netz.
  • Setzen Sie eine Anfrage-Timeout mit Wiederholung oder greifen Sie auf lokales Tracking zurück.

Falsche dienste-konfiguration

Symptom: Die Erkennungsanfrage wird abgelehnt, Rückgabe von Unauthorized oder Invalid Key.
Lösungsansatz:

  • Überprüfen Sie, ob der im Code eingegebene CRS-API-Key und Secret korrekt sind.
  • Überprüfen Sie, ob die Client-end-URL im Code nicht falsch eingegeben wurde (z. B. versehentlich die Server-end-URL eingetragen).
  • Stellen Sie sicher, dass der License-Key aktiviert und nicht abgelaufen ist (im EasyAR-Kontobereich prüfen).

Verbesserungsvorschlag:

  • Verwenden Sie die Kopieren-Schaltfläche in der CRS-Bibliothek, um Ihre Dienste-Konfiguration zu kopieren und sicherzustellen, dass sie korrekt eingetragen ist.

Zielbibliotheks-/anwendungskonfigurationsfehler

Symptom: Ein Zielbild wurde früher erkannt, aber jetzt schlägt die Erkennungsanfrage fehl.
Lösungsansatz:

  • Rufen Sie den Zielstatus über die CRS-API ab und bestätigen Sie, dass das Zielbild den Status "Aktiviert" hat ("active":"1").
  • Überprüfen Sie, ob die Ziel-ID exakt mit der im Code übereinstimmt (Groß-/Kleinschreibung beachten).

Verbesserungsvorschlag:

  • Wenn die Cloud-Bibliothek aktualisiert/geändert wird, stellen Sie sicher, dass die spezifischen Ziele der App immer aktiviert sind.
  • Gründliche Code-Überprüfung.

Lokales laden im hybridmodus fehlgeschlagen

Symptom: Cloud-Erkennung erfolgreich, aber lokales Tracking startet nicht, Inhalte werden nicht angezeigt.
Lösungsansatz:

  • Bestätigen Sie, dass beim lokalen Laden des ImageTarget keine Ausnahme ausgelöst wurde (Protokolle prüfen).
  • Überprüfen Sie, ob der ImageTracker aktiviert ist.

Verbesserungsvorschlag:

  • Umschließen Sie die lokale Ladungslogik mit try-catch, um Ausnahmen abzufangen und erneut zu versuchen.
  • Stellen Sie sicher, dass virtuelle Inhalte untergeordnete Objekte des ImageTarget sind und nicht deaktiviert wurden.

Zusammenfassung und best practices

Probleme mit der Anzeige von Cloud-erkannter Inhalten konzentrieren sich hauptsächlich auf Netzwerk, Dienste-Konfiguration und Zielstatus. Im Hybridmodus muss zusätzlich der lokale Ladevorgang beachtet werden. Es wird empfohlen, in folgender Reihenfolge vorzugehen:

  1. Netzwerkverbindung prüfen, Erreichbarkeit des CRS-Dienstes bestätigen;
  2. Lizenz, API-Key/Secret, Client-end-URL und andere Dienste-Einstellungen überprüfen.
  3. Status des Zielbildes in der CRS-Bibliothek prüfen, sicherstellen, dass die Ziel-ID in Bibliothek und App übereinstimmt;

Bei komplexen Problemen können Sie die EasyAR-Debug-Protokolle aktivieren oder den technischen Support kontaktieren.