集成插件

本页介绍了如何下载、导入和配置适用于 Android Performance Tuner 的 Unity 插件。

要求

如需在游戏中使用此插件,请使用受支持的 Unity 版本:

  • Unity 2017.4 或更高版本以及 .NET 4.6 版
  • 如需使用 APK 扩展文件,必须使用 Unity 2018.2
  • 为改善帧同步和 GPU 测量,需要使用 Unity 2019.3.14 或更高版本。
  • 若要支持 Addressables 场景,需要使用 Unity 2019.3 或更高版本以及 Addressables 软件包 1.19.4 或更高版本。

下载插件

GitHub 代码库下载此插件。选择 .unitypackage 文件下载。

导入插件

在导入插件之前,请确保您的项目使用的是 .NET 4.6 版。这适用于 Unity 2018.4 及更早版本(Unity 的后续版本仅包含 .NET 4.6 版)。

  1. 依次选择 File > Build Settings。确保选择 Android 作为当前平台。
  2. 点击 Player Settings 按钮。
  3. Other Settings 下,找到 Scripting Runtime Version 并选择 .NET 4.6

此插件可作为 Unity 软件包提供,您可以在项目中导入该软件包。依次选择 Assets > Import Package > Custom Package,然后选择您下载的 .unitypackage 文件。

将 Android Performance Tuner 版本 1.5.1 或更高版本Unity 2017 搭配使用

若要将 Android Performance Tuner 1.5.1 或更高版本Unity 2017 搭配使用,在导入该插件时需要执行以下额外步骤:

  1. 进入 Assets/AndroidPerformanceTuner/Editor 文件夹。
  2. 点击 Google.Android.PerformanceTuner.Editor 文件,以在 Inspector 中将其打开。
  3. 点击缺失的汇编引用,然后点击 - 以将其移除。
  4. 点击 Apply 按钮。

    图 1. 缺失的汇编引用。

  5. 进入 Assets/AndroidPerformanceTuner/Runtime 文件夹。

  6. 点击 Google.Android.PerformanceTuner 文件,以在 Inspector 中将其打开。

  7. 重复第 3 步,移除两个缺失的汇编引用。

  8. 重启 Unity。

  9. 依次前往 Window > AndroidPerformanceTuner > Setup,确认是否未显示任何错误。

删除插件后重新导入

如果您从项目中移除了该插件,然后想重新导入,请先从 Player Settings > Scripting Define Symbols 中移除 ANDROID_PERFORMANCE_TUNER_UTILITIES

配置插件

如需配置此插件,请执行以下操作:

  1. 对于 Unity 2019.3.14 或更高版本:

    • 启用 Android Frame Pacing 库。Android Performance Tuner 将使用此库衡量游戏性能,包括比 Unity 单方面报告更深入的测量结果。

      依次选择 File > Build Settings,然后点击 Player Settings 按钮。在 Resolution and Presentation 下,选中 Optimized Frame Pacing 复选框。

    • 同步帧渲染与垂直消隐。

      在“Player Settings”中,选择 Quality 标签页并找到 VSync Count 菜单。使用任意选项(Don't Sync 除外)。选择除 Don't Sync 之外的选项,可通过结合使用 Android Frame Pacing 库实现更准确的测量结果。

  2. (对于 2019 之前的 Unity 版本)将构建系统设置为 Gradle。依次选择 File > Build Settings。找到 Build System,然后选择 Gradle

  3. 添加互联网访问权限。在 Other Settings 下,找到 Internet Access,然后选择 Require

  4. 输入您的 API 密钥。安装此插件后,您可以通过 Window > Android Performance Tuner 菜单进入此插件。在此对话框中,选择 Settings 标签页,然后将从 Google Cloud 项目中获取的 API 密钥输入 API key 字段。

    图 2. 插件中的“Settings”标签页