Langsame Sitzungen (nur Spiele)

Eine langsame Spielsitzung ist eine Sitzung, bei der ein erheblicher Teil der Frames (z. B. mehr als 25 % der Frames) die Zielframetime nicht erreicht, z. B. 50 ms pro Frame (entspricht 20 fps) oder 34 ms pro Frame (entspricht 30 fps). Die Überwachung und Optimierung der Framerate-Leistung ist entscheidend, da ausgelassene oder verzögerte Frames sich direkt darauf auswirken, wie flüssig und reaktionsschnell sich dein Spiel für Spieler anfühlt.

Unter Android werden die Frameraten von Sitzungen anhand von Daten aus SurfaceFlinger gemessen. Dabei wird das Zeitintervall zwischen Frames berücksichtigt, die auf Oberflächen des Spiels gezeichnet werden (einschließlich OpenGL-, Vulkan- und Android-UI-Toolkit-Oberflächen). Wenn Ihre App das View-basierte UI-Toolkit verwendet, bei dem der für den Nutzer sichtbare Teil der App aus Canvas oder der View-Hierarchie stammt, lesen Sie den Abschnitt Langsames Rendering.

FPS messen und langsame Frames erkennen

Der Android-Befehl dumpsys surfaceflinger timestats liefert die durchschnittliche FPS und ein Histogramm für die Present-to-Present-Zeit für alle gerenderten Ebenen. Die Present-to-Present-Zeit eines Frames ist das Intervall zwischen dem Zeichnen des aktuellen Frames und dem Zeichnen des vorherigen Frames. So verwenden Sie den Befehl, um die FPS Ihres Spiels zu erfassen:

  1. Führen Sie den Befehl mit den Flags enable und clear aus, um mit der Erfassung von Informationen zu beginnen:

    adb shell dumpsys SurfaceFlinger --timestats -clear -enable
    
  2. Wenn das Spiel lange genug gespielt wurde, führen Sie den Befehl noch einmal mit dem Flag dump aus, um Informationen zu erfassen:

    adb shell dumpsys SurfaceFlinger --timestats -dump
    

    Die ausgegebenen Informationen enthalten die Gesamtzahl der Frames und das presentToPresent-Histogramm für alle von SurfaceFlinger gerenderten Ebenen. Sie müssen den Abschnitt Ihres Spiels finden, indem Sie nach layerName filtern:

    layerName = SurfaceView[com.google.test/com.devrel.MainActivity]@0(BLAST)#132833
    

    Die langsame Framerate der Sitzung kann anhand der Informationen der einzelnen Ebenen berechnet werden.

    Beispiel: Prozentsatz langsamer Frames bei 20 fps = (Summe der Werte von 54 ms bis 1.000 ms) ÷ totalFrames × 100

    totalFrames = 274
    ...
    presentToPresent histogram is as below:
    0ms=0 1ms=0 2ms=0 3ms=0 4ms=0 5ms=0 6ms=0 7ms=0 8ms=0 9ms=0 10ms=0 11ms=0 12ms=0
    13ms=0 14ms=0 15ms=0 16ms=1 17ms=0 18ms=0 19ms=0 20ms=0 21ms=0 22ms=0 23ms=0
    24ms=0 25ms=0 26ms=0 27ms=0 28ms=0 29ms=0 30ms=0 31ms=0 32ms=0 33ms=269 34ms=0
    36ms=0 38ms=0 40ms=0 42ms=0 44ms=0 46ms=0 48ms=0 50ms=1 54ms=0 58ms=0 62ms=0
    66ms=0 70ms=1 74ms=0 78ms=0 82ms=0 86ms=0 90ms=0 94ms=0 98ms=0 102ms=0 106ms=0
    110ms=0 114ms=0 118ms=0 122ms=0 126ms=0 130ms=0 134ms=0 138ms=0 142ms=0 146ms=0
    150ms=0 200ms=0 250ms=0 300ms=0 350ms=0 400ms=0 450ms=0 500ms=0 550ms=0 600ms=0
    650ms=0 700ms=0 750ms=0 800ms=0 850ms=0 900ms=0 950ms=0 1000ms=0
    

    Die durchschnittlichen FPS der einzelnen Ebenen werden ebenfalls im Dump angezeigt:

    ...
    averageFPS = 30.179
    ...
    
  3. Nachdem Sie alle Informationen erfasst haben, sollten Sie die Zeitstatistiken mit dem Flag disable deaktivieren:

    adb shell dumpsys SurfaceFlinger --timestats -disable
    

Ursachen und Lösungen für langsame Frames

Es gibt viele Gründe, warum ein Frame länger auf dem Bildschirm angezeigt oder gerendert werden kann, als vom Entwickler beabsichtigt. Das Spiel könnte CPU-/GPU-gebunden sein. Oder das Gerät überhitzt und aktiviert einen gedrosselten thermischen Zustand. Oder es gibt eine Abweichung zwischen der Framerate des Spiels und der Aktualisierungsrate des Displays des Geräts.

Verwenden Sie Android Frame Pacing (Swappy), Vulkan und ADPF, um diese Probleme zu beheben und die Leistung Ihres Spiels zu verbessern.

Was ist Swappy?

Die Frame Pacing Library für Android, auch als Swappy bezeichnet, ist Teil der AGDK-Bibliotheken. Swappy hilft OpenGL- und Vulkan-Spielen, ein flüssiges Rendering und eine korrekte Frame-Pacing-Funktion unter Android zu erreichen.

Frame Pacing ist die Synchronisierung der Logik- und Rendering-Schleife eines Spiels mit dem Display-Subsystem eines Betriebssystems und der zugrunde liegenden Display-Hardware. Das Android-Anzeigesubsystem wurde so konzipiert, dass visuelle Artefakte (Tearing) vermieden werden, die auftreten können, wenn die Anzeigehardware während eines Updates zu einem neuen Frame wechselt. Um diese Artefakte zu vermeiden, führt das Display-Subsystem Folgendes aus:

  • Puffert vergangene Frames intern
  • Erkennt verspätete Frame-Übermittlungen
  • Wiederholt die Anzeige vergangener Frames, wenn verspätete Frames erkannt werden

Hier erfährst du, wie Mir 2 Swappy verwendet hat, um den Anteil langsamer Sitzungen von 40 % auf 10 % zu reduzieren.

Swappy in nativen Projekten verwenden

In den folgenden Leitfäden erfahren Sie, wie Sie die Android Frame Pacing-Bibliothek in Ihr Spiel einbinden:

Swappy in der Unity-Game-Engine verwenden

Unity hat Android Frame Pacing in seine Engine integriert. Wenn Sie diese Funktion in Unity 2019.2 oder höher aktivieren möchten, setzen Sie unter Projekteinstellungen > Player > Einstellungen für Android > Auflösung und Präsentation ein Häkchen bei „Optimiertes Frame Pacing“:

Dialogfeld „Projekteinstellungen“
Abbildung 1: Frame-Pacing in der Unity-Engine aktivieren.

Alternativ können Sie die Option „Optimierte Frame-Taktung“ programmatisch in Ihrem Logikcode aktivieren, damit Unity Frames gleichmäßig verteilen kann. So wird die Varianz der Framerate verringert und das Gameplay flüssiger.

Swappy in der Unreal-Game-Engine verwenden

Unreal 4.25 und höher integrieren die Android Frame Pacing Library, die Teil des Android Game Development Kit ist. Im Artikel Frame-Pacing für Mobilgeräte wird erläutert, wie Sie die Android Frame Pacing Library aktivieren und das Frame-Pacing über C++-Code steuern.

Was ist Vulkan?

Vulkan ist eine moderne plattformübergreifende 3D-Grafik-API, die die Abstraktion zwischen der Grafikhardware des Geräts und Ihrem Spiel minimiert. Vulkan ist die primäre Low-Level-Grafik-API für Android und ersetzt OpenGL ES. OpenGL ES wird unter Android weiterhin unterstützt, aber es werden keine neuen Funktionen mehr dafür entwickelt.

Vulkan bietet gegenüber OpenGL ES die folgenden Vorteile:

  • Eine effizientere Architektur mit geringerem CPU-Overhead im Grafiktreiber
  • Neue Optimierungsstrategien zur Verbesserung der CPU-Leistung
  • Neue Grafikfunktionen, die in OpenGL ES nicht verfügbar sind, z. B. bindungslose APIs und Raytracing

Vulkan in nativen Android-Projekten verwenden

Das Codelab Erste Schritte mit Vulkan auf Android-Geräten führt Sie durch die Einrichtung Ihrer Vulkan-Rendering-Pipeline und das Rendern eines texturierten, rotierenden Dreiecks auf dem Bildschirm. Im Codelab erfahren Sie, wie Sie Ihre Spielgrafiken rendern.

Vulkan in der Unity-Spiel-Engine verwenden

Wenn Sie die automatische Geräteauswahl in Unity aktivieren möchten, folgen Sie der Anleitung zum Konfigurieren der Auto Graphics API.

Dialogfeld „Projekteinstellungen“
Abbildung 2. Aktivieren Sie die Unity Auto Graphics API.

Alternativ können Sie Vulkan manuell aktivieren, indem Sie Auto Graphics API deaktivieren und Vulkan in der Liste Graphics APIs die höchste Priorität zuweisen. Wenn Sie Unity 2021.1 oder eine frühere Version verwenden, ist dies die einzige Möglichkeit, Vulkan zu verwenden.

Dialogfeld „Projekteinstellungen“
Abbildung 3. Wählen Sie Vulkan in Unity manuell als Hauptgrafik-API aus.

Mit dem VkQuality Unity Engine-Plug-in können Sie Empfehlungen für die Grafik-API beim Start Ihres Spiels auf bestimmten Geräten bereitstellen.

Vulkan in der Unreal-Spiel-Engine verwenden

Wenn Sie die Vulkan-Grafik-API aktivieren möchten, rufen Sie Projekteinstellungen > Plattformen > Android > Build auf und wählen Sie Vulkan unterstützen aus. Wenn Sie sowohl Support Vulkan als auch Support OpenGL ES3.2 auswählen, verwendet Unreal standardmäßig Vulkan. Wenn das Gerät Vulkan nicht unterstützt, greift Unreal auf OpenGL ES 3.2 zurück.

Dialogfeld „Projekteinstellungen“
Abbildung 4. Vulkan in Unreal Engine aktivieren

Wenn du bestimmte Vulkan-Funktionen verwendest, die auf bestimmten Geräten bekanntermaßen Probleme verursachen, kannst du deine BaseDeviceProfile.ini-Datei so anpassen, dass diese Geräte ausgeschlossen werden. Unter Geräteprofile und Skalierbarkeit für Android anpassen erfährst du, wie du BaseDeviceProfile.ini anpassen kannst. Da neue Gerätetreiber möglicherweise zuvor bekannte fehlerhafte Geräte beheben, sollten Sie die Datei BaseDeviceProfile.ini auf dem neuesten Stand halten, um alle Optimierungen zu erhalten.

Was ist das ADPF?

Das Android Dynamic Performance Framework (ADPF) optimiert Spiele basierend auf den dynamischen Funktionen für Temperatur-, CPU- und GPU-Verwaltung unter Android. Der Schwerpunkt liegt auf Spielen, aber Sie können die Funktionen auch für andere leistungsintensive Apps verwenden.

Das ADPF ist eine Reihe von APIs, mit denen Spiele und leistungsintensive Apps direkter mit den Energie- und Thermosystemen von Android-Geräten interagieren können. Mit diesen APIs kannst du das dynamische Verhalten auf Android-Systemen überwachen und die Spieleleistung auf einem nachhaltigen Niveau optimieren, das die Geräte nicht überhitzt.

Hier sind die wichtigsten ADPF-Funktionen:

  • Thermal API: Überwacht den thermischen Zustand eines Geräts, damit die Anwendung die Arbeitslast proaktiv anpassen kann, bevor sie nicht mehr tragbar ist.
  • CPU Performance Hint API: Mit dieser API können Sie Leistungshinweise bereitstellen, damit Android die richtigen Leistungseinstellungen (z. B. CPU-Betriebspunkt oder -Kern) für die Arbeitslast auswählen kann.
  • Game Mode API und Game State API: Ermöglichen die Optimierung des Gameplays, indem die Leistung oder die Akkulaufzeit priorisiert wird, je nach den Einstellungen des Nutzers und den spielspezifischen Konfigurationen.
  • Modus mit fester Leistung: Aktiviere den Modus mit fester Leistung auf einem Gerät während des Benchmarkings, um Messwerte zu erhalten, die nicht durch dynamische CPU-Taktung verändert werden.
  • Energieeffizienzmodus: Teilt der Sitzung mit, dass die Threads in der Performance Hint Session so geplant werden können, dass die Energieeffizienz gegenüber der Leistung bevorzugt wird. Verfügbar in Android 15 (API-Level 35).

ADPF in nativen Android-Projekten verwenden

Im Codelab Anpassungsfunktionen in ein natives Spiel einbinden wird Schritt für Schritt erklärt, wie Sie ADPF-Funktionen in Ihr Spiel einbinden. Sie können die Schritte in Ihrem eigenen Tempo ausführen. Am Ende des Codelabs haben Sie die folgenden Funktionen integriert:

  • Thermal API: Mit dieser API kannst du die Temperatur des Geräts überwachen und reagieren, bevor es in den thermischen Drosselungszustand wechselt.
  • Game Mode API: Hier kannst du die Optimierungseinstellungen der Spieler (maximale Leistung oder Akkuschonung) einsehen und entsprechend anpassen.
  • Game State API: Informiert das System über den Status des Spiels (Laden, Spielen, UI usw.), damit das System die Ressourcen entsprechend anpassen kann (E/A, CPU, GPU usw. erhöhen).
  • Performance Hint API: Informieren Sie das System über Ihr Threading-Modell und Ihre Arbeitslast, damit das System die Ressourcen entsprechend zuweisen kann.

ADPF in der Unity-Game-Engine verwenden

Adaptive Performance von Unity ist ein Tool für Spieleentwickler, die ihre Spiele für Mobilgeräte optimieren möchten, insbesondere für das vielfältige Android-Ökosystem. Mit Adaptive Performance kann sich Ihr Spiel in Echtzeit an die Leistung und die thermischen Eigenschaften des Geräts anpassen, um ein reibungsloses und effizientes Spielerlebnis zu ermöglichen.

Adaptive Performance Android Provider führt Sie durch die Schritte zur Implementierung von ADPF in Unity.

Dialogfeld „Projekteinstellungen“
Abbildung 5. ADPF in die Unity Engine einbinden

ADPF in der Unreal-Game-Engine verwenden

Dialogfeld „Projekteinstellungen“
Abbildung 6: ADPF in Unreal Engine einbinden
  1. Plug-in herunterladen
  2. Kopieren Sie das Plug-in in den Plug-in-Ordner des Projekts.
  3. ADPF Unreal Engine-Plug-in im Unreal-Editor aktivieren
  4. Unreal Editor neu starten
  5. Build und Cook für das Spiel ausführen

Das Android Dynamic Performance Framework-Plug-in (ADPF) für die Unreal Engine sorgt für eine stabile Leistung und verhindert thermisches Throttling. Laden Sie das Plug-in von GitHub herunter. Dieses Plug-in ändert Funktionen, indem es Unreal-Konsolenwerte festlegt.