分析工具参考

分析工具（Profiler） 是对虚幻引擎 3 中的 StatsViewer 工具的替代，它收集并跟踪游戏数据，监控游戏性能。此数据可用于确定游戏中故障和速度减慢的原因。

如你对性能调试了解不多，请先查阅 性能及分析 文档，其中包含的技巧将指导你对游戏性能进行监控。

启用分析工具

启用 分析工具 并收集数据的方法有两种：

1. 即时连接
   • 使用参数 -\messaging 运行游戏（如：UE4Editor-Win64-Debug.exe -messaging）。
   • 使用参数 -\messaging 运行 UFE（如：UnrealFrontend-Win64-Debug.exe -messaging）。
   • 从 Window 菜单栏的 Developer Tools 部分选择 Session Frontend，然后选择 Profiler 标签。
2. 加载之前采集的数据
   • 按下 Profiler 标签工具栏上的 Load 按钮并选择一个 .ue4stats 文件。
   • 将来自浏览器或其他文件管理器的 stats 文件放入 Profiler 窗口。

也可从 C:\Program Files\Unreal Engine\4.3\Engine\Binaries\Win64 文件夹运行单独的 UnrealFrontEnd.exe，以便访问 Session FrontEnd 和 Profiler 标签。（注意：上述路径中的版本号与你实际的版本号可能不一致）。

分析工具窗口

下图即为 Profiler 窗口和 UI 组件：

点击图片查看全图。

1. 连接会话 和 会话信息 窗口 - 用作获取 stats 数据的会话。
2. 主工具栏 窗口 - 包含基础整体功能。
3. 完整数据图表 窗口 - 包含 stats 图像展示的全貌。
4. 数据图表 窗口 - stats 图像展示。
5. 过滤 和 预设 窗口 - 包含所有 stats 和群组（用户可对这些 stats 和群组进行过滤和排序）。
6. 事件图表 窗口 - 以事件图表显示所选帧。

主工具栏

以下是 主工具栏 上每个操作的描述：

数据采集 文件保存在下列路径中 ...\UE4\Engine\Programs\UnrealFrontend\Saved\Profiling\UnrealStats\Received...

过滤和预设

以下是 主工具栏 上每个操作的描述：

如何追踪 Stats

追踪 stats 的方法有三种：

1. 双击 选中的 stat，将其添加到 数据图表视图 的显示中（或从显示中移除）。
2. 将其从 Stats/群组窗口 拖放 到 数据图表视图 中（如下图所示）。
3. 从 数据图表视图 进行 拖放。

正在被追踪的 stat 以不同颜色显示，且名称旁带有“*”符号。

下列群组名后第二个括号中的数字代表群组正在被追踪的 stat 数量。

上图的 Audio 群组中存在 11 个项目，有 1 个正被追踪。

数据图表

数据图表 视图显示所有被追踪的 stats。在 stats 的文本前按下（X）按钮即可停止追踪 stat。

Stat 的文本包含下列信息，详解如下：

1. （群组名） - Stat 的群组名。
2. Stat 名称 - Stat 的名称。
3. 实际值 - Stat 的实际值。
4. 最小值 - 基于整体采集的最小值。
5. 平均值 - 基于整体采集的平均值。
6. 最大值 - 基于整体采集的最大值。
7. 调用 - 此 stat 调用的帧数百分比（仅限分层数据）。
8. 最小值 - 基于整体采集对此 stat 的最小调用数（仅限分层数据）。
9. 平均值 - 基于整体采集对此 stat 的平均调用数（仅限分层数据）。
10. 最大值 - 基于整体采集对此 stat 的最大调用数（仅限分层数据）。

以“仅限分层数据”表示的数值仅限显示分层数据。

数据图表 轴的解释如下：

• 下 - 显示从初始的时间，自 0.0 开始。
• 下 - 显示从初始的帧数量，自 0.0 开始。
• 左 - 基于缩放比例显示关于时间的自适应信息（以毫秒为单位）。使用 鼠标滚轮，有三种预设轴，代表游戏 30、60、100 FPS 的运行速度，每个均以不同颜色显示。
• 右 - 显示其他 stats（如浮点或内存）的自适应信息。此轴的大小与左轴不同，因浮点或内存数值通常大于时间相关的 stats。

在 数据图表 窗口中 单击右键 将出现带额外选项的快捷菜单：

• View Mode - 暂时只支持 Index based 模式（Time based 仅在 分析工具 的多会话模式中可用，尚处于实验阶段，默认为禁用）。
• Select All Frames - 此选项可选中所有帧并更新 事件图表视图。
• Live Preview - 此选项与主工具栏中的选项相同。

事件图表

事件图表视图 由以下内容组成：

1. 标题 - 显示当前连接的会话名称或当前加载的 stats 文件。
2. 事件图表工具栏 - 用于 事件图表 过滤和其他功能。
3. 函数细节 - 所选事件/函数的细节视图。
4. 主事件图表 - 所选单帧或多帧的层级视图。

事件图表工具栏

以下是 事件图表工具栏 上每个操作的描述：

函数细节

函数细节 显示用户所选函数/事件和执行所选函数/事件的调用函数之间的关系。这些关系通过按钮展示（这些按钮根据百分比数值相应缩放）。

用户可轻松地从上之下跟踪事件，寻找降低性能的因素。函数细节 视图以两种方式与 主事件图表 同步，因此选中一个新函数将同时选中 主事件图表 中的函数。

Function Details 由下列元素组成：

• 调用函数 - 显示对所选函数进行调用的函数。控件尺寸基于百分比值缩放。
• 当前函数 - 在 主事件图表 事件中当前选中的事件/函数。
• 被调用函数 - 被所选函数调用的函数。控件尺寸基于百分比值缩放。
  • - 显示此图标时，事件已在 主事件图表 窗口中剔除（下一部分中有更多详情）。
  • - 显示此图标时，事件已在 主事件图表 窗口中被过滤掉（下一部分中有更多详情）。

在 图标上悬停鼠标即可显示项目的额外信息。

主事件图表

主事件图表 窗口显示事件执行路径。一个根不存在，但每个线程均拥有其自身的开始事件。它通常由线程的名称或线程的数字 ID 表明，例如“[0x1234]”。

利用 主事件图表 可对诸多其他函数进行过滤和剔除。这些函数列举在下方。在 主事件图表 窗口中 单击右键 并从出现的快捷菜单中选择所需操作后即可进行访问。