На этой странице описано, как настроить Android Performance Tuner для включения сцен Addressables в Unity.
Адресные устройства позволяют разработчикам динамически загружать контент во время выполнения. Сюда могут относиться сцены, которых нет в настройках сборки Unity при сборке .apk. До версии Android Performance Tuner 1.5.1 эти сцены не распознавались Android Performance Tuner и их нельзя было проверить в Play Console.
Требования
Поддержка сцен Addressables имеет следующие требования:
- Android Performance Tuner 1.5.1 или более поздней версии
- Unity 2019.3 или новее
- Пакет адресных устройств 1.19.4 или новее
Добавить сцены с адресацией
Чтобы Android Performance Tuner распознавал ваши сцены Addressables, выполните следующие действия:
Когда вы будете готовы протестировать свое приложение, перейдите в «Окно» > «Android Performance Tuner» > «Настройка» и откройте вкладку «Настройки адресных устройств» .
Рисунок 1. Окно настроек адресных устройств.Нажмите кнопку «Обновить сцены адресных объектов» .
По умолчанию все сцены, содержащиеся в AddressableAssetSettingsDefaultObject , включены в Android Performance Tuner. В окне теперь отображается список всех найденных сцен вместе с их значениями, сохраненными в файле прототипа.
Рис. 2. Сцены адресных объектов, перечисленные Android Performance Tuner.
Чтобы изменить объект адресных настроек, из которого извлекаются сцены:
Перейдите в папку Assets/AndroidPerformanceTuner_gen/Runtime/Resources и откройте объект сценария SetupConfig в Инспекторе.
Вставьте путь к вашему пользовательскому объекту настроек в поле «Путь к объекту настроек адресных устройств» , включая имя файла.
Мы рекомендуем вам обновить сцены Addressables, когда макет вашей сцены находится в полуфинальной стадии, чтобы избежать проблем обратной совместимости.
Android Performance Tuner собирает данные только для сцен, которые присутствовали в файле .apk, загруженном в Play Console.
Сброс сцен адресных устройств
Вы можете сбросить сцены Addressables, нажав «Сбросить сцены Addressables» на вкладке «Настройки Addressables» . Однако это нарушает совместимость с опубликованной в данный момент версией приложения.
Динамическое обновление объекта SetupConfig в приложении без публикации новой версии приведет к ошибкам в Play Console, поскольку связи сцены и значения не будут сохранены.
Настройка сцен Addressables в аннотациях
Если вы используете аннотации по умолчанию, Android Performance Tuner автоматически устанавливает правильную сцену. Если вы используете пользовательские аннотации, вызовите ConvertAddressableScenePathToAPTSceneIndex() :
tuner.SetCurrentAnnotation(new Annotation
{
Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
Difficulty = Difficulty.Medium
});