Table of Contents

Risoluzione dei problemi: contenuto non visualizzato/attivato

Durante l'utilizzo del riconoscimento cloud delle immagini, potresti riscontrare problemi di contenuto virtuale non visualizzato o attivato. Questo articolo fornisce un metodo di risoluzione sistematica. È importante notare che nella maggior parte dei casi, le ragioni del fallimento del riconoscimento cloud sono identiche a quelle del riconoscimento locale. Puoi fare riferimento al capitolo Risoluzione dei problemi per il tracciamento di immagini piane. Qui vengono integrati solo problemi e soluzioni specifici del riconoscimento cloud.

Cause comuni e metodi di risoluzione

Problemi di connessione di rete

Sintomo: Nessuna risposta dopo l'invio della richiesta di riconoscimento o restituzione di codici di errore.
Metodo di risoluzione:

  • Verifica se il dispositivo è connesso a internet (Wi-Fi/4G/5G), prova ad aprire una pagina web per confermare.
  • Controlla se l'applicazione ha i permessi per accedere a internet.
  • Intercetta i log di errore di rete nel codice.
  • Testa la connettività dell'API CRS nel browser (riferimento: Controllo dello stato di salute | GET /ping).

Suggerimenti per migliorare:

  • Aggiungi il rilevamento dello stato della rete nell'app, con notifiche in caso di rete debole.
  • Imposta tentativi di ripetizione dopo il timeout della richiesta o degrada al tracciamento locale.

Configurazione errata del servizio

Sintomo: Richiesta di riconoscimento rifiutata, restituisce Unauthorized o Invalid Key.
Metodo di risoluzione:

  • Controlla che la CRS API Key e la Secret inserite nel codice siano corrette.
  • Verifica che l'URL Client-end inserito nel codice non sia errato (ad esempio, inserito per errore l'URL Server-end).
  • Conferma che la License Key sia attivata e non scaduta (verifica nel centro account del sito web EasyAR).

Suggerimenti per migliorare:

  • Utilizza il pulsante copia nella galleria CRS per copiare le configurazioni del servizio pertinenti, assicurandoti che siano inserite correttamente.

Configurazione errata della libreria di destinazione/applicazione

Sintomo: Un'immagine target precedentemente riconosciuta senza problemi ora fallisce nella richiesta di riconoscimento.
Metodo di risoluzione:

  • Ottieni lo stato del target tramite l'API CRS, conferma che l'immagine target sia nello stato "attivato" ("active":"1").
  • Controlla che l'ID del target corrisponda esattamente a quello nel codice (distingue tra maiuscole e minuscole).

Suggerimenti per migliorare:

  • Quando la galleria cloud viene aggiornata/modificata, assicurati che il target specifico dell'app sia sempre attivato.
  • Attento controllo del codice.

Caricamento locale fallito in modalità ibrida

Sintomo: Riconoscimento cloud riuscito, ma il tracciamento locale non si avvia, il contenuto non viene visualizzato.
Metodo di risoluzione:

  • Conferma che il caricamento locale dell'ImageTarget non generi eccezioni (controlla i log).
  • Verifica che l'ImageTracker sia abilitato.

Suggerimenti per migliorare:

  • Utilizza try-catch per racchiudere la logica di caricamento locale, intercetta le eccezioni e riprova.
  • Assicurati che il contenuto virtuale sia un oggetto figlio di ImageTarget e non sia disabilitato.

Riepilogo e best practice

I problemi di mancata visualizzazione del contenuto nel riconoscimento cloud si concentrano principalmente su tre aspetti: rete, configurazione del servizio, stato del target. La modalità ibrida richiede inoltre attenzione al caricamento locale. Si consiglia di procedere con la risoluzione in questo ordine prioritario:

  1. Controlla la connessione di rete, conferma la connettività del servizio CRS;
  2. Controlla le impostazioni del servizio: License, API Key/Secret, URL Client-end.
  3. Controlla lo stato dell'immagine target nella galleria CRS, assicurati che l'ID target nella galleria corrisponda a quello nell'app;

Se il problema è complesso, abilita i log di debug di EasyAR o contatta l'assistenza tecnica.