Table of Contents

Domande frequenti su CRS

Di seguito sono riportate domande e risposte comuni durante l'uso della funzione cloud image recognition.

Q: CRS supporta il caricamento di modelli 3D/contenuti virtuali dal cloud?

A: Sì. CRS supporta il caricamento di modelli 3D/contenuti virtuali nei seguenti modi:

  • Proprietà meta: memorizzare contenuti AR nel campo meta dell'immagine target, in formato file di testo. I modelli 3D possono essere codificati come testo tramite Base64 oppure salvati come URL di cloud storage, come Alibaba Cloud OSS o AWS S3.
  • Processo di caricamento: dopo che il client ottiene i dati meta da CRS, usa un 3D engine, come Unity o Three.js, per analizzare e caricare il modello.
  • Documentazione di riferimento: vedere Creare target di riconoscimento | POST /targets.
Nota

Per file di grandi dimensioni (>2MB), usare il metodo URL per evitare un request body troppo grande causato dalla codifica Base64.

Q: CRS ha un limite al numero di riconoscimenti?

A: Non esiste un limite totale al numero di riconoscimenti, ma esistono livelli di concurrency:

  • Modalità base: adatta per applicazioni con QPS < 50. Non c'è un limite rigido, ma deve essere rispettato il principio fair use.
  • Modalità alta concurrency: quando QPS >= 50, si consiglia di passare a un cloud service con risorse dedicate per garantire stabilità di riconoscimento e bassa latenza.
Importante

Se l'applicazione può affrontare un aumento temporaneo della concurrency durante festività o grandi eventi, contattare il supporto tecnico EasyAR con almeno 3 giorni lavorativi di anticipo per richiedere un upgrade del servizio.

Q: Perché Web Service API restituisce 404?

A: Un errore 404 di solito indica che il percorso URL richiesto non esiste o che la risorsa non è stata trovata. Le cause comuni sono:

  • Formato URL errato: è stato visitato un endpoint inesistente. Ad esempio, accedere direttamente a http://your_crs_uuid.na1.crs.easyar.com:8888 non è valido. Usare un endpoint completo come http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Risultato di riconoscimento vuoto: quando si chiama l'interfaccia /search, se nessun target corrisponde, viene restituito anche 404, con message body No result: there is no matching.

Passaggi di troubleshooting:

  1. Confermare che l'URL sia scritto correttamente, inclusi UUID e porta.
  2. Usare l'interfaccia /ping per testare la disponibilità del servizio.
  3. Verificare che i parametri della richiesta siano completi, come dati immagine e API Key.

Suggerimento di soluzione: se /search restituisce 404, significa che l'immagine corrente non ha trovato alcun target. È possibile guidare l'utente a regolare l'angolo di ripresa o verificare che il target sia stato caricato su CRS.

Q: Quali sono le cause comuni dei codici di errore restituiti da Web Service API?

A: Oltre a 404, i seguenti codici di errore sono comuni:

  • 400 invalid appId (appKey)

    • Causa: il Key richiesto non è corretto, oppure la verifica della firma non è riuscita.
    • Troubleshooting: confermare che il proprio Key sia stato copiato dalla CRS image library; che la richiesta POST contenga una firma completa; e che i parametri della richiesta usino Content-Type: application/json.

  • 400 invalid date

    • Causa: il timestamp della richiesta non è valido o differisce troppo dall'ora del server, normalmente entro +/-5 minuti.
    • Troubleshooting: verificare che l'ora del dispositivo sia accurata, con particolare attenzione alle impostazioni del fuso orario.

  • 415 unsupported media type

    • Causa: l'HTTP Header non imposta Content-Type: application/json, oppure il formato del request body è errato.
    • Troubleshooting: assicurarsi che l'Header della richiesta POST contenga Content-Type: application/json e che il Body sia JSON valido.

Suggerimento generale: tutte le richieste CRS API devono seguire rigorosamente la documentazione CRS API.

Nota: le FAQ sopra coprono problemi frequenti nell'uso di CRS. Se è necessario segnalare un nuovo problema, inviare feedback e contattarci!