Table of Contents

Segnalazione e feedback sui problemi

Apprezziamo molto il vostro feedback, poiché è fondamentale per aiutarci a migliorare i prodotti e i servizi di EasyAR Mega. Per consentirci di individuare e risolvere rapidamente e accuratamente i problemi che incontrate, spendete alcuni minuti a leggere questa guida prima di inviare una segnalazione.

I nostri contatti

Potete inviare segnalazioni di problemi attraverso i seguenti canali:

  • Comunità/Forum ufficiale per sviluppatori - Consigliato per problemi generali e scambi all'interno della comunità.

    • Gli utenti cinesi cliccano qui
    • Gli altri utenti cliccano qui

  • Gruppo WeChat per le aziende - Adatto per gli utenti aziendali che necessitano di supporto riservato o più formale.

    • Scanate il codice QR qui sotto per entrare nel gruppo

  • Altri contatti - Come soluzione alternativa.

    • Per ottenere i contatti cliccate qui

Elementi chiave per inviare una segnalazione di alta qualità

Una segnalazione contenente le seguenti informazioni ci aiuterà notevolmente a riprodurre e risolvere il problema. Più le informazioni sono complete, più veloce sarà la risoluzione del problema.

Elenco generico per le segnalazioni (necessario per tutti i problemi)

  1. Descrizione chiara del problema：

    • Quale risultato avete intenzione di ottenere?
    • Cosa è effettivamente successo? (Ad esempio, l'applicazione si chiude inaspettatamente, la localizzazione fallisce, il contenuto si muove in modo erratico)
    • Con quale frequenza si verifica il problema (sempre/occasionalmente)? In quali condizioni si verifica?

  2. Informazioni sul dispositivo e sull'ambiente：

    • Modello del dispositivo：Ad esempio, iPhone 14 Pro, Samsung Galaxy S23 Ultra, Apple Vision Pro.
    • Versione del sistema operativo：Ad esempio, iOS 17.2, Android 14, visionOS 26.
    • Versione di EasyAR SDK：Ad esempio, EasyAR Sense Unity Plugin v4.6.0.
    • Ambiente di test：Interno/esterno, condizioni di illuminazione, se è un ambiente dinamico o meno.

  3. Dati EIF (la prova più importante)：

    • Fornite necessariamente il file di registrazione EIF che consenta di riprodurre il problema。
    • I dati EIF contengono tutte le informazioni sui sensori e sulle immagini al momento in cui si è verificato il problema, ed è lo strumento più efficace per la nostra diagnostica. Fare riferimento a Raccolta dati per esecuzione simulata per sapere come registrare.

  4. File di log (Log)：

    • Fornite il log completo dell'applicazione al momento in cui si è verificato il problema.
    • Android: Output di Logcat.
    • iOS: Log di Console.app o output della console di Xcode.
    • Unity: Log della Console di Unity Editor.
    • Mini-applicazione WeChat：File di log ottenuto con session.dumpLog().

  5. Registrazione video o screenshot：

  6. Informazioni sulla libreria di localizzazione Mega

    • In Unity, esportare le informazioni di diagnostica del blocco utilizzato dall'applicazione / le informazioni di servizio della libreria di localizzazione Mega. Metodo di esportazione:

Elenco supplementare per tipi specifici di problemi

Per localizzare il problema in modo più preciso, fornite le seguenti informazioni aggiuntive in base al tipo di problema:

A. Localizzazione fallita o instabile

  • Avete provato a utilizzare Mega Toolbox o lo strumento per PC nella stessa posizione per verificare il problema e potete indicare i risultati.
  • Avete confermato che la mappa caricata nella libreria di localizzazione corrisponde allo spazio fisico attuale.
  • Indicare la posizione approssimativa in cui si è verificato il problema (ad esempio, il cortile di un centro commerciale, l'ingresso di un luogo turistico).

B. Contenuto non visibile

  • Avete fornito i risultati della verifica della localizzazione utilizzando strumenti esterni.
  • Avete confermato che non ci sono problemi con il posizionamento del contenuto o la logica del codice.
  • Se si tratta di un problema di rendering, fornite uno screenshot o una descrizione del modello, dello shader o dell'effetto utilizzato.

C. Contenuto che tremble o si muove in modo erratico

  • Avete indicato il modo in cui il dispositivo è stato mosso (movimento regolare/movimento rapido).
  • Avete descritto le caratteristiche di texture e illuminazione dell'ambiente, nonché se ci sono aree di confusione estremamente simili.
  • Avete indicato la logica di gestione dell'orientamento all'interno dell'applicazione e che il posizionamento del contenuto è corretto.

D. Problemi con le mini-applicazioni WeChat

  • Avete fornito uno screenshot dell'autorizzazione dell'utente a attivare il servizio Mega all'interno di WeChat.
  • Avete indicato se il modello del telefono dell'utente è nella lista ufficiale di supporto di WeChat.
  • Avete fornito l'AppID della mini-applicazione e una descrizione del particolare scenario di business.

E. Problemi di prestazioni (lentezza, consumo elevato di batteria)

  • Avete indicato il modello del dispositivo in cui si è verificato il problema.
  • Avete fornito l'occupazione della CPU/GPU durante l'esecuzione dell'applicazione o le informazioni sulla temperatura del dispositivo (se possibile).
  • Avete indicato il livello di complessità del contenuto 3D (numero di facce del modello, dimensione delle texture).
  • Avete indicato se è stata utilizzata una configurazione multi-immagine.

Esportazione delle informazioni di sviluppo Unity utilizzando EasyAR Sense Unity Plugin

In particolare, per lo sviluppo di applicazioni Mega sulla piattaforma Unity, abbiamo preparato uno strumento più conveniente per generare informazioni di feedback. I passaggi dettagliati sono i seguenti:

  1. Aprire EasyAR > Sense > Domanda nella barra dei menu
    Domanda
  2. Fornire le seguenti informazioni in Domanda:
    • Selezionare l'ambiente di esecuzione (scelta singola), come Android.
    • Copiare le informazioni sul dispositivo. In ARSession, impostare DiagnosticsController.DumpSession su Log, copiare l'output di un frame e inserire il risultato nella casella delle informazioni sul dispositivo.
      Dump session
    • Selezionare tutte le funzionalità di EasyAR utilizzate dall'applicazione, supporto per selezione multipla.
    • Confermare di aver completato i quattro controlli nella pagina e mettere il segno di spunta, è consigliabile descrivere come riprodurre il problema nel Sample quando si fa una domanda.
    • Fare clic sulla funzione di copia nell'angolo in alto a destra per completare la raccolta delle informazioni di sviluppo Unity.
      Esportazione informazioni di sviluppo Unity

Suggerimenti per il flusso di invio delle segnalazioni

  1. Preparazione dei materiali：Raccogliere EIF, log, screenshot/registrazioni video, informazioni di servizio, informazioni di sviluppo, ecc. in base all'elenco sopra.
  2. Redazione della segnalazione：Descrivere chiaramente il problema e allegare tutti i materiali.
  3. Invio：Inviare la segnalazione attraverso il canale scelto.
  4. Follow-up：Dopo aver ricevuto la segnalazione, vi contatteremo tramite canali commerciali o email. Tenete d'occhio le nostre comunicazioni.

Grazie per il vostro tempo e per il supporto al prodotto EasyAR Mega! Ogni vostro feedback ci aiuta a costruire un futuro migliore per il calcolo spaziale.