ADPF Unreal Engine 插件

适用于 Unreal Engine 的 Android 动态性能框架 (ADPF) 插件可提供稳定的性能并防止温控降频。

您可以从 GitHub 下载该插件。

如何使用 ADPF Unreal Engine 插件

  1. 下载插件

  2. 将插件复制到项目插件文件夹中

  3. 在 Unreal 编辑器中启用 ADPF Unreal Engine 插件

  4. 重新启动 Unreal 编辑器

  5. 构建和烘焙游戏

启用 ADPF Unreal Engine 插件。
图 1. 启用 ADPF 虚幻引擎插件。

插件控制台配置

该插件具有以下虚幻引擎控制台变量,可让您在运行时更改插件选项:

CVar

有效值

默认值

说明

r.AndroidPerformanceEnabled

0、1

1

启用/停用 Android Performance 插件。该插件使用 Android 自适应 API 根据设备的散热状态调整游戏设置,并会根据需要调整 CPU。

0:关闭(已停用)

1:开启(启用)

r.AndroidPerformanceHintEnabled

0、1

1

启用/停用性能提示管理器。在受支持的 Android 设备上启用此设置,可实现最佳线程提升效果。

0:关闭(已停用)

1:开启(启用)

r.AndroidPerformanceChangeQualities

0、1、2

1

选择热状态如何调整游戏的保真度级别。

0:系统不会调整任何设置

1:根据热余量调整设置

2:根据热监听器调整设置

ADPF 虚幻引擎插件的工作原理

该插件会在每一帧调用 Monitor() 函数,并检查自上一次热检查以来经过的时间。如果至少已过去一秒,插件会读取当前温度并确定是否需要更改画质(例如,如果游戏受到热节流限制或接近热节流阈值),并相应地调整设置。

该插件还会向性能提示会话 API 报告目标帧时长和实际帧时长,并根据需要提高 CPU 频率或调整 CPU 调度。

ADPF Unreal Engine 插件流程图。
图 2. ADPF Unreal Engine 插件流程图。

如何根据热状态更改图形质量

该插件会根据热度 API 的反馈,使用 Unreal Engine 可伸缩性调整图形质量。Unreal Engine 可伸缩性有四个级别,从 3(最高质量)到 0(最低质量)。每个级别都映射到分辨率缩放、视图距离、抗锯齿、后处理和其他功能。

Unreal Engine 可伸缩性质量级别映射。
图 3. Unreal Engine 可伸缩性。

ADPF 有两种方法来确定设备的热状态:热余量和热状态。热余量可提供更精确的值;因此,该插件默认使用热余量,并停用热状态 API。

虚幻引擎可伸缩性会根据以下热值而变化:

热余量

  • < 0.75:质量等级 3
  • 0.75 至 0.85:质量等级 2
  • 0.85 至 0.95:质量等级 1
  • > 0.95:质量等级 0

热状态

  • 无:质量级别 3
  • 轻度:质量级别 2
  • 中等:质量级别 1
  • 严重和危急:质量级别 0

如需了解详情,请参阅 Thermal API。

性能提示 API

该插件有两种类型的性能提示会话:一种用于游戏线程,另一种用于渲染线程(渲染和 RHI 线程)。这两种类型的性能提示用于报告每个帧的实际时长和目标时长。当实际时长与目标时长不同时,系统会调整 CPU 频率并做出更好的调度选择。

如需了解详情,请参阅 Performance Hint API。

最佳做法

该插件可防止热节流,并通过其基本实现提供持续的目标 FPS。如需立即取得成效,请应用 ADPF 并使用默认的虚幻引擎可伸缩性级别。

不过,由于每款游戏各不相同,因此请针对每个参数(例如分辨率缩放、视图距离、抗锯齿、后期处理、阴影、纹理和效果)微调可伸缩性级别,以便 ADPF 能够为您的游戏充分提供动态性能。

以下是使用 ADPF Unreal 插件获得最佳效果的三个关键步骤:

  • 建立基准:在使用 ADPF 之前,请全面分析游戏的性能。这些数据将作为有价值的基准,供您在实现插件后进行比较。
    ADPF Unreal Engine 最佳实践。
    图 4.建立基准。
  • 利用 Unreal Scalability:尝试使用 Unreal Scalability,即使它只能带来适度的性能提升。这有助于轻松提升性能。
    ADPF Unreal Engine 最佳实践。
    图 5.利用 Unreal 的可伸缩性。
  • 优先考虑游戏内画面设置:优化游戏内画质级别。这些设置专为您的游戏内容量身定制,可确保更流畅的帧速率和更好的热管理。
    ADPF Unreal Engine 最佳实践。
    图 6. 优先考虑游戏内图形设置。