包含 Addressables 场景

此页面介绍如何配置 Android 性能调优器以在 Unity 中包含 Addressables 场景。

Addressables 允许开发人员在运行时动态加载内容。这可能包括在构建 .apk 时未出现在 Unity 构建设置中的场景。在 Android 性能调优器 1.5.1 之前，这些场景无法被 Android 性能调优器识别，并且无法在 Play Console 中进行检查。

要求

对 Addressables 场景的支持有以下要求

Android 性能调优器 1.5.1 或更高版本
Unity 2019.3 或更高版本
Addressables 包 1.19.4 或更高版本

添加 Addressables 场景

要使 Android 性能调优器识别您的 Addressables 场景，请执行以下操作

准备好测试您的应用程序后，转到 **窗口 > Android 性能调优器 > 设置**，然后打开 **Addressables 设置** 选项卡。

图 1. Addressables 设置窗口。
点击 **更新 Addressables 场景** 按钮。

默认情况下，包含在 AddressableAssetSettingsDefaultObject 中的所有场景都包含在 Android 性能调优器中。现在，该窗口将显示所有找到的场景的列表，以及它们在 proto 文件中保存的值。

图 2. Android 性能调优器列出的 Addressables 场景。

要更改从中提取场景的 Addressable 设置对象

转到 **Assets/AndroidPerformanceTuner_gen/Runtime/Resources** 文件夹，并在检查器中打开 **SetupConfig** 可脚本化对象。
在 **Addressables 设置对象路径** 字段中插入您自定义设置对象的路径，包括文件名。

我们建议您在场景布局半最终确定时更新 Addressables 场景，以避免向后兼容性问题。

Android 性能调优器仅收集已上传到 Play Console 的 .apk 文件中存在的场景的数据。

重置 Addressables 场景

您可以在 **Addressables 设置** 选项卡中点击 **重置 Addressables 场景** 来重置您的 Addressables 场景。但是，这会破坏与当前发布的应用程序版本的兼容性。

在未发布新版本的情况下动态更新应用程序中的 SetupConfig 对象会导致 Play Console 中出现错误，因为场景值关系不会保留。

在注释中设置 Addressables 场景

如果您使用的是默认注释，Android 性能调优器会自动设置正确的场景。如果您使用的是自定义注释，请调用 ConvertAddressableScenePathToAPTSceneIndex()

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