Version: 1.7
语言 : 中文
AnimGraph Node Binding 功能
使用指南

Rig Graph(程序化绑定编辑器)

概述

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 资产为例,进行快速配置:

  1. 安装Rig Graph Package:在团结引擎中打开项目工程后,通过 Edit -> Project Settings -> Player -> TuanjieAnimation 选项卡,勾选 Add RigGraph Package 进行安装。

  2. Rig Graph Manager 组件挂载:将人形角色拖入场景,挂载 Rig Graph Manager 组件。

  3. 选择 Rig Graph 资产模板:选择、创建或克隆所需资产。

  4. 配置Avatar:将角色的 Humanoid Avatar 文件拖入配置框,或点击 Setup Avatar 按钮自动关联。

快速配置流程
快速配置流程

名词解释

  • 脚本图(Script Graph):可视化脚本,通过连接不同的功能节点(如条件判断、数学运算、事件响应等节点)构建绑定逻辑流程。

  • 控制点(Effector):绑定系统中的可视化控制点,通常可视化为场景中的可操作手柄(Gizmo),用于驱动骨骼或模型的运动。它通过绑定逻辑与骨骼层级关联,能直观地调整角色的姿势或动作。

  • Rig 预制件:包含控制点的预制件,用于在场景中创建和管理控制点。

  • Rig Graph 资产:主要包含 Script Graph 与 Rig 预制件。

  • 通用人形角色 Rig Graph 资产:为人形角色制作的模板资产,通过 FK 和 IK 两种控制模式,对人形角色的头部、躯干、四肢进行绑定,人形角色类型为 Humanoid 或 Generic 时均可使用。

What’s New

2025.10.20

  • [feature] 修改 Timeline 中的相关动画功能

    • 新增 Override Track 记录控制点的动画曲线
  • [bugfix] 相关bug的修复

AnimGraph Node Binding 功能
使用指南