Na tej stronie opisujemy, jak pobrać, zaimportować i skonfigurować wtyczkę Unity do narzędzia Android Performance Tuner.
Wymagania
Aby używać wtyczki w grze, musisz mieć obsługiwaną wersję Unity:
- Unity w wersji 2017.4 lub nowszej i .NET w wersji 4.6
- Aby używać plików rozszerzających APK, musisz mieć Unity 2018.2.
- Aby uzyskać lepsze tempo klatek i pomiary GPU, wymagana jest wersja Unity 2019.3.14 lub nowsza
- Do obsługi scen Addressables wymagany jest silnik Unity 2019.3 lub nowszy oraz pakiet Addressables 1.19.4 lub nowszy.
Pobieranie wtyczki
Pobierz wtyczkę z repozytorium GitHub. Wybierz pobrany plik .unitypackage.
Importowanie wtyczki
Przed zaimportowaniem wtyczki upewnij się, że Twój projekt korzysta z platformy .NET w wersji 4.6. Dotyczy to Unity w wersji 2018.4 i starszych (nowsze wersje Unity zawierają tylko .NET w wersji 4.6).
- Wybierz File > Build Settings (Plik > Ustawienia kompilacji). Upewnij się, że jako bieżąca platforma jest wybrany Android.
- Kliknij przycisk Ustawienia odtwarzacza.
- W sekcji Other Settings (Inne ustawienia) znajdź Scripting Runtime Version (Wersja środowiska wykonawczego skryptów) i wybierz .NET 4.6.
Wtyczka jest dostarczana jako pakiet Unity, który możesz zaimportować do projektu.
Kliknij Assets > Import Package > Custom Package (Komponenty > Importuj pakiet > Pakiet niestandardowy) i wybierz pobrany plik .unitypackage.
Android Performance Tuner w wersji 1.5.1 lub nowszej z Unity 2017.
Korzystanie z narzędzia Android Performance Tuner w wersji 1.5.1 lub nowszej z Unity 2017 wymaga wykonania tych dodatkowych czynności podczas importowania wtyczki:
- Otwórz folder Assets/AndroidPerformanceTuner/Editor.
- Kliknij plik Google.Android.PerformanceTuner.Editor, aby otworzyć go w Inspector.
- Kliknij brakujący plik referencyjny, a następnie kliknij -, aby go usunąć.
Kliknij przycisk Zastosuj.
Rysunek 1. Brak odwołania do zestawu. Otwórz folder Assets/AndroidPerformanceTuner/Runtime.
Kliknij plik Google.Android.PerformanceTuner, aby otworzyć go w Inspektorze.
Powtórz krok 3, aby usunąć 2 brakujące odwołania do zestawu.
Uruchom ponownie Unity.
Kliknij Window > AndroidPerformanceTuner > Setup (Okno > AndroidPerformanceTuner > Konfiguracja) i sprawdź, czy nie wyświetlają się żadne błędy.
Ponowne importowanie wtyczki po usunięciu
Jeśli ponownie importujesz wtyczkę po usunięciu jej z projektu, najpierw usuń ANDROID_PERFORMANCE_TUNER_UTILITIES z Ustawienia odtwarzacza > Symbole definiujące skrypty.
Konfigurowanie wtyczki
Aby skonfigurować wtyczkę, wykonaj te czynności:
W przypadku Unity w wersji 2019.3.14 lub nowszej:
Włącz bibliotekę Android Frame Pacing. Android Performance Tuner będzie używać tej biblioteki do pomiaru wydajności gry, w tym do bardziej szczegółowych pomiarów niż te, które raportuje Unity.
Wybierz File > Build Settings (Plik > Ustawienia kompilacji) i kliknij przycisk Player Settings (Ustawienia odtwarzacza). W sekcji Rozdzielczość i prezentacja zaznacz pole wyboru Zoptymalizowane tempo klatek.
Synchronizuj renderowanie klatek z pionowymi odstępami.
W ustawieniach odtwarzacza wybierz kartę Quality (Jakość) i znajdź menu VSync Count (Liczba synchronizacji pionowych). Wybierz dowolną opcję (oprócz Nie synchronizuj). Opcje inne niż Nie synchronizuj umożliwiają dokładniejsze pomiary w połączeniu z biblioteką Android Frame Pacing.
(W przypadku wersji Unity starszych niż 2019) Ustaw system kompilacji na Gradle. Wybierz File > Build Settings (Plik > Ustawienia kompilacji). Znajdź Build System (System kompilacji) i wybierz Gradle.
Dodaj uprawnienia dostępu do internetu. W sekcji Inne ustawienia znajdź Dostęp do internetu i wybierz Wymagaj.
Wpisz klucz interfejsu API. Po zainstalowaniu wtyczki możesz ją otworzyć, wybierając Window > Android Performance Tuner > Setup (Okno > Android Performance Tuner > Konfiguracja). W tym oknie wybierz kartę Ustawienia i wpisz klucz interfejsu API z projektu Google Cloud w polu Klucz interfejsu API.
Rysunek 2. Karta Ustawienia we wtyczce