Table of Contents

Fehlerbehebung: Inhalt wird nicht angezeigt/aktiviert

Bei der Verwendung der Bild-Cloud-Erkennung kann das Problem auftreten, dass virtuelle Inhalte nicht angezeigt oder nicht aktiviert werden. Dieser Artikel bietet eine systematische Methode zur Fehlerbehebung. Beachten Sie, dass die Ursachen für Fehler bei der Bild-Cloud-Erkennung in den meisten Fällen genau dieselben sind wie bei lokalen Erkennungsfehlern. Sie können den Abschnitt Fehlerbehebung zum Tracking planarer Bilder lesen. Hier werden nur cloud-erkennungsspezifische Probleme und Lösungen ergänzt.

Häufige Ursachen und Methoden zur Fehlerbehebung

Probleme mit der Netzwerkverbindung

Symptom: Nach dem Senden einer Erkennungsanfrage gibt es keine Antwort, oder es wird ein Fehlercode zurückgegeben.
Methoden zur Fehlerbehebung:

  • Prüfen Sie, ob das Gerät mit dem Netzwerk verbunden ist (Wi-Fi/4G/5G), und versuchen Sie zur Überprüfung, eine Webseite zu öffnen.
  • Prüfen Sie, ob die Netzwerkberechtigung der App aktiviert ist.
  • Erfassen Sie Netzwerkfehlerprotokolle im Code.
  • Testen Sie die CRS API-Konnektivität im Browser (Referenz: Health check | GET /ping).

Verbesserungsvorschläge:

  • Fügen Sie in der App eine Netzwerkstatusprüfung hinzu und zeigen Sie bei schwachem Netzwerk Hinweise an.
  • Legen Sie einen Request-Timeout fest und versuchen Sie es danach erneut oder wechseln Sie zu lokalem Tracking.

Fehler in der Servicekonfiguration

Symptom: Die Erkennungsanfrage wird abgelehnt und gibt Unauthorized oder Invalid Key zurück.
Methoden zur Fehlerbehebung:

  • Prüfen Sie, ob CRS API Key und Secret im Code korrekt eingetragen sind.
  • Prüfen Sie, ob die im Code eingetragene Client-end URL nicht falsch ist (z. B. versehentlich als Server-end URL eingetragen).
  • Bestätigen Sie, dass der License Key aktiviert und nicht abgelaufen ist (im Account Center auf der offiziellen EasyAR-Website prüfen).

Verbesserungsvorschläge:

  • Verwenden Sie die Schaltfläche Copy in der CRS image library, um Ihre zugehörige Servicekonfiguration zu kopieren und korrekt einzutragen.

Fehler in der Target-Bibliotheks-/App-Konfiguration

Symptom: Ein bestimmtes Target-Bild wurde früher problemlos erkannt, aber jetzt schlägt die Erkennungsanfrage fehl.
Methoden zur Fehlerbehebung:

  • Rufen Sie den Target-Status über die CRS API ab und bestätigen Sie, dass sich das Target-Bild im Zustand "activated" befindet ("active":"1").
  • Prüfen Sie, ob die target ID exakt mit der im Code übereinstimmt (Groß-/Kleinschreibung beachten).

Verbesserungsvorschläge:

  • Wenn die Cloud-Bildbibliothek aktualisiert/geändert wird, stellen Sie sicher, dass die spezifischen Targets der App immer aktiviert sind.
  • Prüfen Sie den Code sorgfältig.

Lokaler Ladefehler im Hybridmodus

Symptom: Die Cloud-Erkennung ist erfolgreich, aber das lokale Tracking startet nicht, und der Inhalt wird nicht angezeigt.
Methoden zur Fehlerbehebung:

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

Verbesserungsvorschläge:

  • Umgeben Sie die lokale Ladelogik mit try-catch, erfassen Sie Ausnahmen und versuchen Sie es erneut.
  • Stellen Sie sicher, dass der virtuelle Inhalt ein Child-Objekt von ImageTarget ist und nicht deaktiviert wurde.

Zusammenfassung und Best Practices

Probleme, bei denen Cloud-Erkennungsinhalte nicht angezeigt werden, konzentrieren sich hauptsächlich auf drei Bereiche: Netzwerk, Servicekonfiguration und Target-Status. Im Hybridmodus muss zusätzlich auf den lokalen Ladevorgang geachtet werden. Es wird empfohlen, in folgender Reihenfolge zu prüfen:

  1. Prüfen Sie die Netzwerkverbindung und bestätigen Sie die CRS-Servicekonnektivität;
  2. Prüfen Sie Serviceeinstellungen wie License, API Key/Secret und Client-end URL.
  3. Prüfen Sie den Status des Target-Bildes in der CRS image library und stellen Sie sicher, dass die Bildbibliothek mit der target ID in der App übereinstimmt;

Wenn das Problem komplex ist, aktivieren Sie EasyAR-Debug-Logs oder wenden Sie sich an den technischen Support.