Strumento di verifica e diagnostica sul posto
Questo articolo descrive la configurazione della localizzazione, l'interfaccia durante l'esecuzione e l'invio di dati anomali in Mega Toolbox (Mini Program). Usare un file maschera per controllare l'allineamento del modello con l'ambiente reale oppure caricare annotazioni per vedere i contenuti virtuali.
Prima di iniziare
- Seguire l'introduzione allo strumento per preparare il database di localizzazione cloud, l'account EasyAR e il telefono, quindi recarsi presso il Block di destinazione.
- Per usare un file maschera, la versione di mappatura del Block deve essere 9.6 o successiva. Verificarla nella pagina dei dettagli del Block.
- Per usare annotazioni, creare dati per la verifica sul posto e assicurarsi che il pacchetto appartenga al database da testare. Senza annotazioni, saltare questo passaggio.
Per un esempio completo, vedere Risultato del Mini Program.
Ottenere lo strumento
Scansionare il codice Mini Program con WeChat per aprire Mega Toolbox.
Accedere all'account
Usare un account EasyAR Developer Center che possa accedere al database cloud di destinazione. I numeri nell'immagine indicano nome utente, password e pulsante di accesso.
- Inserire il nome utente.
- Inserire la password.
- Fare clic su
Accedi.
Selezionare database e annotazioni
Selezionare il database cloud di destinazione, eventualmente un pacchetto di annotazioni, quindi fare clic su Avvia. Le impostazioni nell'immagine sono descritte di seguito.
| N. | Impostazione | Descrizione |
|---|---|---|
| 1 | Database di localizzazione cloud | Selezionare il database con il Block di destinazione. L'elenco mostra «nome gruppo servizi | nome database». |
| 2 | Modifica indirizzo |
Di norma lasciarlo disattivato. Se serve un altro indirizzo, ad esempio un servizio estero, configurarlo secondo il servizio. |
| 3 | Test fuori sede |
Lasciarlo disattivato nell'ambiente reale; attivarlo solo per test fuori sede con foto o materiali analoghi. |
| 4 | Test avvio a freddo |
Per test specifici di avvio a freddo. Lasciarlo disattivato nella normale verifica sul posto. |
| 5 | Pacchetto di annotazioni | Selezionare il pacchetto da caricare. Per la sola localizzazione o il file maschera, scegliere Non usare annotazioni. |
| 6 | Mostra nomi annotazioni |
Durante il caricamento, attivarlo se si desidera vedere i nomi. |
| 7 | Avvia |
Aprire la pagina di localizzazione con le impostazioni correnti. |
Al primo accesso alla pagina di localizzazione, concedere i permessi di fotocamera e posizione richiesti da WeChat.
Entrare nell'interfaccia di localizzazione
Inquadrare un'area ben illuminata e ricca di dettagli visivi, muovendo il telefono in modo uniforme fino al termine dell'inizializzazione del rilevamento dei piani di WeChat. Lasciare attiva Localizzazione Mega e attendere il risultato cloud.
Visualizzare risultati e controlli
Attivare Informazioni Debug per vedere dispositivo, scena, richieste e risultati. L'immagine mostra una localizzazione riuscita con annotazioni caricate; senza annotazioni il cubo non compare.
| N. | Controllo o informazione | Descrizione |
|---|---|---|
| 1 | Informazioni Debug |
Mostrare o nascondere il pannello di debug. |
| 2 | Registra log |
Avviare o fermare i log. Dopo l'arresto, scegliere un destinatario in WeChat per esportare il file. |
| 3 | Registra dati |
Avviare o fermare la registrazione dei dati dump. Poi scegliere un destinatario in WeChat per esportare il file. |
| 4 | Opzioni avanzate |
Mostrare o nascondere le opzioni avanzate. |
| 5 | Localizzazione Mega |
Avviare o fermare la localizzazione cloud Mega. |
| 6 | Risultato cloud | Vedere status, tempo di risposta e Block localizzato. |
| 7 | Cronologia della localizzazione | Sequence mostra gli stati: N non caricato, S riuscito, F fallito. Il pulsante Status è verde in caso di successo e bianco in caso di errore. |
Risultati comuni e azioni:
| Risultato | Significato e azione |
|---|---|
Found |
Il Block di destinazione è stato localizzato. Confrontare mesh o annotazioni con la scena reale. |
Not Found |
La richiesta non ha trovato il Block. Verificare di essere sul posto, che il Block sia nel database e che la fotocamera inquadri una zona ricca di dettagli. Se persiste, vedere Risolvere i problemi di localizzazione. |
QpsLimitExceeded |
Superata la quota QPS del gruppo di servizi cloud. Vedere Stima ed espansione QPS. |
UnKnownError |
Possibile problema di rete, trasferimento o risposta del servizio. Seguire Risolvere i problemi di localizzazione e registrare log e dati se necessario. |
Visualizzare il file maschera
Dopo aver localizzato un Block che supporta il file maschera, attivare File maschera. Il Mini Program carica e mostra la mesh automaticamente, senza scaricare file o creare annotazioni.
| N. | Controllo | Descrizione |
|---|---|---|
| 8 | File maschera |
Mostrare o nascondere la mesh della maschera. |
| 9 | Cursore opacità | Regolare l'opacità della mesh da 0% a 100% per confrontarla con la scena reale. |
Pavimento e superfici verticali hanno colori diversi e la mesh si auto-occlude. Controllare pareti, pavimento, giunzioni e angoli e osservare tremolii o drift muovendo il telefono. Esempio: File maschera.
Se la mesh non appare, controllare che il Block sia localizzato, la versione di mappatura sia adeguata, l'interruttore sia attivo e l'opacità superiore a 0%. Attendere quindi il caricamento.
Visualizzare le annotazioni
Se prima dell'avvio è stato scelto un pacchetto, dopo la localizzazione il suo contenuto appare nella scena reale. I cubi hanno una texture MEGA bianca in caso di successo e grigia in caso di errore.
Confrontare le annotazioni con le posizioni scelte durante la creazione. Distinguere il fallimento della localizzazione dal tremolio o drift successivi; per questi ultimi vedere Problemi di tracking.
Segnalare dati di localizzazione anomali
In caso di fallimento, scostamento, tremolio o drift, registrare insieme log e dati dump durante la riproduzione del problema. Il destinatario deve essere scelto manualmente durante la condivisione.
Nella pagina di localizzazione attivare
Registra logeRegistra dati. Confermare l'avvio della registrazione e riprodurre il problema.Una volta riprodotto, disattivare
Registra datiper fermare la registrazione.
Nella condivisione WeChat scegliere
File Transfer Assistante salvare il file di dati.
Tornare alla pagina e disattivare
Registra log. Salvare anche il log tramite WeChat. Completare registrazione ed esportazione prima di uscire.Inviare al supporto EasyAR file di dati e log con descrizione del problema: database, Block, ora, modello del telefono, versioni del sistema e di WeChat, sintomi e passaggi per riprodurre l'errore. È utile allegare screenshot o video.
Per registrare ed esportare i dati dump, vedere Registrare file dump con Mega Toolbox.