ARCore-Leistungs-Overlay

ARCore kann ein Overlay mit den Leistungsstatistiken einer App wie CPU- und Arbeitsspeichernutzung anzeigen, das einen Echtzeitüberblick über die Systemressourcen bietet.

Leistungs-Overlay aktivieren

So aktivieren Sie das Leistungs-Overlay:

  1. Öffne die AR-Version in deiner App, damit eine aktive ARCore-Sitzung ausgeführt wird. Deine App muss sich im AR-Modus befinden, um die Übertragung zu empfangen, durch die das Overlay aktiviert wird. Die Vorschaubilder der AR-Kamera sollten auf dem Gerätebildschirm sichtbar sein.

  2. Verwenden Sie den folgenden Broadcast-Befehl des Aktivitätsmanagers, um das Leistungs-Overlay für Ihre App zu aktivieren.

    # 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. Sie können zum Menü Settings weitergeleitet werden, um dem ARCore-Paket die Berechtigung zum Erstellen von Overlays zu erteilen. Dieser Schritt muss nur einmal ausgeführt werden. Suchen Sie nach Google Play Services for AR und setzen Sie die Ein-/Aus-Schaltfläche für Berechtigungen auf Allowed, bevor Sie zu Ihrer App zurückkehren.

    Wenn Sie das Leistungs-Overlay aktiviert haben, ohne ARCore die Berechtigung zum Erstellen von Overlays zu erteilen, werden Sie bei jedem Start einer neuen ARCore-Sitzung durch die App zum Menü „Einstellungen“ weitergeleitet. In diesem Fall sollten Sie entweder die Berechtigung „ARCore“ erteilen oder das Leistungs-Overlay deaktivieren.

Leistungs-Overlay deaktivieren

So deaktivieren Sie das Leistungs-Overlay:

  1. Öffne die AR-Version in deiner App, damit eine aktive ARCore-Sitzung ausgeführt wird. Deine App muss sich im AR-Modus befinden, um den Broadcast zu empfangen, durch den das Overlay deaktiviert wird. Die Vorschaubilder der AR-Kamera sollten auf dem Gerätebildschirm sichtbar sein.

  2. Deaktivieren Sie mit dem folgenden Aktivitätsmanager-Broadcast-Befehl das Leistungs-Overlay für Ihre 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

Du kannst das Leistungs-Overlay auch deaktivieren, indem du im Overlay auf die Schaltfläche „Schließen“ tippst und die geteilten Android-Einstellungen deiner App löschst. Eine Möglichkeit dafür besteht darin, die Daten Ihrer App zu löschen.

CPU-Nutzungswerte interpretieren

Im Feld Process CPU Usage wird die derzeit vom Anwendungsprozess verwendete CPU-Zeit als Prozentsatz der insgesamt verfügbaren CPU-Zeit des Geräts angezeigt. Dieser Wert umfasst Anwendungsarbeitslasten, ARCore-Arbeitslasten und alle anderen Bibliotheken, die Ihre App verwendet. In diesem Feld wird beispielsweise eine CPU-Auslastung von 25% angezeigt, wenn der Anwendungsprozess einen einzelnen CPU-Kern vollständig auslastet, wenn er auf einem Quad-Core-Gerät ausgeführt wird.

Das Leistungs-Overlay enthält auch eine Aufschlüsselung der CPU-Nutzung für einzelne ARCore-Funktionen. Diese Aufschlüsselungen werden auch als Prozentsatz der insgesamt verfügbaren CPU-Zeit des Geräts ausgedrückt. Die Arbeitslasten sind:

Das Overlay zeigt keine Funktionen, die deaktiviert sind oder weniger als 0,1% CPU-Zeit beanspruchen.