Table of Contents

Häufig gestellte Fragen zu CRS

Im Folgenden finden Sie häufige Fragen und Antworten zur Verwendung der Funktion cloud image recognition.

Q: 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 auf folgende Weise:

  • meta-Eigenschaft: Speichern Sie AR-Inhalte im Feld meta des target image im Textdateiformat. 3D-Modelle können per Base64 als Text kodiert oder als Cloud-Speicher-URL gespeichert werden, z. B. Alibaba Cloud OSS oder AWS S3.
  • Ladevorgang: Nachdem der Client meta-Daten von CRS erhalten hat, verwendet er eine 3D engine wie Unity oder Three.js, um das Modell zu analysieren und zu laden.
  • Referenzdokumentation: Siehe Erkennungsziel erstellen | POST /targets.
Anmerkung

Verwenden Sie bei großen Dateien (>2MB) die URL-Methode, um einen zu großen request body durch Base64-Kodierung zu vermeiden.

Q: Hat CRS eine Begrenzung der Erkennungsanzahl?

A: Es gibt keine Gesamtbegrenzung der Erkennungsanzahl, aber es gibt concurrency-Stufen:

  • Basismodus: Geeignet für Anwendungen mit QPS < 50. Es gibt keine harte Begrenzung, aber das Prinzip fair use muss eingehalten werden.
  • Modus für hohe concurrency: Bei QPS >= 50 wird empfohlen, auf einen Cloud-Dienst mit dedizierten Ressourcen zu aktualisieren, um Erkennungsstabilität und geringe Latenz sicherzustellen.
Wichtig

Wenn Ihre Anwendung während Feiertagen oder Großveranstaltungen vorübergehend stark steigende concurrency haben kann, kontaktieren Sie den technischen Support von EasyAR mindestens 3 Werktage im Voraus, um ein Service-Upgrade zu beantragen.

Q: Warum gibt Web Service API 404 zurück?

A: Ein 404-Fehler bedeutet normalerweise, dass der angeforderte URL-Pfad nicht existiert oder die Ressource nicht gefunden wurde. Häufige Gründe sind:

  • Falsches URL-Format: Es wurde auf einen nicht existierenden endpoint zugegriffen. Beispielsweise ist der direkte Zugriff auf http://your_crs_uuid.na1.crs.easyar.com:8888 ungültig. Verwenden Sie einen vollständigen endpoint wie http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Leeres Erkennungsergebnis: Beim Aufruf der Schnittstelle /search wird ebenfalls 404 zurückgegeben, wenn kein target übereinstimmt, mit dem message body No result: there is no matching.

Schritte zur Fehlersuche:

  1. Prüfen Sie, ob die URL einschließlich UUID und Port korrekt geschrieben ist.
  2. Verwenden Sie die Schnittstelle /ping, um die Dienstverfügbarkeit zu testen.
  3. Prüfen Sie, ob die Anforderungsparameter vollständig sind, z. B. Bilddaten und API Key.

Lösungsvorschlag: Wenn /search 404 zurückgibt, bedeutet dies, dass das aktuelle Bild kein target getroffen hat. Sie können den Benutzer anleiten, den Aufnahmewinkel anzupassen oder zu prüfen, ob das target in CRS hochgeladen wurde.

Q: Was sind häufige Ursachen für Fehlerantwortcodes der Web Service API?

A: Neben 404 sind die folgenden Fehlercodes häufig:

  • 400 invalid appId (appKey)

    • Grund: Der angeforderte Key ist falsch oder die Signaturprüfung ist fehlgeschlagen.
    • Fehlersuche: Prüfen Sie, ob Ihr Key aus der CRS image library kopiert wurde; ob die POST-Anforderung eine vollständige Signatur enthält; und ob die Anforderungsparameter Content-Type: application/json verwenden.

  • 400 invalid date

    • Grund: Der request timestamp ist ungültig oder weicht zu stark von der Serverzeit ab, üblicherweise muss er innerhalb von +/-5 Minuten liegen.
    • Fehlersuche: Prüfen Sie, ob die Gerätezeit korrekt ist, besonders die Zeitzoneneinstellungen.

  • 415 unsupported media type

    • Grund: Im HTTP Header ist Content-Type: application/json nicht gesetzt, oder das Format des request body ist falsch.
    • Fehlersuche: Stellen Sie sicher, dass der Header der POST-Anforderung Content-Type: application/json enthält und dass der Body gültiges JSON ist.

Allgemeiner Vorschlag: Alle CRS API-Anforderungen müssen strikt der CRS API-Dokumentation folgen.

Hinweis: Die obigen FAQ decken häufige Probleme bei der CRS-Nutzung ab. Wenn Sie ein neues Problem melden möchten, geben Sie gerne Feedback und kontaktieren Sie uns!