Интегрируйте плагин

На этой странице описано, как скачать, импортировать и настроить плагин Unity для Android Performance Tuner.

Требования

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

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

Скачайте плагин

Скачайте плагин из хранилища GitHub. Выберите скачивание файла .unitypackage.

Импортируйте плагин

Перед импортом плагина убедитесь, что в вашем проекте используется .NET версии 4.6. Это относится к Unity версии 2018.4 и более ранним (более поздние версии Unity содержат только .NET версии 4.6).

  1. Выберите File (Файл) > Build Settings (Настройки сборки). Убедитесь, что в качестве текущей платформы выбрана Android.
  2. Нажмите кнопку Настройки проигрывателя.
  3. В разделе Other Settings (Другие настройки) найдите Scripting Runtime Version (Версия среды выполнения скриптов) и выберите .NET 4.6.

Плагин предоставляется в виде пакета Unity, который можно импортировать в проект. Выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Пользовательский пакет) и укажите скачанный файл .unitypackage.

Android Performance Tuner версии 1.5.1 или более поздней с Unity 2017;

Если вы используете Android Performance Tuner версии 1.5.1 или более поздней с Unity 2017, при импорте плагина выполните следующие дополнительные действия:

  1. Перейдите в папку Assets/AndroidPerformanceTuner/Editor.
  2. Нажмите на файл Google.Android.PerformanceTuner.Editor, чтобы открыть его в окне Inspector (Инспектор).
  3. Нажмите на отсутствующую ссылку на сборку, а затем нажмите -, чтобы удалить ее.
  4. Нажмите кнопку Применить.

    Окно Unity Inspector для Google.Android.PerformanceTuner.Editor, в котором показана отсутствующая ссылка на сборку
    Рисунок 1. Отсутствует ссылка на сборку.
  5. Перейдите в папку Assets/AndroidPerformanceTuner/Runtime.

  6. Нажмите на файл Google.Android.PerformanceTuner, чтобы открыть его в окне Inspector.

  7. Повторите шаг 3, чтобы удалить две отсутствующие ссылки на сборку.

  8. Перезапустите Unity.

  9. Перейдите в раздел Window (Окно) > AndroidPerformanceTuner > Setup (Настройка) и убедитесь, что ошибок нет.

Повторный импорт плагина после удаления

Если вы повторно импортируете плагин после его удаления из проекта, сначала удалите ANDROID_PERFORMANCE_TUNER_UTILITIES из раздела Player Settings (Настройки проигрывателя) > Scripting Define Symbols (Символы определения скриптов).

Настройте плагин

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

  1. Для Unity версии 2019.3.14 или более поздней:

    • Включите библиотеку Android Frame Pacing. Android Performance Tuner будет использовать эту библиотеку для измерения производительности игры, включая более подробные показатели, чем те, которые сообщает Unity.

      Выберите File (Файл) > Build Settings (Настройки сборки) и нажмите кнопку Player Settings (Настройки проигрывателя). В разделе Resolution and Presentation (Разрешение и представление) установите флажок Optimized Frame Pacing (Оптимизированная частота кадров).

    • Синхронизируйте рендеринг кадров с вертикальными пробелами.

      В настройках проигрывателя выберите вкладку Quality (Качество) и найдите меню VSync Count (Количество VSync). Выберите любой вариант, кроме Не синхронизировать. Если выбрать любой вариант, кроме Не синхронизировать, то в сочетании с библиотекой Android Frame Pacing можно будет получать более точные данные.

  2. (Для версий Unity до 2019 года) Установите систему сборки Gradle. Выберите File (Файл) > Build Settings (Настройки сборки). Найдите Build System (Система сборки) и выберите Gradle.

  3. Добавьте разрешение на доступ к интернету. В разделе Другие настройки найдите пункт Доступ к интернету и выберите Требуется.

  4. Введите ключ API. После установки плагина вы можете открыть его, выбрав в меню Window (Окно) > Android Performance Tuner > Setup (Настройка). В этом диалоговом окне выберите вкладку Settings (Настройки) и введите ключ API из проекта Google Cloud в поле API key (Ключ API).

    Вкладка настроек в плагине Android Performance Tuner для Unity с полем для ключа API
    Рисунок 2. Вкладка "Настройки" в плагине