В этом руководстве описано, как использовать плагин 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…