虚幻引擎5文档已被迁移至 Epic开发者社区

Unreal Engine 4.26

Unreal Engine 4.27

Unreal Engine 5.0

Unreal Engine 5.1

Unreal Engine 5.2

Unreal Engine 5.3

> 测试并优化你的内容 > 性能及分析 > Unreal Insights > Animation Insights概述

Light Theme

Dark Theme

Animation Insights概述

Gameplay和动画性能分析工具——编辑器插件Animation Insights的概述。

Advanced

Choose your operating system:

Windows

macOS

Linux

参见

本页面的内容

设置
- 追踪数据过滤（Trace Data Filtering）
- 追踪源过滤（Trace Source Filtering）
  - 用户界面
Animation Insights
- 功能按钮参考

编辑器拥有 Animation Insights 插件，可显示gameplay状态和实时动画行为。用户可以使用Animation Insights记录追踪信息，使用以下功能显示动画行为：

通道过滤，选择写至记录数据集的追踪数据
源过滤，选择输出追踪数据的gameplay对象
姿势、曲线、混合权重、动画图表、蒙太奇和动画通知轨迹
包含实时更新的动画图表原理视图，用于替换 showdebug animation 系统。

设置

启用以下插件才能在编辑器中使用Animation Insights：

Animation Insights
Insights Data Source Filters
Trace Data Filtering

若编辑器中启用了此类插件，可在 编辑器（Editor） > 插件（Plugins） > 内置（Built-In） 中找到。否则在项目的 *.uproject 文件中启用：

{
    "FileVersion":3,
    "EngineAssociation":"4.25",
    "Category":"",
    "Description":"",
    "Plugins":[
        {
            "Name":"TraceSourceFilters",
            "Enabled": true
        },
        {
            "Name":"GameplayInsights",
            "Enabled": true
        },
        {
            "Name":"TraceDataFilters",
            "Enabled": true
        }
    ]
}

启用必要插件后，重启编辑器。

若从源构建编辑器，启用必要插件后需为项目编译并运行编辑器。

编辑器重启时，导航至 窗口（Window）> 开发人员工具（Developer Tools）> 分析（Profiling） ，打开 Animation Insights 和 追踪数据过滤（Trace Data Filtering） 。

将过滤器设为追踪数据（Trace Data）或追踪源（Trace Source）过滤后，即可在Animation Insights中记录和显示实时追踪数据。追踪将自动写入以下项目目录： <YourProject>/Saved/TraceSessions 。追踪会话会随时间推移而增大，因此必须积极监控和管理 *.utrace 文件。

追踪数据过滤（Trace Data Filtering）

追踪数据过滤（Trace Data Filtering）次选项卡起初会在内容浏览器旁边打开。可在追踪数据过滤（Trace Data Filtering）中设置追踪通道状态，在引擎运行时启用 追踪数据依据（trace data by） 。选择过滤器后，可选择 过滤器预设（Filter Presets）> 保存用户预设（Save User Preset） 。目前编辑器提供默认动画预设，目前可使用帧通道、对象通道和动画通道。

Unreal Insights介绍

通道过滤

启用通道后，数据将追踪至Animation Insights次选项卡中的时间轴。

选择性通道过滤可限制性能开销和磁盘空间。

在编辑器中运行（PIE）可查看场景中骨架网格体组件的动画数据追踪

追踪源过滤（Trace Source Filtering）

用户可使用追踪源过滤决定可输出追踪数据的gameplay对象。若开发大型游戏，给定场景中会有大量Actor和组件。使用追踪源（Trace Source）过滤可减少追踪数据记录量、限制开销并减少磁盘空间用量（举例而言：用户可能只对玩家范围内的PlayerPawn或某些Actor感兴趣）。

打开追踪源过滤器（Trace Source Filter）选项卡的方法是：在Animation Insights中选择 菜单（Menu）>（过滤）追踪源过滤（(Filtering) Trace Source Filtering） 。

用户界面


序号	说明
1	添加过滤器（Add Filter）下拉框可添加用户创建的过滤器并结合AND、OR和NOT逻辑运算符。选项（Options）可显示每个Actor各自的过滤器状态、重置当前过滤器，并保存或加载过滤器预设。
2	设置过滤器变量值的情境相关区域。
3	选项（Options）下拉框可按场景类型（World Type）（编辑器、PIE或游戏）或场景网络模式（World Net Mode）（客户端、服务器或Standalone）启用场景过滤。

以下动画将显示正在运行的追踪源过滤：

如何实现追踪源过滤

Animation Insights

Animation Insights扩展了现有 showdebug animation 功能（其显示动画运行时内部数据）。信息的显示和分析让用户能够识别动画故障或bug原因。

showdebug animation 系统仅会在屏幕上输出文本，因此 showdebug animation 会随时间限制用户追踪动画问题的能力。Animation Insights可记录包含动画bug的帧范围，同时在查看数据分解时拖动（或播放）这些帧。

showdebug animation

功能按钮参考


输入快捷方式	功能
Ctrl + 鼠标左键在时间标尺上拖动	拖动时间标尺（轨迹视图上方）控制当前时间，从而进行在原理视图中拖动值、在视口中设置姿势动画等操作
G	切换图表可视性
V	自动隐藏当前视口中无时间事件的轨迹
I	切换I/O（文件输入）概览和活动轨迹可视性
L	切换资源加载轨迹可视性
Y	切换GPU轨迹可视性
U	切换CPU线程（和所有CPU线程组）轨迹可视性
R	切换帧轨迹可视性

用户界面


序号	说明
1	可显示Timing Insights轨迹（如计数器或帧）的Animation Insights菜单。另外，用户可从此菜单打开追踪源过滤面板（Trace Source Filtering Panel）。
2	帧面板
3	包含轨迹分组和过滤选项的时间面板。阅读下文查看可用轨迹类型。
4	便于用户查看特定属性、显示风格（如多边形或点）、序列数据、轨迹布局和轨迹大小的快捷菜单。
5	可播放录制会话和步进帧的传输控制。
6	显示各轨迹属性的原理视图。拖动标尺时它们会随时间变化。

Unreal Insights介绍

轨迹检查

若要检查轨迹以便调试或分析性能，右键点击轨迹并浏览快捷菜单了解轨迹详情。

右键点击图表 - AnimSingleNodeInstance_1，打开图表轨迹（Graph Track）快捷菜单。

动画师通常需识别动画问题点，使用Animation Insights显示通知、曲线、姿势、图表、 蒙太奇 和 混合权重 ，以便进行调试。

轨迹类型

每种轨迹均有各自的快捷菜单，即逐轨迹操作的主要入口点（例如可在姿势轨迹（Pose Track）菜单中启用或禁用姿势在视口中的渲染）。部分轨迹拥有通用快捷菜单选项。例如，显示图表的轨迹可执行缩放图表、切换系列、堆叠/覆盖视图等操作。

通知

通知轨迹显示关于通知和同步标记的动画。轨迹最上层通道显示逐帧事件，如标记、通知事件（如音频和效果）和同步标记。其他通道显示活跃通知状态。右键点击轨迹并选择视图属性（View Properties）可显示当前帧的活跃通知。

曲线

曲线轨迹显示帧中所有活跃曲线。右键点击并选择视图属性（View Properties）可查看给定帧的活跃曲线值。

姿势

使用姿势轨迹可在拖动时间轴时显示或隐藏Actor。

图表

右键点击并选择 调试此图表（Debug this graph） 可打开动画蓝图调试器并连接到轨迹。打开动画蓝图调试器后，拖动时间轴可查看正执行的图表，包括姿势链接权重、状态机状态、资源播放器位置和混合空间范例。选择 查看此图表（View this graph） 可查看动画图表的"树"原理视图。