Как задать аннотации, параметры изображения и уровни качества

В этом документе описано, как задать аннотации, параметры изображения и уровни качества в проекте Unity.

Аннотации

Аннотации предоставляют контекстную информацию о том, что происходит в игре во время записи тика.

Аннотации по умолчанию

Плагин определяет одну аннотацию по умолчанию:

  • Scene. Идентификатор текущей сцены. Полезен, если большинство уровней сопоставлены с одной сценой в проекте.

Чтобы посмотреть эти аннотации в интерфейсе, выполните следующие действия:

  1. Выберите Google > Android Performance Tuner.
  2. Откройте вкладку Параметры аннотаций и нажмите Использовать специальные параметры.

    Вкладка параметров аннотаций в плагине Android Performance Tuner для Unity, на которой показан параметр пользовательской сцены
    Рисунок 1. Вкладка «Параметры аннотаций» в плагине

Как определить и использовать собственную аннотацию

Чтобы создать собственную заметку, выполните следующие действия:

  1. На вкладке Параметры аннотаций нажмите кнопку +, чтобы создать аннотацию.
  2. В новой строке нажмите на столбец Тип и выберите Добавить или обновить перечисление. Например, можно создать перечисление для уровней сложности игры.

  3. Указав значения перечисления, нажмите кнопку Add New Enum (Добавить новое перечисление).

    Диалоговое окно с новым перечислением для уровней сложности: EASY, MEDIUM и HARD
    Рисунок 2. Добавьте новое перечисление.
  4. Выберите новый тип в столбце Тип. В столбце Название параметра укажите название параметра.

    Вкладка параметров аннотации, на которой показан специальный параметр перечисления сложности с названием game-difficulty
    Рисунок 3. Выберите новое перечисление.
  5. Нажмите кнопку Apply (Применить), чтобы плагин повторно создал файлы и классы буфера протокола.

Чтобы задать эту аннотацию в игре, вызовите SetCurrentAnnotation:

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

Как задать параметры изображения и уровни качества

Параметры изображения отражают производительность и графические настройки игры. Уровни качества используются для аннотирования сеансов, чтобы вы могли определить, работают ли устройства на слишком высоком уровне качества (что приводит к снижению производительности) или слишком низком (что приводит к неоправданному снижению точности).

В вашей игре уже могут быть разные параметры изображения, например:

  • Качество теней
  • Разрешение текстур
  • Качество эффектов частиц

Эти параметры можно перегруппировать по уровням качества (например, "низкое", "среднее" и "высокое"). Чтобы эти параметры правильно регистрировались Android Performance Tuner, а затем анализировались и визуализировались в Google Play Console, необходимо предоставить к ним доступ плагину. Добавьте параметры изображения на вкладке Параметры изображения.

Вкладка "Параметры изображения" с пользовательскими параметрами texture_resolution, shadow_quality и particle_details
Рисунок 4. Fidelity parameters (Параметры изображения) в плагине.

Выберите Использовать специальные параметры и задайте набор параметров. У каждого параметра есть тип, как у аннотаций.

Используйте функцию SetFidelityParameters, чтобы задать параметры изображения в игре:

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

Затем определите разные уровни качества, которые будут использоваться для группировки данных в Google Play Console и помогут вам получить более точные сведения. Добавьте уровни качества на вкладке Уровни качества.

Нажмите кнопку Добавить уровень. Определите несколько уровней, которые следуют тренду. Например, определите уровни от самого низкого до самого высокого.

Вкладка "Уровни качества" с тремя уровнями точности, на которых повышается разрешение текстур, детализация частиц и качество теней.
Рисунок 5. Quality levels (Уровни качества) в плагине.