集成插件

本页面介绍了如何下载、导入和配置适用于 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 帧同步库。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 帧同步库进行更精确的测量。

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

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

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

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