Table of Contents

Risoluzione dei problemi: contenuto non visualizzato/attivato

Quando si usa il riconoscimento cloud delle immagini, può verificarsi un problema per cui il contenuto virtuale non viene visualizzato o attivato. Questo articolo fornisce un metodo sistematico di risoluzione dei problemi. Va ricordato che, nella maggior parte dei casi, le cause del fallimento del riconoscimento cloud delle immagini sono esattamente le stesse del fallimento del riconoscimento locale. È possibile fare riferimento alla sezione Risoluzione dei problemi del tracking di immagini planari. Qui vengono aggiunti solo problemi e soluzioni specifici del riconoscimento cloud.

Cause comuni e metodi di risoluzione dei problemi

Problemi di connessione di rete

Fenomeno: Dopo l'invio di una richiesta di riconoscimento non arriva risposta oppure viene restituito un codice di errore.
Metodi di risoluzione dei problemi:

  • Verificare se il dispositivo è connesso alla rete (Wi-Fi/4G/5G) e provare ad aprire una pagina web per conferma.
  • Verificare se l'app ha abilitato il permesso di rete.
  • Catturare nel codice i log degli errori di rete.
  • Testare nel browser la connettività di CRS API (riferimento: Health check | GET /ping).

Suggerimenti di miglioramento:

  • Aggiungere nell'app il rilevamento dello stato della rete e mostrare un avviso quando la rete è debole.
  • Impostare un timeout della richiesta, quindi riprovare o passare al tracking locale.

Errori di configurazione del servizio

Fenomeno: La richiesta di riconoscimento viene rifiutata e restituisce Unauthorized o Invalid Key.
Metodi di risoluzione dei problemi:

  • Verificare se CRS API Key e Secret inseriti nel codice sono corretti.
  • Verificare che il Client-end URL inserito nel codice non sia errato (ad esempio inserito per errore come Server-end URL).
  • Confermare che il License Key sia attivato e non scaduto (controllare nell'account center del sito ufficiale EasyAR).

Suggerimenti di miglioramento:

  • Usare il pulsante Copy nella CRS image library per copiare la relativa configurazione di servizio e assicurarsi che sia compilata correttamente.

Errori di configurazione della target library/applicazione

Fenomeno: Una certa target image in passato veniva riconosciuta senza problemi, ma ora la richiesta di riconoscimento fallisce.
Metodi di risoluzione dei problemi:

  • Ottenere lo stato del target tramite CRS API e confermare che la target image sia nello stato "activated" ("active":"1").
  • Verificare se il target ID è esattamente uguale a quello nel codice (con distinzione tra maiuscole e minuscole).

Suggerimenti di miglioramento:

  • Quando la libreria immagini cloud viene aggiornata/modificata, assicurarsi che i target specifici dell'app siano sempre attivati.
  • Effettuare un controllo accurato del codice.

Errore di caricamento locale in modalità ibrida

Fenomeno: Il riconoscimento cloud riesce, ma il tracking locale non si avvia e il contenuto non viene visualizzato.
Metodi di risoluzione dei problemi:

  • Confermare che non vengano generate eccezioni durante il caricamento locale di ImageTarget (controllare i log).
  • Verificare se ImageTracker è abilitato.

Suggerimenti di miglioramento:

  • Avvolgere la logica di caricamento locale con try-catch, catturare le eccezioni e riprovare.
  • Assicurarsi che il contenuto virtuale sia un child object di ImageTarget e non sia disabilitato.

Riepilogo e best practice

I problemi in cui il contenuto del riconoscimento cloud non viene visualizzato si concentrano principalmente su tre aspetti: rete, configurazione del servizio e stato del target. In modalità ibrida occorre prestare attenzione anche al caricamento locale. Si consiglia di procedere nel seguente ordine:

  1. Controllare la connessione di rete e confermare la connettività del servizio CRS;
  2. Controllare impostazioni del servizio come License, API Key/Secret e Client-end URL.
  3. Controllare lo stato della target image nella CRS image library e assicurarsi che la libreria immagini sia coerente con il target ID nell'app;

Se il problema è complesso, abilitare i log di debug EasyAR o contattare il supporto tecnico.