Zintegruj wtyczkę

Z tego artykułu dowiesz się, jak pobrać, zaimportować i skonfigurować wtyczkę Unity do narzędzia Android Performance Tuner.

Wymagania

Aby użyć wtyczki w grze, użyj obsługiwanej wersji Unity:

• Unity w wersji 2017.4 lub nowszej i .NET w wersji 4.6
• Do korzystania z plików rozszerzeń APK wymagana jest wersja Unity 2018.2
• Aby uzyskać dokładniejsze pomiary szybkości klatek i umożliwiające pomiary GPU, musisz mieć Unity w wersji 2019.3.14 lub nowszej
• Do obsługi scen Addressables wymagane jest oprogramowanie Unity 2019.3 lub nowsze oraz pakiet Addressables w wersji 1.19.4 lub nowszej.

Pobierz wtyczkę

Pobierz wtyczkę z repozytorium GitHub. Wybierz pobrany plik .unitypackage.

Importowanie wtyczki

Przed zaimportowaniem wtyczki sprawdź, czy Twój projekt korzysta z programu .NET w wersji 4.6. Dotyczy to Unity w wersji 2018.4 i starszych (późniejsze wersje zawierają tylko .NET 4.6).

1. Wybierz Plik > Ustawienia kompilacji. Upewnij się, że jako aktualną platformę wybierasz Androida.
2. Kliknij przycisk Ustawienia odtwarzacza.
3. W sekcji Inne ustawienia znajdź Wersja środowiska wykonawczego Scripting i wybierz .NET 4.6.

Wtyczka jest udostępniana w postaci pakietu Unity, który można zaimportować w projekcie. Wybierz Zasoby > Importuj pakiet > Pakiet niestandardowy i wybierz pobrany plik .unitypackage.

Android Performance Tuner w wersji 1.5.1 lub nowszej z Unity 2017;

Importowanie wtyczki Android Performance Tuner w wersji 1.5.1 lub nowszej w połączeniu z Unity 2017 wymaga wykonania tych dodatkowych czynności:

1. Otwórz folder Assets/AndroidPerformanceTuner/Editor.
2. Kliknij plik Google.Android.PerformanceTuner.Editor, aby otworzyć go w inspektorze.
3. Kliknij brakujące odwołanie do zespołu, a następnie kliknij -, aby je usunąć.

4. Kliknij przycisk Zastosuj.

   Rysunek 1. Brak odwołania do zestawu.

5. Otwórz folder Assets/AndroidPerformanceTuner/Runtime.

6. Kliknij plik Google.Android.PerformanceTuner, aby go otworzyć w inspektorze.

7. Powtórz krok 3, by usunąć 2 brakujące odwołania do zestawu.

8. Uruchom ponownie Unity.

9. Kliknij Okno > AndroidPerformanceTuner > Konfiguracja i sprawdź, czy nie są wyświetlane żadne błędy.

Ponowne zaimportowanie wtyczki po usunięciu

Jeśli ponownie importujesz wtyczkę po usunięciu jej z projektu, najpierw usuń ANDROID_PERFORMANCE_TUNER_UTILITIES z Ustawienia odtwarzacza > Definiowanie symboli na potrzeby obsługi skryptów.

Konfigurowanie wtyczki

Aby skonfigurować wtyczkę:

1. Unity w wersji 2019.3.14 lub nowszej:

   • Włącz bibliotekę Android Frame Pacing. Android Performance Tuner będzie korzystać z tej biblioteki do pomiaru wydajności gry, w tym do bardziej szczegółowych pomiarów niż w samej Unity.

     Wybierz Plik > Ustawienia kompilacji i kliknij przycisk Ustawienia odtwarzacza. W sekcji Rozdzielczość i prezentacja zaznacz pole wyboru Zoptymalizowane tempo klatek.

   • Synchronizuj renderowanie klatek z pionowymi pustymi polami.

     W ustawieniach odtwarzacza wybierz kartę Jakość i znajdź menu Licznik VSync Count. Użyj dowolnego wyboru (oprócz Nie synchronizuj). Opcje inne niż Nie synchronizuj umożliwiają dokładniejsze pomiary w połączeniu z biblioteką Android Frame Pacing.

2. W przypadku wersji Unity starszych niż 2019 r. ustaw system kompilacji na Gradle. Wybierz Plik > Ustawienia kompilacji. Znajdź System kompilacji i wybierz Gradle.

3. Dodaj uprawnienia dostępu do internetu. W sekcji Inne ustawienia znajdź Dostęp do internetu i wybierz Wymagaj.

4. Wpisz klucz interfejsu API. Po zainstalowaniu wtyczki możesz ją dodać, klikając menu Okno > Android Performance Tuner > Konfiguracja. W tym oknie wybierz kartę Ustawienia i w polu Klucz interfejsu API wpisz klucz interfejsu API z projektu Google Cloud.

   Rysunek 2. Karta Ustawienia we wtyczce