Animation Insights

Animation Insights 是 虚幻引擎 中的一款插件，旨在通过展示跟踪数据来实时剖析和观察项目的游戏和动画系统性能。通过在PIE（Play in Editor）模拟过程中记录跟踪信息，你可以查找导致项目为何实现既定帧率的性能瓶颈，从而寻找优化机会。

Animation Insights插件包含一张性能图表，可用于观察游戏和动画系统的性能、动画状态和实时的行为更新（例如随时间变化的变量和混合值）。通过跟踪你的项目数据，Animation Insights将跟踪数据值的变化，并将这些信息绘制成彩色编码的轨道，你可以用它来调试和优化你的项目。

你可以为以下数据类型开启追踪记录，从而观察项目数据的变化：

• 动画 姿势（Poses）、曲线（Curves），混合权重（Blend Weights），蒙太奇（Montages），动画通知（Anim Notifies）以及基于演示效果的动画图表（Anim Graph）视图（该视图使用实时更新取代了 showdebug动画 系统）。

借助跟踪数据过滤功能，你可以在所有写入的记录数据中，筛选出特定类型的跟踪数据。你也可以使用来源过滤，选择只查看某一个游戏对象相关的追踪数据。

使用条件

• 你需要启用以下插件。在 菜单栏 中找到 编辑（Edit） > 插件（Plugins） ，找到在 Insights 分段下列出的 Animation Insights，Insights数据源过滤器 和 Trace Data过滤 插件，或使用 搜索栏 直接搜索。启用插件并重启编辑器。

使用Animation Insights

安装插件后，打开 Animation Insights 和 Trace Data过滤 面板。在 菜单栏 中找到 工具 > 性能分析 并同时选择 Animation Insights 和 Trace Data Filtering 选项。

你可以启用 Trace Data Filtering 面板中的 Trace Channel Filters，它会在 Animation Insights 面板的图表中实时填充相应的数据。

Animation Insights会将此类数据储保存在计算机应用数据的 .utrace 文件中，你可以使用Unreal Insights Application访问这些跟踪文件。你可以在 菜单栏 中点击 工具 > 启动Unreal Insights，在编辑器中启动它。

请确保只有在需要调式或优化性能时才启用动画跟踪功能，否则生成的 .utrace 文件可能会占用大量存储空间。

跟踪数据过滤

打开跟踪数据过滤（Trace Data Filtering）面板后，你可以单独显示或隐藏某个跟踪通道（Trace Channel）的状态，实时记录或忽略特定的数据类型。无论你是否运行编辑器，这些数据都会被跟踪并记录在Animation Insights面板中，并被渲染成图表，让你了解一段时间内的数据变化。

启用多少通道？将它们启用多久？这些选择很重要。通道过滤会对你的项目性能开销产生影响，并且会影响你保存的 .utrace 文件的大小，从而决定你能节省多少计算机磁盘空间。

在选中了需要的跟踪通道后，你可以点击 过滤器预设（Filter Preset） 下拉菜单，选择 保存用户预设（Save User Preset） ，将你选中的跟踪通道组合保存为一组过滤器预设。

在设置完 预设（Preset） 后，你可以在跟踪通道列表标题中点击 预设按钮（Preset Buttons） ，快速启用某个预设。

默认情况下，系统预置了一个 动画（Animation） 过滤器，它会打开与项目中动画数据关系最大的跟踪通道。动画预设过滤器包含 对象（Object）、动画（Animation） 和 帧（Frame） 跟踪。你可以选择 过滤器预设 下拉菜单，点击 动画 来启用动画预设过滤器。

有关跟踪数据调试和优化的更多信息，请参阅文档Unreal Insights。

过滤跟踪来源

你可以使用跟踪源过滤（Trace Source filtering）来选择让哪些游戏对象输出跟踪数据。在调试或分析某个大型项目时，这可能会特别有用，因为某个关卡可能会有大量 Actor 和 组件。通过过滤跟踪来源，你可以选择只记录哪些Actor和组件的数据，组织你的输出信息，限制性能开销，并减少数据记录量以节省你的计算机磁盘空间。

打开 跟踪源过滤 窗口， 选择Animation Insights面板工具栏中的 源过滤（Source Filter）。

类过滤器

在"跟踪来源过滤（Trace Source Filtering）"面板的 类过滤器 （Class Filters）分段中，你可以基于项目中的 蓝图类 创建过滤器，从而只记录被过滤出的类的数据。要新建类过滤器，请在类过滤器分段中点击（+） 添加过滤器。然后，选择你想记录哪些蓝图或游戏对象的数据。新建的过滤器现在会出现在类过滤器分段中。

创建完过滤器后，你还可以左键点击过滤器，选择 包含派生类（Include derived classes），从而记录所有从基类游戏对象或蓝图类派生出的游戏对象的跟踪数据。

你也可以选择 移除过滤器（Remove Filter） 来删除过滤器。

用户过滤器

你还能创建自定义过滤器蓝图（filter blueprints）来记录跟踪数据。在 用户过滤器 （User Filters）分段，选择（+）添加过滤器，并在项目文件中选择蓝图保存位置。为新蓝图起一个 名字，并选择 保存。这将创建一个新的蓝图，用来建立自定义的数据跟踪收集逻辑。

创建自定义源过滤器蓝图后，在 跟踪来源过滤器 面板的 用户过滤器 分段，你可以 右键点击 过滤器，调出一个上下文菜单，定义过滤器如何用于记录跟踪数据。

下表列出了上下文菜单中的选项及其使用说明：

世界过滤器

你可以使用 世界过滤器（ World Filter） 分段，在项目的不同关卡中设置跟踪背景。你让跟踪只在项目的 PIE（Play in Editor）模拟期间、实际游戏操作期间，或者编辑器环境中发生。你可以使用与 世界类型过滤 （Filter By World Type）属性相邻的按钮来切换在不同背景下跟踪。

你还可以让跟踪在多人游戏联网项目的网络操作中发生。借助 世界网络模式过滤（Filter by World Net Mode） 属性，你可以为项目的 客户端、服务器 和 独立运行版本（Standalone） 等不同状态来启用跟踪记录。

关于虚幻引擎中的跟踪记录世界过滤器的更多信息，请查阅文件通道过滤。

使用Animation Insights

Animation Insights扩展了之前的的 showdebug 动画功能，可以显示内部动画运行时数据。可视化和信息分析能力使用户能够定位并识别潜在的动画错误来源或性能问题。

默认情况下， showdebug 的动画功能很有限，因为 showdebug 动画系统只能向屏幕输出文本日志。借助Animation Insights，用户可以将包含异常动画行为的一段范围内的帧记录下来，然后在回顾日志数据时，同时回放记录下的这段动画或游戏内容。

在启用跟踪源过滤器数组后，你可以运行你的项目来记录动画数据随时间的变化。数据被编成"轨迹"（Tracks），在Animation Insights面板的时间线上水平分层。每个轨道显示一组独特的数据，只有在启用相应的跟踪源过滤器时才会出现。

你可以使用Animation Insights工具栏菜单中的"所有轨道（All Tracks）"按钮来单独设置各个轨道的可视性。

轨道检查

你可以使用Animation Insights图表，直观查看各轨道中的数据在某段时间内的变化。轨道也可以通过调整视察方式来显示数值型数据。每个轨道都包含不同的数据，因此每个轨道的视察方式都与该轨道所监控的数据类型有关。你可以右键点击每个轨道左侧的轨道标题，选择上下文菜单中的扩展选项，来扩展轨道中包含的数据。

当你选中某一个扩展选项后，如 查看属性（View Properties） 或 查看此图表（View this Graph），会打开一个辅助面板，其中会包含轨道数据，显示内容与Animation Insights中时间线播放头（游标）的当前位置有关。

轨道种类

每个Animation Insights数据轨道都包含与之所包含的数据类型相关的背景数据，以及相关的数据扩展选项和属性。

下表列出了一些常见的Animation Insights轨道，并介绍了它们包含的数据：

Animation Insights快捷键说明

下文列出了你在使用Animation Insights面板时可供使用的热键和快捷键，方便你观察动画调试数据。