Rig Graph 是团结引擎中基于可视化脚本(Visual Scripting)的动画绑定与控制系统。它采用节点图编程范式,通过连接可视化节点来组织动画逻辑,使开发者能够直观地构建角色运动控制流程。
本文档将介绍 Rig Graph 的使用方法与核心概念,主要内容包括:
快速开始模块介绍为人形角色进行快速配置的标准流程。该流程基于通用人形角色的 Rig Graph 资产,资产中包含绑定逻辑的脚本图(Script Graph)和交互控制点(Effector)。
使用指南模块描述具体的使用方法,包括 Runtime 功能、动画录制以及动画烘焙。
组件模块解析 Rig Graph 的关键组件,阐明各组件功能定位及层级协作关系。
Rig Graph资产模块描述用户自定义 Rig Graph 资产时的基本步骤。
Graph Code Generator概述模块阐述如何将 Script Graph 中的绑定逻辑转换为高性能 C# 代码。
附录模块对通用人形角色 Rig Graph 资产中的 Rig Graph Variables 和控制点组进行补充说明。
下面将以通用人形角色 Rig Graph 资产为例,进行快速配置:
安装Rig Graph Package:在团结引擎中打开项目工程后,通过 Edit -> Project Settings -> Player -> TuanjieAnimation 选项卡,勾选 Add RigGraph Package 进行安装。
Rig Graph Manager 组件挂载:将人形角色拖入场景,挂载 Rig Graph Manager 组件。
选择 Rig Graph 资产模板:选择、创建或克隆所需资产。
配置Avatar:将角色的 Humanoid Avatar 文件拖入配置框,或点击 Setup Avatar 按钮自动关联。
脚本图(Script Graph):可视化脚本,通过连接不同的功能节点(如条件判断、数学运算、事件响应等节点)构建绑定逻辑流程。
控制点(Effector):绑定系统中的可视化控制点,通常可视化为场景中的可操作手柄(Gizmo),用于驱动骨骼或模型的运动。它通过绑定逻辑与骨骼层级关联,能直观地调整角色的姿势或动作。
Rig 预制件:包含控制点的预制件,用于在场景中创建和管理控制点。
Rig Graph 资产:主要包含 Script Graph 与 Rig 预制件。
通用人形角色 Rig Graph 资产:为人形角色制作的模板资产,通过 FK 和 IK 两种控制模式,对人形角色的头部、躯干、四肢进行绑定,人形角色类型为 Humanoid 或 Generic 时均可使用。
2025.10.20
[feature] 修改 Timeline 中的相关动画功能
[bugfix] 相关bug的修复