Включить сцены Addressables

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

Адресные объекты позволяют разработчикам динамически загружать контент во время выполнения. Это может включать сцены, отсутствующие в настройках сборки Unity на момент сборки .apk-файла. До версии Android Performance Tuner 1.5.1 эти сцены не распознавались Android Performance Tuner и не могли быть просмотрены в Play Console.

Требования

Поддержка адресуемых сцен имеет следующие требования:

• Android Performance Tuner 1.5.1 или более поздней версии
• Unity 2019.3 или более поздняя версия
• Пакет Addressables 1.19.4 или более поздней версии

Добавить адресуемые сцены

Чтобы Android Performance Tuner распознавал сцены Addressables, выполните следующие действия:

1. Когда вы будете готовы протестировать свое приложение, перейдите в Окно > Android Performance Tuner > Настройка и откройте вкладку Настройки адресных объектов .

   Рисунок 1. Окно настроек адресуемых объектов.

2. Нажмите кнопку Обновить адресуемые сцены .

По умолчанию все сцены, содержащиеся в AddressableAssetSettingsDefaultObject , включены в Android Performance Tuner. В окне теперь отображается список всех найденных сцен вместе с их значениями, сохранёнными в proto-файле.

Рисунок 2. Адресуемые сцены, перечисленные Android Performance Tuner.

Чтобы изменить объект адресуемых настроек, из которого извлекаются сцены:

1. Перейдите в папку Assets/AndroidPerformanceTuner_gen/Runtime/Resources и откройте скриптовый объект SetupConfig в Инспекторе.

2. Введите путь к пользовательскому объекту настроек в поле Путь к адресуемому объекту настроек , включая имя файла.

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

Android Performance Tuner собирает данные только для тех сцен, которые присутствовали в файле .apk, загруженном в Play Console.

Сброс адресуемых сцен

Вы можете сбросить сцены Addressables, нажав «Сбросить сцены Addressables» на вкладке «Настройки Addressables» . Однако это нарушит совместимость с текущей опубликованной версией приложения.

Динамическое обновление объекта SetupConfig в приложении без публикации нового выпуска приведет к ошибкам в Play Console, поскольку связи между сценой и значениями не будут сохранены.

Настройка адресуемых сцен в аннотациях

Если вы используете аннотации по умолчанию, Android Performance Tuner автоматически устанавливает правильную сцену. Если вы используете пользовательские аннотации, вызовите ConvertAddressableScenePathToAPTSceneIndex() :

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