Table of Contents

Crs häufig gestellte fragen

Im Folgenden finden Sie häufig gestellte Fragen und Antworten zur Verwendung der Cloud-Bilderkennungsfunktion.

F: Unterstützt CRS das Laden von 3D-Modellen/Virtuellen Inhalten aus der Cloud?

A: Ja, CRS unterstützt das Laden von 3D-Modellen/Virtuellen Inhalten über folgende Methoden:

  • meta-Attribut: Speichern von AR-Inhalten im meta-Feld des Zielbildes als Textdatei. 3D-Modelle können per Base64 kodiert oder als Cloud-Speicher-URL (z.B. Alibaba Cloud OSS, AWS S3) hinterlegt werden.
  • Ladeprozess: Nachdem der Client die meta-Daten von CRS abruft, werden diese mit einer 3D-Engine (z.B. Unity, Three.js) geparst und geladen.
  • Referenzdokumentation: Siehe Erkennungsziele erstellen | POST /targets.

[!HINWEIS]
Verwenden Sie für große Dateien (>2MB) die URL-Methode, um zu vermeiden, dass der Anfragekörper durch Base64-Kodierung zu groß wird.

F: Gibt es Einschränkungen bei der Erkennungshäufigkeit mit CRS?

A: Es gibt keine Begrenzung der Gesamterkennungen, jedoch existieren Stufen für die Parallelverarbeitung:

  • Basismodus: Geeignet für Anwendungen mit QPS < 50. Keine festen Grenzen, aber Einhaltung des Fair-Use-Prinzips erforderlich.
  • Hochlastmodus: Bei QPS ≥ 50 wird ein Upgrade auf dedizierte Cloud-Ressourcen empfohlen, um Erkennungsstabilität und niedrige Latenz zu gewährleisten.

[!WICHTIG]
Falls Ihre Anwendung während Feiertagen oder Großveranstaltungen vorübergehend hohe Lastspitzen erwarten könnte, kontaktieren Sie den EasyAR-Support mindestens 3 Werktage im Voraus für ein Service-Upgrade.

F: Warum gibt die Web Service API 404 zurück?

A: 404-Fehler deuten meist auf einen nicht existierenden URL-Pfad oder nicht gefundene Ressourcen hin. Häufige Ursachen:

  • Falsches URL-Format: Zugriff auf nicht vorhandene Endpunkte. Beispiel: Direkter Aufruf von http://your_crs_uuid.na1.crs.easyar.com:8888 ist ungültig; korrekt wäre z.B. http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Leeres Erkennungsergebnis: Der Aufruf von /search gibt ebenfalls 404 zurück, wenn kein Ziel gefunden wurde, mit dem Hinweis No result: there is no matching.

Fehlerbehebung:

  1. URL auf korrekte Schreibweise prüfen (inkl. UUID und Port).
  2. Dienstverfügbarkeit über /ping testen.
  3. Vollständigkeit der Anfrageparameter prüfen (z.B. Bilddaten, API-Key).

Lösungsvorschlag: Bei 404 von /search wurde kein Ziel erkannt. Benutzer sollten den Aufnahmewinkel anpassen oder prüfen, ob das Ziel in CRS hochgeladen wurde.

F: Was sind häufige Ursachen für Web Service API-Fehlercodes?

A: Neben 404 treten folgende Fehlercodes häufig auf:

  • 400 invalid appId (appKey)

    • Ursache: Angefragter Key ist falsch oder Signaturvalidierung fehlgeschlagen.
    • Prüfung: Sicherstellen, dass der Key aus der CRS-Bibliothek kopiert wurde; ob POST-Anfragen die volle Signatur enthalten; ob Content-Type: application/json als Parameter genutzt wird.

  • 400 invalid date

    • Ursache: Ungültiger Zeitstempel oder zu große Abweichung zur Serverzeit (meist ±5 Minuten toleriert).
    • Prüfung: Gerätezeit und Zeitzoneneinstellungen überprüfen.

  • 415 unsupported media type

    • Ursache: HTTP-Header enthält nicht Content-Type: application/json oder Anfragekörper ist fehlerhaft.
    • Prüfung: Sicherstellen, dass POST-Header Content-Type: application/json enthalten und der Body gültiges JSON ist.

Allgemeiner Hinweis: Alle CRS-API-Anfragen müssen strikt der CRS-API-Dokumentation folgen.

Hinweis: Diese FAQ decken häufige CRS-Probleme ab. Für neue Probleme können Sie uns gerne Feedback geben und kontaktieren!