包含 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 场景，请执行以下操作：

1. 准备好测试你的应用后，转到 **窗口 > Android 性能调节器 > 设置** 并打开 **Addressables 设置** 选项卡。

   **图 1.** Addressables 设置窗口。

2. 单击 **更新 Addressables 场景** 按钮。

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

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

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

1. 转到 **Assets/AndroidPerformanceTuner_gen/Runtime/Resources** 文件夹，并在检查器中打开 **SetupConfig** 可脚本化对象。

2. 在 **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
});