Table of Contents

Domande frequenti su CRS

Di seguito sono riportate domande comuni e risposte relative all'utilizzo della funzionalità di riconoscimento immagini cloud.

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

R: Sì, CRS supporta il caricamento di modelli 3D/contenuti virtuali tramite:

  • Attributo meta: Archivia il contenuto AR nel campo meta dell'immagine target come file di testo. I modelli 3D possono essere codificati in Base64 come testo o salvati come URL in cloud storage (es. Alibaba Cloud OSS, AWS S3).
  • Flusso di caricamento: Dopo che il client riceve i dati meta da CRS, utilizza un motore 3D (es. Unity, Three.js) per analizzare e caricare il modello.
  • Documentazione di riferimento: Consulta Creare un target di riconoscimento | POST /targets.
Nota

Per file di grandi dimensioni (>2MB) utilizza l'approccio URL, evitando che la codifica Base64 generi un corpo della richiesta eccessivo.

Q: CRS ha limiti sul numero di riconoscimenti?

R: Non esiste un limite totale al numero di riconoscimenti, ma ci sono livelli di concorrenza:

  • Modalità base: Adatta per applicazioni con QPS < 50, nessun limite rigido, ma deve rispettare il principio di utilizzo equo.
  • Modalità alta concorrenza: Per QPS ≥ 50, si consiglia di passare al servizio cloud con risorse dedicate per garantire stabilità e bassa latenza.
Importante

Se l'applicazione potrebbe affrontare picchi temporanei di concorrenza durante festività o eventi importanti, contatta il supporto tecnico EasyAR almeno 3 giorni lavorativi prima per richiedere un aggiornamento del servizio.

Q: Perché l'API Web Service restituisce errore 404?

R: L'errore 404 indica generalmente che il percorso URL richiesto non esiste o la risorsa non è stata trovata. Cause comuni:

  • Formato URL errato: Accesso a un endpoint inesistente. Es.: accedere direttamente a http://your_crs_uuid.na1.crs.easyar.com:8888 è invalido; usa invece endpoint completi come http://your_crs_uuid.na1.crs.easyar.com:8888/ping.
  • Risultato riconoscimento vuoto: Quando si chiama l'interfaccia /search, se nessun target corrisponde, restituisce 404 con corpo del messaggio No result: there is no matching.

Passaggi di verifica:

  1. Conferma che l'URL sia scritto correttamente, incluso UUID e porta.
  2. Usa l'interfaccia /ping per testare la disponibilità del servizio.
  3. Controlla che i parametri della richiesta siano completi (es. dati dell'immagine, API Key).

Suggerimenti risolutivi: Se /search restituisce 404, significa che l'immagine corrente non ha trovato corrispondenze. Guida l'utente a modificare l'angolo di ripresa o verifica che il target sia stato caricato in CRS.

Q: Quali sono le cause comuni dei codici di errore dell'API Web Service?

R: Oltre al 404, questi codici di errore sono comuni:

  • 400 invalid appId (appKey)

    • Causa: La Key della richiesta è errata o la verifica della firma non è riuscita.
    • Verifica: Conferma che la tua Key sia stata copiata dalla libreria immagini CRS; che la richiesta POST includa la firma completa; che i parametri utilizzino Content-Type: application/json.

  • 400 invalid date

    • Causa: Timestamp della richiesta non valido o deviazione eccessiva dall'ora del server (solitamente entro ±5 minuti).
    • Verifica: Controlla che l'ora del dispositivo sia accurata (specialmente le impostazioni del fuso orario).

  • 415 unsupported media type

    • Causa: L'Header HTTP non ha impostato Content-Type: application/json, o il formato del corpo della richiesta è errato.
    • Verifica: Assicurati che l'Header della richiesta POST includa Content-Type: application/json e che il Body sia JSON valido.

Suggerimenti generali: Tutte le richieste API CRS devono seguire rigorosamente la documentazione API CRS.

Nota: Queste FAQ coprono i problemi frequenti nell'uso di CRS. Per segnalare nuovi problemi, invia un feedback e contattaci!