Обзор Android Performance Tuner (Unity)

В этом руководстве описано, как использовать плагин Unity для записи и загрузки данных о времени формирования кадра из Unity 2017.4 или более поздней версии.

Если вы используете игровой движок на C или C++, ознакомьтесь с руководством по нативным игровым движкам.

Фон

Важный компонент игрового процесса – производительность рендеринга. Эффективность отрисовки зависит от двух факторов:

  • Частота кадров – как часто отрисовывается кадр.
  • Настройки качества графики. Уровень точности, с которым представлен кадр, включая точность симуляции и графики.

Для игр хорошая производительность рендеринга определяется следующим образом:

  • Стабильная частота кадров (процент кадров, отрисовываемых с нужной частотой).
  • Отрисовка кадров с максимально возможной частотой при сохранении стабильности, обычно 30 или 60 кадр/с в зависимости от типа игры.
  • Максимальная детализация для пользователя с учетом размера и плотности экрана при достижении желаемой стабильной частоты кадров.

Библиотека Android Frame Pacing позволяет ограничить колебания времени формирования кадра и обеспечить стабильную частоту кадров в играх. Остальные колебания времени формирования кадра связаны с уровнем детализации в определенных сценах и графическими возможностями устройства. С помощью Android Performance Tuner вы можете определить, в какие моменты геймплея время формирования кадра больше или меньше целевого, и сопоставить эти проблемы и возможности со следующими факторами:

  • Настройки качества
  • определенные сцены в игре;
  • Определенные модели или характеристики устройств.

Запись и загрузка данных

Библиотека Tuning Fork использует одну из своих функций tick, которая вызывается для каждого кадра библиотекой Android Frame Pacing (или движком Unity для более ранних версий Unity, в которых библиотека Frame Pacing отсутствует). В библиотеке эта информация агрегируется в гистограммы, которые затем периодически загружаются в Google Play через конечную точку HTTP. Каждый тик записывается как связанный с тегом тика и аннотацией. Аннотации определяются с помощью плагина Unity.

Теги тиков

Тег тика указывает, откуда в кадре поступает тик. Это целое число, которое должно передаваться каждому вызову функции тика. Плагин Unity делает это автоматически. Если в настройках Unity для вашей игры включен параметр Optimized Frame Pacing (доступен в Unity версии 2019.3.14 или более поздней), Android Performance Tuner будет использовать информацию из библиотеки Android Frame Pacing для создания отчетов с расширенными показателями.

Аннотации

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

  • Текущий уровень игры.
  • Загружается определенная сцена.
  • На экране "большой босс"
  • Другая информация о состоянии игры.

Аннотации определяются в диалоговом окне, предоставляемом плагином Unity.

Для хранения аннотаций и параметров изображения библиотека Tuning Fork использует формат буфера протокола Google. Это четко определенный многоязычный протокол для расширяемых структурированных данных. Дополнительную информацию можно найти в документации по буферам протокола.

Параметры изображения

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

Дополнительная нагрузка на память и ЦП

Вся память, используемая библиотекой Tuning Fork, выделяется при инициализации, чтобы избежать неожиданностей во время игры. Размер данных зависит от количества тегов тиков, возможных аннотаций и интервалов в каждой гистограмме. Он равен произведению всех этих значений, умноженному на четыре байта для каждого интервала. Также есть две копии всех гистограмм, чтобы можно было отправлять их в режиме двойной буферизации.

Отправка происходит в отдельном потоке и не блокирует вызовы tick. Если подключение для загрузки недоступно, отправка ставится в очередь для последующей загрузки.

Вызов функции tick не требует больших вычислительных ресурсов: она просто вычисляет индекс в массиве сегментов гистограммы и увеличивает целочисленный счетчик.

Веб-запросы

Библиотека отправляет на конечную точку сервера два типа запросов:

  • Запрос generateTuningParameters при инициализации
  • Периодически во время игры отправляется запрос uploadTelemetry для передачи данных на сервер.

Офлайн-проигрыватели

Если при инициализации нет доступного подключения, запрос повторяется несколько раз с увеличивающимся временем задержки. Если при загрузке нет подключения, загрузка кешируется. Загруженные файлы хранятся во временном хранилище.

Требования

Чтобы использовать плагин в игре, установите поддерживаемую версию Unity:

  • Unity 2017.4 или более поздней версии и .NET 4.6.
  • Для использования файлов дополнений APK требуется Unity 2018.2
  • Для улучшения синхронизации кадров и измерений графического процессора требуется Unity версии 2019.3.14 или более поздней.
  • Для поддержки сцен Addressables требуется Unity 2019.3 или более поздней версии и пакет Addressables 1.19.4 или более поздней версии.

Как интегрировать Android Performance Tuner в Unity

Подробнее о том, как интегрировать Android Performance Tuner в Unity…