Superposition des performances ARCore

ARCore peut afficher un panneau en superposition avec les statistiques de performances d'une application, telles que l'utilisation du processeur et de la mémoire, offrant un aperçu en temps réel des ressources système.

Activer la superposition des performances

Pour activer la superposition des performances, procédez comme suit :

  1. Ouvrez l'expérience de RA dans votre application pour qu'une session ARCore active soit en cours d'exécution. Votre application doit être en mode RA pour recevoir la diffusion qui active la superposition. Les images d'aperçu de la caméra RA doivent être visibles sur l'écran de l'appareil.

  2. Utilisez la commande de diffusion suivante du gestionnaire d'activités afin d'activer la superposition des performances pour votre application.

    # 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. Vous pouvez être redirigé vers le menu Settings pour autoriser le package ARCore à dessiner des superpositions. Cette étape ne doit être effectuée qu'une seule fois. Recherchez Google Play Services for AR et définissez le bouton d'activation des autorisations sur Allowed avant de revenir à votre application.

    Si vous avez activé la superposition des performances sans autoriser ARCore à dessiner des superpositions, vous serez redirigé vers le menu "Paramètres" chaque fois que l'application démarre une nouvelle session ARCore. Dans ce cas, vous devez accorder l'autorisation à ARCore ou désactiver la superposition des performances.

Désactiver la superposition des performances

Pour désactiver la superposition des performances, procédez comme suit :

  1. Ouvrez l'expérience de RA dans votre application pour qu'une session ARCore active soit en cours d'exécution. Votre application doit être en mode RA pour recevoir la diffusion qui désactive la superposition. Les images d'aperçu de la caméra RA doivent être visibles sur l'écran de l'appareil.

  2. Utilisez la commande de diffusion suivante du gestionnaire d'activités pour désactiver la superposition des performances pour votre application.

    # 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

Vous pouvez également désactiver la superposition des performances en appuyant sur le bouton de fermeture sur la superposition et en effaçant les préférences partagées Android de votre application. Pour ce faire, vous pouvez effacer les données de votre application.

Interpréter les valeurs d'utilisation du processeur

Le champ Process CPU Usage affiche le temps CPU actuellement utilisé par le processus d'application, sous la forme d'un pourcentage du temps CPU total disponible de l'appareil. Cette valeur inclut les charges de travail de l'application, les charges de travail ARCore et toutes les autres bibliothèques utilisées par votre application. Par exemple, le champ affiche 25% d'utilisation du processeur si le processus d'application sature entièrement un seul cœur de processeur lors de l'exécution sur un appareil à quatre cœurs.

La superposition des performances fournit également une répartition de l'utilisation du processeur pour chaque fonctionnalité ARCore. Ces répartitions sont également exprimées en pourcentage du temps CPU total disponible de l'appareil. Les charges de travail sont les suivantes:

La superposition n'affiche aucune fonctionnalité désactivée ou utilisant moins de 0,1% de temps CPU.