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

本文档介绍了如何在 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) 标签页