Overlay sul rendimento ARCore

ARCore può visualizzare un riquadro overlay con le statistiche sulle prestazioni di un'app, come l'utilizzo di CPU e memoria, fornendo una panoramica in tempo reale delle risorse di sistema.

Attivare l'overlay del rendimento

Segui questi passaggi per attivare l'overlay del rendimento.

  1. Apri l'esperienza AR nell'app in modo che sia in esecuzione una sessione ARCore attiva. L'app deve essere in modalità AR per ricevere la trasmissione che attiva l'overlay. Le immagini di anteprima della fotocamera AR dovrebbero essere visibili sullo schermo del dispositivo.

  2. Utilizza il seguente comando di trasmissione Gestione attività per attivare l'overlay delle prestazioni per la tua app.

    # Enables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains enabled in
# subsequent ARCore sessions.

# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.ENABLE_PERFORMANCE_OVERLAY

  3. Potresti essere indirizzato al menu Settings per concedere al pacchetto ARCore l'autorizzazione a disegnare overlay. Questo passaggio deve essere eseguito una sola volta. Individua Google Play Services for AR e imposta il pulsante di attivazione/disattivazione delle autorizzazioni su Allowed prima di tornare alla tua app.

    Se hai attivato l'overlay delle prestazioni senza concedere ad ARCore l'autorizzazione per disegnare gli overlay, ti reindirizzeremo al menu Impostazioni ogni volta che l'app avvia una nuova sessione ARCore. In questo caso, devi concedere l'autorizzazione ARCore o disattivare l'overlay delle prestazioni.

Disattivare l'overlay del rendimento

Segui questi passaggi per disattivare l'overlay delle prestazioni.

  1. Apri l'esperienza AR nell'app in modo che sia in esecuzione una sessione ARCore attiva. L'app deve essere in modalità AR per ricevere la trasmissione che disattiva l'overlay. Le immagini di anteprima della fotocamera AR dovrebbero essere visibili sullo schermo del dispositivo.

  2. Utilizza il seguente comando di trasmissione di Gestione attività per disattivare l'overlay delle prestazioni per la tua app.

    # Disables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains disabled in
# subsequent ARCore sessions.

# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.DISABLE_PERFORMANCE_OVERLAY

Puoi anche disattivare l'overlay sul rendimento toccando il pulsante di chiusura sull'overlay e cancellando le preferenze condivise di Android dell'app. Un modo per farlo è cancellare i dati dell'app.

Interpretazione dei valori di utilizzo della CPU

Il campo Process CPU Usage mostra la quantità di tempo di CPU attualmente utilizzata dal processo di applicazione come percentuale del tempo di CPU totale disponibile del dispositivo. Questo valore include i carichi di lavoro delle applicazioni, i carichi di lavoro ARCore e qualsiasi altra libreria utilizzata dalla tua app. Ad esempio, nel campo viene visualizzato l'utilizzo del 25% della CPU se il processo di applicazione satura completamente un singolo core della CPU quando viene eseguito su un dispositivo quad-core.

L'overlay delle prestazioni fornisce anche un'analisi dell'utilizzo della CPU per singole funzionalità ARCore. Queste suddivisioni sono anche espresse come percentuale del tempo di CPU totale disponibile del dispositivo. I carichi di lavoro sono:

L'overlay non mostra le funzionalità disattivate o che utilizzano meno dello 0,1% di tempo di CPU.