Plug-in einbinden

Auf dieser Seite wird beschrieben, wie Sie das Unity-Plug-in für den Android Performance Tuner herunterladen, importieren und konfigurieren.

Voraussetzungen

Wenn Sie das Plug-in in Ihrem Spiel verwenden möchten, benötigen Sie eine unterstützte Version von Unity:

• Unity-Version 2017.4 oder höher und .NET Version 4.6
• Zur Verwendung von APK-Erweiterungsdateien ist Unity 2018.2 erforderlich
• Für verbesserte Frame-Taktung und GPU-Messungen ist die Unity-Version 2019.3.14 oder höher erforderlich
• Zur Unterstützung von Addressables-Szenen sind Unity 2019.3 oder höher und das Addressables-Paket 1.19.4 oder höher erforderlich.

Plug-in herunterladen

Laden Sie das Plug-in aus dem GitHub-Repository herunter. Wählen Sie die heruntergeladene Datei .unitypackage aus.

Plug-in importieren

Stellen Sie vor dem Importieren des Plug-ins sicher, dass Ihr Projekt die .NET-Version 4.6 verwendet. Dies gilt für Unity-Version 2018.4 und niedriger (neuere Versionen von Unity enthalten nur die .NET-Version 4.6).

1. Wählen Sie File > Build Settings (Datei > Build-Einstellungen) aus. Achten Sie darauf, dass Android als aktuelle Plattform ausgewählt ist.
2. Klicken Sie auf die Schaltfläche Player Settings (Player-Einstellungen).
3. Suchen Sie unter Weitere Einstellungen nach Scripting-Laufzeitversion und wählen Sie .NET 4.6 aus.

Das Plug-in wird als Unity-Paket bereitgestellt, das Sie in Ihr Projekt importieren können. Wählen Sie Assets > Paket importieren > Benutzerdefiniertes Paket und dann die heruntergeladene Datei .unitypackage aus.

Android Performance Tuner Version 1.5.1 oder höher mit Unity 2017

Wenn Sie den Android Performance Tuner 1.5.1 oder höher mit Unity 2017 verwenden, sind beim Importieren des Plug-ins die folgenden zusätzlichen Schritte erforderlich:

1. Wechseln Sie zum Ordner Assets/AndroidPerformanceTuner/Editor.
2. Klicken Sie auf die Datei Google.Android.PerformanceTuner.Editor, um sie im Inspector zu öffnen.
3. Klicken Sie auf die fehlende Assembly-Referenz und dann auf -, um sie zu entfernen.

4. Klicken Sie auf die Schaltfläche Übernehmen.

   Abbildung 1: Assembly-Referenz fehlt.

5. Wechseln Sie zum Ordner Assets/AndroidPerformanceTuner/Runtime.

6. Klicken Sie auf die Datei Google.Android.PerformanceTuner, um sie im Inspector zu öffnen.

7. Wiederholen Sie Schritt 3, um die beiden fehlenden Assembly-Verweise zu entfernen.

8. Starten Sie Unity neu.

9. Rufen Sie Fenster > AndroidPerformanceTuner > Einrichtung auf und vergewissern Sie sich, dass keine Fehler angezeigt werden.

Plug-in nach dem Löschen noch einmal importieren

Wenn du das Plug-in erneut importieren möchtest, nachdem du es aus dem Projekt entfernt hast, entferne zuerst ANDROID_PERFORMANCE_TUNER_UTILITIES unter Player-Einstellungen > Scripting und Symbole definieren.

Plug-in konfigurieren

So konfigurieren Sie das Plug-in:

1. Ab Unity-Version 2019.3.14:

   • Android Frame Pacing-Bibliothek aktivieren Der Android Performance Tuner verwendet diese Bibliothek, um die Leistung deines Spiels zu messen, einschließlich detaillierterer Messwerte, als Unity allein meldet.

     Wählen Sie File > Build Settings (Datei > Build-Einstellungen) aus und klicken Sie auf die Schaltfläche Player Settings (Player-Einstellungen). Klicken Sie unter Auflösung und Präsentation das Kästchen Optimierte Frame-Taktung an.

   • Synchronisieren Sie das Frame-Rendering mit vertikalen leeren Zellen.

     Wähle in den Playereinstellungen den Tab Qualität aus und öffne das Menü Anzahl der VSync-Daten. Verwenden Sie eine beliebige Auswahl, außer Nicht synchronisieren. Eine andere Auswahl als Nicht synchronisieren ermöglicht präzisere Messungen in Verbindung mit der Android Frame Pacing-Bibliothek.

2. Setzen Sie das Build-System auf Gradle. Dies gilt für Versionen von Unity vor 2019. Wählen Sie File > Build Settings (Datei > Build-Einstellungen) aus. Suchen Sie nach Build System (System erstellen) und wählen Sie Gradle aus.

3. Fügen Sie die Berechtigung für den Internetzugriff hinzu. Suchen Sie unter Weitere Einstellungen nach Internetzugriff und wählen Sie Erforderlich aus.

4. Geben Sie Ihren API-Schlüssel ein. Sobald das Plug-in installiert ist, können Sie es über das Menü Fenster > Android Performance Tuner > Einrichtung aufrufen. Wählen Sie in diesem Dialogfeld den Tab Einstellungen aus und geben Sie den API-Schlüssel aus Ihrem Google Cloud-Projekt in das Feld API-Schlüssel ein.

   Abbildung 2: Tab „Einstellungen“ im Plug-in