Zintegruj wtyczkę

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).

  1. Wybierz File > Build Settings (Plik > Ustawienia kompilacji). Upewnij się, że jako bieżąca platforma jest wybrany Android.
  2. Kliknij przycisk Ustawienia odtwarzacza.
  3. 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:

  1. Otwórz folder Assets/AndroidPerformanceTuner/Editor.
  2. Kliknij plik Google.Android.PerformanceTuner.Editor, aby otworzyć go w Inspector.
  3. Kliknij brakujący plik referencyjny, a następnie kliknij -, aby go usunąć.
  4. Kliknij przycisk Zastosuj.

    Inspektor Unity dla Google.Android.PerformanceTuner.Editor pokazujący brakujące odwołanie do zestawu
    Rysunek 1. Brak odwołania do zestawu.
  5. Otwórz folder Assets/AndroidPerformanceTuner/Runtime.

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

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

  8. Uruchom ponownie Unity.

  9. 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:

  1. 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.

  2. (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.

  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ą 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.

    Karta Ustawienia we wtyczce Unity narzędzia Android Performance Tuner z widocznym polem klucza interfejsu API
    Rysunek 2. Karta Ustawienia we wtyczce