Table of Contents

UI messaggi

Il plugin EasyAR Sense Unity ha tre tipi di messaggi in fase di runtime.

  • Eccezioni di runtime, inclusi Sense Error, Session Error, Error, Warning
  • Session Dump
  • Eccezioni speciali di sviluppo EasyAR Mega

È possibile regolare l'output dei primi due tipi di messaggi secondo necessità. È possibile configurarli nell'editor tramite il componente DiagnosticsController sulla sessione o utilizzando l'interfaccia DiagnosticsController.MessageOutput negli script.

diagnostics ui messages

Consiglio

Nella versione 4000, se una scena è stata creata con una versione precedente del plugin, DiagnosticsController viene aggiunto automaticamente alla sessione quando la scena viene aperta. In alcune versioni di Unity potrebbe non essere aggiunto automaticamente; in tali versioni, DiagnosticsController viene creato in fase di runtime con valori predefiniti.

Eccezioni di runtime

Durante l'esecuzione del plugin, a volte si verificano problemi rilevati dai componenti interni, che appaiono nel sistema come messaggi. Alcuni di questi messaggi possono essere errori gravi che impediscono il funzionamento, altri possono essere attivati intenzionalmente, altri ancora possono indicare dispositivi non supportati, ecc. Sono classificati per livello di gravità decrescente come segue:

  • SenseError: Errori di EasyAR Sense, solitamente correlati alla licenza di EasyAR Sense.
  • SessionError: Errori di ARSession, solitamente correlati a funzionalità non supportate dal dispositivo o a configurazioni errate.
  • Error: Altri messaggi di errore
  • Warning: Messaggi di avviso

A causa della natura specifica dello sviluppo in Unity, questi messaggi vengono visualizzati per impostazione predefinita nell'interfaccia utente per supportare lo sviluppo.

È possibile controllare come vengono visualizzati questi messaggi nell'editor o tramite script. Le modalità di output disponibili sono:

  • UIAndLog: Output su UI e log. Sui visori viene visualizzato a 5 metri di distanza davanti all'utente.
  • Log: Output nel log di sistema.
Consiglio

Sense error

Sense Error è un tipo speciale di errore; quando si verifica, le funzionalità di EasyAR non possono essere utilizzate. Cause comuni:

  • Licenza non configurata correttamente o verifica fallita. Questo errore può essere risolto reinizializzando con una licenza valida.
  • Utilizzo di prodotti di prova (licenza personal, licenza XR di prova o servizi Mega di prova, ecc.) su determinati dispositivi (inclusi tutti i dispositivi che utilizzano fotocamera personalizzata come AR Foundation, AR Engine o vari visori) oltre il tempo limite fisso. Questo errore non è recuperabile.

Session error

Session Error è un errore che impedisce il funzionamento dell'ARSession corrente. Modificare la configurazione e riavviare l'ARSession potrebbe risolvere questi errori. Generalmente sono causati da errori di configurazione, eccezioni durante il flusso di avvio che interrompono l'assemblaggio, dispositivi non supportati dalla configurazione corrente dell'ARSession o perdita di componenti dell'ARSession durante l'esecuzione.

Situazioni comuni:

  • Errori di assemblaggio della sessione: ad esempio, dispositivo non supportato o Frame Source per dispositivi supportati non configurato correttamente nell'ARSession.
  • Errori di avvio della sessione: informazioni di configurazione errate dei servizi cloud che causano errori nella creazione delle funzionalità cloud, o informazioni di configurazione non compilate (inclusi servizi Mega, servizi di riconoscimento cloud, servizi SpatialMap).
  • Errori durante l'esecuzione della sessione: componente ARSession distrutto esternamente, RendererFeature non configurato correttamente in ambiente URP, ecc.

In generale, gli errori di configurazione e le eccezioni durante il flusso di avvio che interrompono l'assemblaggio dovrebbero essere evitati durante lo sviluppo. I problemi di dispositivo non supportato si verificano principalmente con funzionalità che richiedono capacità di tracciamento del movimento. Fare riferimento a Motion tracking e funzionalità EasyAR per sapere quali funzionalità richiedono attenzione al supporto del dispositivo e scegliere dispositivi appropriati per il debug durante lo sviluppo.

Session dump

I messaggi SessionDump mostrano lo stato di esecuzione dell'ARSession raccolto durante il runtime del plugin, inclusi alcuni stati chiave dei vari componenti. Queste informazioni sono molto utili per comprendere il funzionamento di EasyAR e analizzare i problemi.

È possibile controllare come vengono visualizzati questi stati nell'editor o tramite script. Le modalità di output disponibili sono:

  • UI: Visualizzato nell'UI e aggiornato ogni frame. Sui visori, viene visualizzato a 5 metri di distanza davanti all'utente.
  • Log: Output nel log di sistema. Poiché viene eseguito ogni frame, influisce sulle prestazioni; si consiglia di utilizzarlo solo durante lo sviluppo o i test.
  • None: Nessun output.
Consiglio
  • Si consiglia di utilizzare la configurazione predefinita UI durante la fase di sviluppo e test; le informazioni visualizzate sono essenziali per la comunicazione con il personale di EasyAR.
  • Si consiglia di modificare in None dopo il rilascio ufficiale, mantenendo un'interruttore software per riattivare UI o utilizzando altri sistemi per la raccolta dati. Quando si segnalano problemi a EasyAR, EasyAR richiederà queste informazioni a voi o ai vostri utenti per valutare lo stato di esecuzione dell'applicazione.
  • Nella maggior parte dei casi, se si verificano problemi dopo il rilascio dell'applicazione, è necessario prima eseguire la risoluzione dei problemi e l'analisi. I problemi possono essere risolti efficacemente solo dopo aver escluso problemi dell'applicazione e raccolto informazioni sufficienti. Sono disponibili molti SDK e piattaforme di terze parti per la raccolta e l'analisi dei log; si consiglia di utilizzarli prima del rilascio. Se non si ha esperienza o risorse per queste piattaforme, mantenere un interruttore per attivare UI (ad esempio un interruttore nascosto) per consentire agli utenti di segnalare le informazioni visualizzate sarà la soluzione più semplice.

Eccezioni speciali di sviluppo EasyAR Mega

Nello sviluppo Mega, esiste un altro tipo di messaggi di avviso non controllabili. Questi messaggi vengono visualizzati nell'UI quando vengono soddisfatte specifiche condizioni di configurazione e lo sviluppatore non può disattivarli direttamente.

Si consiglia di concentrarsi sul messaggio stesso; il testo spiega chiaramente la causa e il metodo di configurazione. Gli sviluppatori devono comprendere i requisiti di diverse configurazioni per diversi utilizzi e scegliere in modo appropriato in base allo stato di avanzamento dello sviluppo.

Questi messaggi vengono mostrati intenzionalmente perché, in condizioni d'uso specifiche, queste funzionalità assistono lo sviluppo del flusso dei contenuti, ma non possono produrre risultati di esecuzione validi. Attenzione a non rilasciare con questi messaggi attivi.

Argomenti correlati