编辑器拥有 Animation Insights 插件,可显示gameplay状态和实时动画行为。用户可以使用Animation Insights记录追踪信息,使用以下功能显示动画行为:
- 通道过滤,选择写至记录数据集的追踪数据
- 源过滤,选择输出追踪数据的gameplay对象
- 姿势、曲线、混合权重、动画图表、蒙太奇和动画通知轨迹
- 包含实时更新的动画图表原理视图,用于替换
showdebug animation
系统。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/c30426a6-0b18-41d0-95cb-8562175a226a/animationinsightshero.png)
设置
启用以下插件才能在编辑器中使用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)。目前编辑器提供默认动画预设,目前可使用帧通道、对象通道和动画通道。
![数据过滤状态](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/8fe605b5-55ac-4ad5-88d2-309b970a8bde/datafilterstatus.gif)
通道过滤
启用通道后,数据将追踪至Animation Insights次选项卡中的时间轴。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/692df89b-26aa-4b9d-95fe-34106656028c/animationinsightshero.png)
在编辑器中运行(PIE)可查看场景中骨架网格体组件的动画数据追踪
追踪源过滤(Trace Source Filtering)
用户可使用追踪源过滤决定可输出追踪数据的gameplay对象。若开发大型游戏,给定场景中会有大量Actor和组件。使用追踪源(Trace Source)过滤可减少追踪数据记录量、限制开销并减少磁盘空间用量(举例而言:用户可能只对玩家范围内的PlayerPawn或某些Actor感兴趣)。
打开追踪源过滤器(Trace Source Filter)选项卡的方法是:在Animation Insights中选择 菜单(Menu)>(过滤)追踪源过滤((Filtering) Trace Source Filtering)。
用户界面
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/8e616d75-bda6-47b2-ad76-2b244e3bfd2b/tracesourcefilteringui.png)
序号 | 说明 |
---|---|
1 | 添加过滤器(Add Filter) 下拉框可添加用户创建的过滤器并结合AND、OR和NOT逻辑运算符。选项(Options) 可显示每个Actor各自的过滤器状态、重置当前过滤器,并保存或加载过滤器预设。 |
2 | 设置过滤器变量值的情境相关区域。 |
3 | 选项(Options) 下拉框可按 场景类型(World Type)(编辑器、PIE或游戏)或 场景网络模式(World Net Mode)(客户端、服务器或Standalone)启用场景过滤。 |
以下动画将显示正在运行的追踪源过滤:
![源过滤状态](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/bd252154-6319-4522-980d-f57e0f117e5d/sourcefilterstatus.gif)
Animation Insights
Animation Insights扩展了现有 showdebug animation
功能(其显示动画运行时内部数据)。信息的显示和分析让用户能够识别动画故障或bug原因。
showdebug animation
系统仅会在屏幕上输出文本,因此 showdebug animation
会随时间限制用户追踪动画问题的能力。Animation Insights可记录包含动画bug的帧范围,同时在查看数据分解时拖动(或播放)这些帧。
![拖动选项](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/dc0887ad-20b3-47f3-b3be-4d9b3911fde8/schematicviewscrubbingselection.gif)
包含实时更新的Animation Insights原理视图—可替换 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 | 显示各轨迹属性的原理视图。拖动标尺时它们会随时间变化。 |
轨迹检查
若要检查轨迹以便调试或分析性能,右键点击轨迹并浏览快捷菜单了解轨迹详情。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/3b87a62a-9ee4-4c23-b616-9582c311adf6/graphcontextmenu.png)
右键点击图表 - AnimSingleNodeInstance_1,打开图表轨迹(Graph Track)快捷菜单。
动画师通常需识别动画问题点,使用Animation Insights显示 通知、曲线、姿势、图表、蒙太奇 和 混合权重,以便进行调试。
轨迹类型
每种轨迹均有各自的快捷菜单,即逐轨迹操作的主要入口点(例如可在姿势轨迹(Pose Track)菜单中启用或禁用姿势在视口中的渲染)。部分轨迹拥有通用快捷菜单选项。例如,显示图表的轨迹可执行缩放图表、切换系列、堆叠/覆盖视图等操作。
通知
通知轨迹显示关于通知和同步标记的动画。轨迹最上层通道显示逐帧事件,如标记、通知事件(如音频和效果)和同步标记。其他通道显示活跃通知状态。右键点击轨迹并选择视图属性(View Properties)可显示当前帧的活跃通知。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/405d2d4c-3059-4ec1-8cef-66618d729c27/animnotifytrack.png)
曲线
曲线轨迹显示帧中所有活跃曲线。右键点击并选择视图属性(View Properties)可查看给定帧的活跃曲线值。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/8b8121a2-ed54-4a1b-8177-21a0c9a88b78/curvetrack.png)
姿势
使用姿势轨迹可在拖动时间轴时显示或隐藏Actor。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/f53831eb-c430-4f4a-95c2-9553fc451466/posetrack.png)
图表
右键点击并选择 调试此图表(Debug this graph) 可打开动画蓝图调试器并连接到轨迹。打开动画蓝图调试器后,拖动时间轴可查看正执行的图表,包括姿势链接权重、状态机状态、资源播放器位置和混合空间范例。选择 查看此图表(View this graph) 可查看动画图表的“树”原理视图。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/5f8e5f5c-5670-421e-9cfa-86550d249e37/graphtrack.png)
蒙太奇
可使用蒙太奇轨迹检查随时间变化的蒙太奇信息,包括混合权重和当前/下一分段。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/a7b8c7b7-d613-4768-81e2-0181e4594a8c/montagetrack.png)
混合权重
混合权重轨迹显示帧中所有活跃资源及其有效混合权重。右键点击图表可转到动画蓝图中该图表对应的节点。同时可查看其他图表,如播放时间或混合空间坐标。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/c0b7426d-091f-43ac-b449-2a117b2359c1/blendweights2.png)
轨迹可视性
轨迹(Tracks) 下拉框过滤器可切换时间轨迹可视性。
![](https://d1iv7db44yhgxn.cloudfront.net/documentation/images/dbbec498-ae49-411a-b6f4-d1fd6ed88407/tracksfilter.png)