Definiowanie adnotacji, parametrów wierności i poziomów jakości

Z tego dokumentu dowiesz się, jak ustawić adnotacje, parametry wierności i poziomy jakości w projekcie Unity.

Adnotacje

Adnotacje zawierają informacje kontekstowe o tym, co robi gra, gdy rejestrowany jest tick.

Domyślne adnotacje

Wtyczka definiuje jedną domyślną adnotację:

  • Scene: zawiera identyfikator aktualnie odtwarzanej sceny; przydatne w przypadkach, gdy większość poziomów jest mapowana na jedną scenę w projekcie.

Aby wyświetlić te adnotacje w interfejsie:

  1. Kliknij Google > Android Performance Tuner.
  2. Kliknij kartę Parametry adnotacji, a następnie Użyj parametrów niestandardowych.

    Karta parametrów adnotacji we wtyczce Unity narzędzia Android Performance Tuner z widocznym niestandardowym parametrem sceny
    Rysunek 1. Parametry adnotacji we wtyczce

Definiowanie i używanie adnotacji niestandardowej

Aby utworzyć adnotację niestandardową:

  1. Na karcie Parametry adnotacji kliknij przycisk +, aby utworzyć nową adnotację.
  2. W nowym wierszu kliknij kolumnę Typ i wybierz Dodaj lub zaktualizuj typ wyliczeniowy. Możesz na przykład utworzyć wyliczenie dla poziomu trudności gry.

  3. Po określeniu wartości typu wyliczeniowego kliknij przycisk Dodaj nowy typ wyliczeniowy.

    Okno nowego typu wyliczeniowego dla poziomu trudności z wartościami ŁATWY, ŚREDNI i TRUDNY
    Rysunek 2. Dodaj nowy typ wyliczeniowy
  4. Wybierz nowy typ w kolumnie Typ. Wpisz nazwę parametru w kolumnie Nazwa parametru.

    Karta parametrów adnotacji z niestandardowym parametrem typu wyliczeniowego Difficulty o nazwie game-difficulty
    Rysunek 3. Wybierz nowy typ wyliczeniowy
  5. Kliknij przycisk Zastosuj, aby umożliwić wtyczce ponowne wygenerowanie plików i klas bufora protokołu.

Aby ustawić tę adnotację w grze, wywołaj SetCurrentAnnotation:

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = Scene.AssetsScenesMainmenu,
    Difficulty = Difficulty.Medium
});

Definiowanie parametrów wierności i poziomów jakości

Parametry wierności odzwierciedlają wydajność i ustawienia graficzne gry. Poziomy jakości służą do dodawania adnotacji do sesji, dzięki czemu możesz określić, czy urządzenia działają na zbyt wysokim poziomie jakości (co powoduje obniżenie wydajności) czy na zbyt niskim (co powoduje niepotrzebne obniżenie wierności).

Twoja gra może już mieć różne parametry wierności, takie jak:

  • Jakość cieni
  • Rozdzielczość tekstury
  • Jakość efektów cząstek

Te parametry można pogrupować według poziomów jakości (np. „niska”, „średnia” i „wysoka”). Aby te parametry były prawidłowo raportowane przez Android Performance Tuner, a następnie analizowane i wizualizowane w Konsoli Google Play, musisz udostępnić je wtyczce. Dodaj parametry wierności na karcie Parametry wierności.

Karta Parametry wierności z niestandardowymi parametrami texture_resolution, shadow_quality i particle_details
Rysunek 4. Karta Parametry wierności we wtyczce

Kliknij Użyj parametrów niestandardowych, a następnie zdefiniuj zestaw parametrów. Każdy parametr ma typ, np. adnotacje.

Użyj funkcji SetFidelityParameters, aby ustawić parametry wierności odpowiednio do gry:

tuner.SetFidelityParameters(new FidelityParams
{
    ParticleDetails = 1.0f,
    ShadowQuality = ShadowQuality.High,
    TextureResolution = 2048,
});

Następnie zdefiniuj różne poziomy jakości, które będą używane do grupowania danych w Konsoli Google Play i zapewnią Ci lepsze statystyki. Dodaj poziomy jakości na karcie Poziomy jakości.

Aby dodać pierwszy poziom, kliknij przycisk Dodaj poziom. Zdefiniuj wiele poziomów, które podążają za trendem. Możesz na przykład zdefiniować poziomy od najniższego do najwyższego.

Karta Poziomy jakości przedstawiająca 3 poziomy wierności z coraz wyższą rozdzielczością tekstur, szczegółowością cząsteczek i jakością cieni
Rysunek 5. Poziomy jakości we wtyczce