Table of Contents

Domande frequenti su Mega

Incontrare problemi durante lo sviluppo è inevitabile. Questa guida mira ad aiutarti a identificare e risolvere rapidamente i problemi comuni. Iniziamo con un elenco di domande frequenti (FAQ); se qui non trovi risposta, consulta le sezioni successive o segnalaci il problema.

Domande frequenti (FAQ)

Di seguito sono riportati alcuni dei problemi più comuni riscontrati dagli sviluppatori durante l'integrazione e l'utilizzo di EasyAR Mega, insieme alle relative soluzioni.

Q: Perché la mia applicazione indica "Invalid Key"?

R: Questo è solitamente causato dai seguenti motivi:

  1. Licenza non valida o scaduta
  2. La licenza non corrisponde al Bundle ID / Package Name
  3. I dispositivi headset richiedono una licenza XR separata
  4. Le funzionalità della fotocamera personalizzata richiedono una licenza full
Q: Perché c'è una filigrana sulla mia applicazione?

R: Ciò indica che stai utilizzando una licenza di prova, non una licenza full.

Q: Perché la mia applicazione mostra un messaggio di timeout (timeout within * seconds)?

R: Questa è una limitazione durante il periodo di prova del prodotto. L'utilizzo di una licenza EasyAR Sense full e del servizio EasyAR Mega full risolverà il problema.

Q: Perché la mia applicazione si apre con una schermata nera?

R: In questo caso, la causa dell'errore viene solitamente stampata nelle informazioni dello schermo o nei log. Puoi risolvere in base alla causa specifica stampata dal sistema. Se non riesci a risolverlo, fornisci informazioni tecniche (inclusi log, screenshot, informazioni dettagliate sul dispositivo, ecc.).

Q: Perché la mia applicazione non riesce a localizzarsi, restituendo sempre lo stato "NotFound"?

R: Questo è solitamente causato dai seguenti motivi:

  1. Il servizio di localizzazione è ancora in fase di avvio:
    A questo punto, il servizio di localizzazione non ha ancora caricato completamente tutte le mappe Mega, quindi non può garantire il successo della localizzazione in una determinata area.
  2. Non nell'area coperta dalla mappa:
    Assicurati che la tua posizione fisica attuale si trovi all'interno dell'area coperta dalla mappa Mega che hai caricato.
  3. Configurazione errata del test simulato:
    Non in esecuzione in loco, ma MegaLocationInputMode è impostato erroneamente su Onsite.
  4. Condizioni ambientali sfavorevoli:
    Illuminazione estrema (troppo buia o troppo luminosa), ampie pareti o pavimenti monocromatici (come pareti bianche, pavimenti lucidi) influenzeranno la localizzazione visiva.
Q: Perché la mia applicazione non riesce a localizzarsi, restituendo uno stato anomalo?

R: Questo è solitamente causato dai seguenti motivi:

  1. Timeout della richiesta:
    In questo caso, il sistema restituirà RequestTimeout.
  2. Intervallo tra le richieste troppo breve:
    In questo caso, il sistema restituirà RequestIntervalTooLow.
  3. Altri errori anomali:
    In questo caso, il sistema restituirà UnknownError. Generalmente, tali anomalie corrispondono a un fallimento durante la connessione o la trasmissione, o a un errore del servizio Mega stesso. È possibile ottenere informazioni dettagliate tramite l'interfaccia MegaBlockLocalizationResponse.ErrorMessage.
Q: Perché la mia richiesta di utilizzare il plugin per mini-program non è riuscita?

R: Ciò è dovuto al fatto che i plugin per mini-program non supportano l'utilizzo in "modalità ospite" nello strumento di sviluppo WeChat e non supportano l'utilizzo su mini-program con soggetto individuale. Utilizza un AppId di mini-program WeChat con soggetto aziendale per effettuare la richiesta.

Q: Perché la mia mini-app non è stata autorizzata?

A: È necessario ottenere una licenza per il plugin della mini-app Mega dal centro di sviluppo e assicurarsi che l'AppId utilizzato corrisponda a quello presente nella licenza.

Q: Perché la mia mini-app non può essere utilizzata su telefoni XX?

A: L'integrazione della dipendenza Mega nella mini-app si basa sul componente VisionKit di Weixin. I requisiti di sistema e la lista dei dispositivi supportati sono consultabili nella documentazione Weixin.

Q: Il posizionamento ha avuto successo, ma il contenuto virtuale appare disallineato o si sposta?

A: I problemi relativi all'effetto di posizionamento sono spesso complessi. Le possibili cause includono:

  1. Problema di precisione nella mappatura:
    La mappa Mega dell'area stessa potrebbe contenere errori di precisione. Questo di solito accade durante la fase di acquisizione o ricostruzione della mappa; contattare il commerciale per conferma.
  2. Salti durante l'inizializzazione:
    Nei primi secondi del posizionamento, la posizione potrebbe subire lievi salti. Ciò è dovuto al fatto che il sistema SLAM del dispositivo non ha completato l'inizializzazione, un processo particolarmente evidente nelle mini-app Weixin (su alcuni dispositivi può anche durare più a lungo).
  3. Cambiamenti dinamici nell'ambiente:
    Se l'ambiente fisico ha subito cambiamenti significativi (ad esempio, spostamento di arredi di grandi dimensioni, aggiunta di pannelli espositivi temporanei), potrebbe causare una mancata corrispondenza tra la mappa e la realtà. In questo caso, è necessario aggiornare la mappa.
  4. Errore di sistema del dispositivo:
    La maggior parte dei dispositivi, dopo un lungo periodo di funzionamento continuo, può subire una deriva a causa dell'errore accumulato dal loro sistema SLAM.
  5. Problema di errore di posizionamento:
    Il posizionamento visivo stesso ha un margine di errore di precisione; solitamente questo errore non influisce sull'esperienza visiva del contenuto virtuale. Se l'errore è così grande da causare un disallineamento evidente o una deriva, sono necessari dati dettagliati per l'analisi e la risoluzione. Fare riferimento ai metodi descritti in Diagnostica e segnalazione dei problemi per raccogliere i dati e fornire feedback.
Q: Come acquisire e utilizzare i dati EIF per il debug?

A: I dati EIF sono uno strumento di debug potente. Consultare i seguenti capitoli:

  • Come acquisirli: Leggere Acquisizione di dati di esecuzione simulati per imparare come registrare file EIF su telefono o visore.
  • Come riprodurli: In base al proprio ambiente di sviluppo (Unity o mini-app Weixin), fare riferimento alla guida di riproduzione corrispondente in quel capitolo.

Cercare aiuto più specifico

Se le FAQ precedenti non hanno risolto il tuo problema, puoi visitare le seguenti pagine tematiche per soluzioni più approfondite:

Segnalare un nuovo problema

Se hai riscontrato un problema non coperto sopra, sospettando che sia legato all'SDK o alla piattaforma stessa, aiutaci a migliorare il prodotto. Per passaggi dettagliati, consulta: Segnalazione problemi.

Prima di inviare una segnalazione, assicurati di avere pronte queste informazioni, che ci aiuteranno notevolmente a risolvere il problema:

  1. Descrizione del problema: Descrivi chiaramente il sintomo, la frequenza e i passaggi per riprodurlo.
  2. Informazioni sul dispositivo: Modello del dispositivo, versione del sistema operativo, versione di EasyAR SDK.
  3. Dati EIF: Fornire imperativamente il file di registrazione EIF che riproduce il problema. Questa è la prova diagnostica più importante.
  4. File di log: Log completo dell'applicazione (output Logcat o Console).
  5. Registrazione schermo o screenshot: Screen recording o screenshot al momento del problema.

Invia queste informazioni tramite forum, email o contatto commerciale. Grazie per il tuo feedback!