Table of Contents

FAQ Mega

Incontrare problemi durante lo sviluppo e inevitabile. Questo articolo aiuta a individuare e risolvere rapidamente i problemi comuni. Iniziamo con una lista di domande frequenti (FAQ). Se non trovi una risposta qui, consulta i capitoli successivi o inviaci un report del problema.

Domande frequenti (FAQ)

Di seguito sono riportati alcuni dei problemi e delle soluzioni piu comuni incontrati dagli sviluppatori durante l'integrazione e l'uso di EasyAR Mega.

Q: Perché la mia applicazione mostra Invalid Key?

A: Di solito è causato da uno dei seguenti motivi:

  1. La License non è valida o è scaduta
  2. La License non corrisponde a Bundle ID / Package Name
  3. I dispositivi headset richiedono una XR License separata
  4. La funzione camera personalizzata richiede una License ufficiale
Q: Perché nella mia applicazione c'è un watermark?

A: Indica che la License in uso è una versione di prova e non una versione ufficiale.

Q: Perché nella mia applicazione compare un conto alla rovescia, timeout within * seconds?

A: È una limitazione durante il periodo del prodotto di prova. Usare una licenza ufficiale EasyAR Sense e il servizio ufficiale EasyAR Mega può risolvere il problema.

Q: Perché la mia applicazione si apre con schermo nero?

A: In questo caso, la causa dell'errore viene solitamente stampata nelle informazioni a schermo o nei log. È possibile risolvere in base alla causa specifica stampata dal sistema. Se non si riesce a risolvere, fornire informazioni tecniche, inclusi log, screenshot, informazioni dettagliate del dispositivo e così via.

Q: Perché la mia applicazione non riesce a fare localization e lo stato restituito resta NotFound?

A: Di solito è causato da uno dei seguenti motivi:

  1. Il servizio localization è ancora in avvio:
    In questo momento il servizio localization non ha ancora caricato completamente tutte le mappe Mega, quindi non è possibile garantire localization riuscita in una determinata area.
  2. Fuori dalla copertura della mappa:
    Assicurarsi che la posizione fisica corrente sia all'interno dell'area di copertura della mappa Mega caricata.
  3. Configurazione simulation test errata:
    L'applicazione non è in esecuzione sul posto, ma MegaLocationInputMode è stato impostato erroneamente su Onsite.
  4. Condizioni ambientali non buone:
    Illuminazione estrema, troppo buia o troppo intensa, grandi superfici di pareti o pavimenti a tinta unita, come pareti bianche o pavimenti lucidati, possono influire su visual localization.
Q: Perché la mia applicazione non riesce a fare localization e lo stato restituito è anomalo?

A: Di solito è causato da uno dei seguenti motivi:

  1. Request timeout:
    Il sistema restituisce RequestTimeout.
  2. Intervallo request troppo breve:
    Il sistema restituisce RequestIntervalTooLow.
  3. Altri errori anomali:
    Il sistema restituisce UnknownError. In generale, queste anomalie corrispondono a errori durante connessione o trasmissione, oppure a errori del servizio Mega stesso. È possibile ottenere dettagli tramite l'interfaccia MegaBlockLocalizationResponse.ErrorMessage.
Q: Perché la mia richiesta di uso del plugin Mini Program è fallita?

A: Questo perché i plugin Mini Program non supportano l'uso in “visitor mode” in WeChat Developer Tools, né supportano Mini Program con soggetto individuale. Usare l'AppId di un WeChat Mini Program con soggetto aziendale per fare richiesta.

Q: Perché l'autorizzazione del mio Mini Program non è stata approvata?

A: È necessario ottenere una Mega Mini Program plugin license dal developer center e assicurarsi che l'AppId utilizzato sia uguale a quello nella license.

Q: Perché il mio Mini Program non può essere usato sul telefono XX?

A: L'integrazione di Mega in un Mini Program dipende dal componente VisionKit di WeChat. Per system requirements e lista di device support, consultare WeChat documentation.

Q: Localization è riuscita, ma perché la posizione del contenuto virtuale sembra avere offset o drifting?

A: I problemi relativi agli effetti di localization hanno spesso cause complesse. Le possibili cause includono:

  1. Problema di accuratezza del mapping:
    La Mega map di quest'area può avere errori di accuratezza. Questo di solito accade durante la fase di map collection o reconstruction. Contattare il supporto commerciale per conferma.
  2. Salti durante initialization:
    Nei primi secondi dopo l'inizio della localization, la posizione può saltare leggermente. Ciò è dovuto al fatto che il sistema SLAM del device non ha ancora completato initialization. In WeChat Mini Program questo processo è particolarmente evidente, e su alcuni devices può anche richiedere un tempo relativamente lungo.
  3. Cambiamenti dinamici dell'ambiente:
    Se l'ambiente fisico cambia in modo significativo, ad esempio spostando grandi installazioni o aggiungendo pannelli temporanei, la map potrebbe non corrispondere più alla realtà. In questo caso la map deve essere aggiornata.
  4. Errore di sistema del device:
    Dopo un lungo funzionamento continuo della maggior parte dei devices, gli errori accumulati dei loro sistemi SLAM possono causare drifting.
  5. Problema di errore di localization:
    Visual localization ha di per sé errori di accuratezza. Di solito questo tipo di errore non influisce sull'esperienza visiva del contenuto virtuale. Se l'errore è abbastanza grande da causare offset o drifting evidente, sono necessari dati dettagliati per analisi e risoluzione. Fare riferimento ai metodi descritti in issue diagnosis and report per raccogliere dati e fornire feedback.
Q: Come raccolgo e uso dati EIF per debugging?

A: I dati EIF sono un potente debugging tool. Consultare le seguenti sezioni:

  • Come raccogliere: Leggere collect simulated runtime data per sapere come registrare file EIF su un telefono o headset.
  • Come riprodurre: In base al development environment, Unity o WeChat Mini Program, consultare la replay guide corrispondente in quella sezione.

Trovare aiuto piu specifico

Se le FAQ precedenti non risolvono il problema, puoi visitare le seguenti pagine tematiche per soluzioni piu approfondite:

Segnalare un nuovo problema

Se incontri un problema non coperto sopra che sembra legato all'SDK o alla piattaforma stessa, aiutaci a migliorare il prodotto. Per passaggi o guide dettagliate, consulta: report del problema.

Prima di inviare il report, assicurati di aver preparato le seguenti informazioni, che ci aiuteranno molto a risolvere il problema:

  1. Descrizione del problema: Descrivi chiaramente fenomeno, frequenza e passaggi operativi.
  2. Informazioni dispositivo: Modello dispositivo, versione del sistema operativo e versione EasyAR SDK.
  3. Dati EIF: Fornisci sempre il file di registrazione EIF che puo riprodurre il problema. E la prova diagnostica piu importante.
  4. File log: Log completi dell'applicazione, output Logcat o Console.
  5. Registrazione schermo o screenshot: Registrazione schermo o screenshot quando si verifica il problema.

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