定义注解、保真度参数和质量等级

本文档介绍了如何在 Unity 项目中设置注解、保真度参数和质量等级。

注解

注解提供在记录计时时游戏正在执行的操作的上下文信息。

默认注解

该插件为您定义了一个默认注解

• Scene：包含当前正在播放的场景的标识符；在您的大部分关卡都映射到项目中的单个场景的情况下很有用

要在界面中查看这些注解，请执行以下操作：

1. 选择 Google > Android Performance Tuner。

2. 选择注解参数 (Annotation parameters) 标签页，然后点击使用自定义参数 (Use custom parameters)。

   图 1. 插件中的注解参数 (Annotation parameters) 标签页

定义和使用自定义注解

要创建自定义注解，请执行以下操作：

1. 在注解参数 (Annotation parameters) 标签页中，点击 + 按钮以创建新注解。

2. 在新行中，点击类型 (Type) 列，然后选择添加或更新枚举 (Add or update enum)。例如，您可以为游戏难度创建枚举。

3. 指定枚举值后，点击添加新枚举 (Add New Enum) 按钮。

   图 2. 添加新枚举

4. 在类型 (Type) 列中选择新类型。在参数名称 (Parameter name) 列中输入参数的名称。

   图 3. 选择新枚举

5. 点击应用 (Apply) 按钮，让插件重新生成协议缓冲区文件和类。

要在游戏中设置此注解，请调用 SetCurrentAnnotation()

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

定义保真度参数和质量等级

保真度参数反映了游戏的性能和图形设置。质量等级用于注解会话，以便您确定设备是否以过高的质量等级（导致性能降低）或过低的质量等级（导致不必要的保真度降低）运行。

您的游戏可能已经具有不同的保真度参数，例如：

• 阴影质量
• 纹理分辨率
• 粒子效果质量

这些参数可以重新分组为质量等级（例如“低”、“中”和“高”）。为了让 Android Performance Tuner 正确报告这些参数，并在 Google Play 管理中心进行分析和可视化，您必须将这些参数公开给插件。在保真度参数 (Fidelity parameters) 标签页中添加您的保真度参数。

图 4. 插件中的保真度参数 (Fidelity parameters) 标签页

选择使用自定义参数 (Use custom parameters)，然后定义一组参数。每个参数都有一种类型，就像注解一样。

使用 SetFidelityParameters() 函数在游戏中适当地设置保真度参数

tuner.SetFidelityParameters(new FidelityParams
{
    ParticleDetails = 1.0f,
    ShadowQuality = ShadowQuality.High,
    TextureResolution = 2048,
});

接下来，定义不同的质量等级，这些等级将用于在 Google Play 管理中心中对数据进行分组，并为您提供更好的洞察力。在质量等级 (Quality levels) 标签页中添加您的质量等级。

点击添加等级 (Add Level) 按钮以添加您的第一个等级。定义多个遵循趋势的等级。例如，定义从最低质量等级到最高质量等级的等级。

图 5. 插件中的质量等级 (Quality levels) 标签页