In diesem Leitfaden wird beschrieben, wie Sie mit einem Unity-Plug-in Frame-Time-Daten aus Unity 2017.4 oder höher aufzeichnen und hochladen.
Informationen zu Spiel-Engines, die C oder C++ verwenden, finden Sie im Leitfaden für native Spiel-Engines.
Hintergrund
Eine wichtige Komponente des Spielerlebnisses ist die Rendering-Leistung. Die Renderingleistung ist das Ergebnis der folgenden beiden Eingaben:
- Framerate: Wie oft ein Frame gezeichnet wird.
- Einstellungen für die Grafikqualität: Detailgenauigkeit, mit der ein Frame dargestellt wird, einschließlich Simulationsgenauigkeit und Grafik.
Bei Spielen ist eine gute Renderingleistung so definiert:
- Eine stabile, konsistente Framerate (d. h. der Prozentsatz der Frames, die mit der gewünschten Frequenz gerendert werden).
- Frames werden mit der höchstmöglichen Frequenz gerendert, während die Stabilität beibehalten wird, in der Regel 30 oder 60 FPS, je nach Art des Spiels.
- Maximierung des Detailgrads für einen Nutzer angesichts seiner Bildschirmgröße und -dichte bei gleichzeitiger Erreichung einer gewünschten, stabilen Framerate.
Die Android Frame Pacing Library begrenzt einen Großteil der Schwankungen bei den Frame Times und sorgt so für eine stabile Framerate bei Spielen. Die verbleibende Abweichung bei den Frame Times ist auf den Detailgrad zurückzuführen, der in bestimmten Szenen im Gameplay angezeigt wird, sowie auf die Grafikleistung des Geräts. Mit dem Android Performance Tuner kannst du Zeitpunkte während des Gameplays ermitteln, zu denen die Frame Time langsamer oder schneller als dein Ziel ist, und diese Probleme und Möglichkeiten mit Folgendem in Verbindung bringen:
- Spezifische Qualitätseinstellungen
- Bestimmte Szenen in Ihrem Spiel
- Bestimmte Gerätemodelle oder Gerätespezifikationen
Daten aufzeichnen und hochladen
Die Tuning Fork-Bibliothek benötigt eine ihrer Tick-Funktionen, die von der Android Frame Pacing-Bibliothek (oder von der Unity-Engine für ältere Versionen von Unity, in denen die Frame Pacing-Bibliothek nicht vorhanden ist) für jeden Frame aufgerufen wird. In der Bibliothek werden diese Tick-Informationen in Histogrammen zusammengefasst, die dann regelmäßig über einen HTTP-Endpunkt in Google Play hochgeladen werden. Jeder Tick wird als mit einem Instrumentenschlüssel und einer Anmerkung verknüpft aufgezeichnet. Anmerkungen werden mit dem Unity-Plug-in definiert.
Instrumentenschlüssel
Ein Instrumentenschlüssel gibt an, woher der Tick im Frame stammt. Er ist eine Ganzzahl, die an jeden Tick-Funktionsaufruf übergeben werden muss. Dies geschieht automatisch durch das Unity-Plug-in. Wenn die Option „Optimized Frame Pacing“ (Optimiertes Frame Pacing) in den Unity-Einstellungen für Ihr Spiel aktiviert ist (verfügbar in Unity-Version 2019.3.14 oder höher), verwendet Android Performance Tuner Informationen aus der Android Frame Pacing-Bibliothek, um erweiterte Messwerte zu melden.
Annotationen
Anmerkungen liefern Kontextinformationen dazu, was dein Spiel tut, wenn ein Tick aufgezeichnet wird. Eine Annotation kann beispielsweise Folgendes identifizieren:
- Das aktuelle Spiellevel
- Eine bestimmte Szene wird geladen
- Ein „Big Boss“ ist auf dem Bildschirm zu sehen.
- Sonstige relevante Informationen zum Spielstatus
Anmerkungen werden in einem Dialogfeld definiert, das vom Unity-Plug-in bereitgestellt wird.
Intern verwendet die Tuning Fork-Bibliothek das Protokollzwischenspeicher-Format von Google, um Annotationen und Parameter zur Grafikqualität zu speichern. Dies ist ein klar definiertes, mehrsprachiges Protokoll für erweiterbare, strukturierte Daten. Weitere Informationen finden Sie in der Dokumentation zu Protokollzwischenspeichern.
Parameter zur Grafikqualität
Die Parameter zur Grafikqualität beeinflussen die Leistung und grafische Wiedergabe Ihres Spiels, z. B. den Detaillierungsgrad des Gitters, die Texturauflösung und die Antialiasing-Methode. Wie Annotationen werden auch Parameter zur Grafikqualität in einem Dialogfeld definiert, das vom Unity-Plug-in bereitgestellt wird.
Arbeitsspeicher- und CPU-Overhead
Der gesamte von der Tuning Fork-Bibliothek verwendete Arbeitsspeicher wird bei der Initialisierung zugewiesen, um Überraschungen während des Spiels zu vermeiden. Die Größe der Daten hängt von der Anzahl der Instrumentenschlüssel, der Anzahl der möglichen Annotationen und der Anzahl der Buckets in jedem Histogramm ab. Sie ist ein Vielfaches aller dieser Werte mal vier Byte für jeden Bucket. Außerdem gibt es zwei Kopien aller Histogramme, um die Übermittlung in einem doppelt gepufferten Modus zu ermöglichen.
Die Übermittlung erfolgt in einem separaten Thread und blockiert keine Tick-Aufrufe. Wenn keine Uploadverbindung verfügbar ist, wird die Einreichung für einen späteren Upload in die Warteschlange gestellt.
Der Verarbeitungsaufwand für den Aufruf einer Tick-Funktion ist gering: Es wird einfach ein Index in das Array von Histogramm-Buckets berechnet und ein Ganzzahlzähler erhöht.
Webanfragen
Die Bibliothek sendet zwei Arten von Anfragen an den Serverendpunkt:
- Eine
generateTuningParameters-Anfrage bei der Initialisierung - In regelmäßigen Abständen während des Spiels eine
uploadTelemetry-Anfrage zum Senden von Daten an den Server
Offline-Player
Wenn bei der Initialisierung keine Verbindung verfügbar ist, wird die Anfrage mehrmals mit einer zunehmenden Backoff-Zeit wiederholt. Wenn beim Upload keine Verbindung besteht, wird der Upload im Cache gespeichert. Uploads werden als Dateien im temporären Speicher gespeichert.
Voraussetzungen
Wenn Sie das Plug-in in Ihrem Spiel verwenden möchten, müssen Sie eine unterstützte Version von Unity verwenden:
- Unity-Version 2017.4 oder höher und .NET-Version 4.6
- Für die Verwendung von APK-Erweiterungsdateien ist Unity 2018.2 erforderlich
- Für ein verbessertes Frame-Pacing und bessere GPU-Messungen ist Unity Version 2019.3.14 oder höher erforderlich.
- Für die Unterstützung von Addressables-Szenen sind Unity 2019.3 oder höher und das Addressables-Paket 1.19.4 oder höher erforderlich.
Android Performance Tuner in Unity einbinden
Weitere Informationen zum Einbinden von Android Performance Tuner in Unity findest du unter API aktivieren.