Animation Insights概述

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

Windows
MacOS
Linux

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

  • 通道过滤,选择写至记录数据集的追踪数据

  • 源过滤,选择输出追踪数据的gameplay对象

  • 姿势、曲线、混合权重、动画图表、蒙太奇和动画通知轨迹

  • 包含实时更新的动画图表原理视图,用于替换 showdebug animation 系统。

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)。目前编辑器提供默认动画预设,目前可使用帧通道、对象通道和动画通道。

欲了解通道的更多基本信息,请参阅Unreal Insights概览

数据过滤状态

通道过滤

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

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

AnimationInsightsHero.png

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

追踪源过滤(Trace Source Filtering)

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

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

用户界面

TraceSourceFilteringUI.png

序号

说明

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的帧范围,同时在查看数据分解时拖动(或播放)这些帧。

拖动选项

包含实时更新的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

显示各轨迹属性的原理视图。拖动标尺时它们会随时间变化。

欲详细了解Timing Insights、帧面板、时间面板、轨迹(及其他内容),请参阅Unreal Insights概览

轨迹检查

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

GraphContextMenu.png

右键点击图表 - AnimSingleNodeInstance_1,打开图表轨迹(Graph Track)快捷菜单。

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

轨迹类型

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

通知

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

AnimNotifyTrack.png

曲线

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

CurveTrack.png

姿势

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

PoseTrack.png

图表

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

GraphTrack.png

蒙太奇

可使用蒙太奇轨迹检查随时间变化的蒙太奇信息,包括混合权重和当前/下一分段。

MontageTrack.png

混合权重

混合权重轨迹显示帧中所有活跃资源及其有效混合权重。右键点击图表可转到动画蓝图中该图表对应的节点。同时可查看其他图表,如播放时间或混合空间坐标。

BlendWeights2.png

轨迹可视性

轨迹(Tracks) 下拉框过滤器可切换时间轨迹可视性。

TracksFilter.png

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback