使用指南
事件节点
事件处理 / 生命周期事件 节点手册，包含 7 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
理解工作流从哪里开始执行，以及如何把生命周期、输入、自定义事件转成后续游戏逻辑。
覆盖范围
- 节点数量：7
- 分类路径：事件处理 / 生命周期事件
典型使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
通用注意事项
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 更新事件 | updateEvent | 0 / 2 | 立即继续 |
| 加载事件 | loadEvent | 0 / 1 | 立即继续 |
| 禁用事件 | disableEvent | 0 / 1 | 立即继续 |
| 启动事件 | startEvent | 0 / 1 | 立即继续 |
| 启用事件 | enableEvent | 0 / 1 | 立即继续 |
| 销毁事件 | destroyEvent | 0 / 1 | 立即继续 |
| 延迟更新事件 | lateUpdateEvent | 0 / 2 | 立即继续 |
更新事件
更新事件：每帧触发一次，在所有启动事件之后开始执行。 帧率取决于设备和场景复杂度，高性能设备上每秒可能执行 60 次或更多。 适合做持续检测输入、逐帧移动物体、实时更新动画等需要每帧执行的逻辑。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | updateEvent |
| 分类 | 事件处理 |
| 二级分类 | 生命周期事件 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 每帧渲染前触发，适合在此执行持续更新逻辑 | - | 可选 |
deltaTime | 时间增量 | 数据 | number | 帧间隔 上一帧耗时 | - | 可选 |
使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
注意事项
- 适合的工作流类型：component。
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。
加载事件
加载事件：组件被加载到场景中时触发，早于启动事件。 此时组件尚未激活，适合做注册全局事件监听、初始化数据、获取外部引用等不需要组件激活就能完成的工作。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | loadEvent |
| 分类 | 事件处理 |
| 二级分类 | 生命周期事件 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 场景加载完成后触发，适合在此执行初始化逻辑 | - | 可选 |
使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
注意事项
- 适合的工作流类型：component。
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。
禁用事件
禁用事件：组件从启用变为禁用时触发。例如角色死亡后关闭 AI 组件、离开区域后关闭特效组件。 适合做移除事件监听、暂停音效、清理临时状态等禁用时的收尾工作。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | disableEvent |
| 分类 | 事件处理 |
| 二级分类 | 生命周期事件 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 组件每次禁用时触发，适合在此执行清理或暂停逻辑 | - | 可选 |
使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
注意事项
- 适合的工作流类型：component。
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。
启动事件
启动事件：组件第一次被激活时触发，整个生命周期内只触发一次。 适合做获取同节点其他组件、设置初始状态、计算初始值等启动时一次性配置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | startEvent |
| 分类 | 事件处理 |
| 二级分类 | 生命周期事件 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 组件首次启用时触发，适合在此执行启动逻辑 | - | 可选 |
使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
注意事项
- 适合的工作流类型：component。
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。
启用事件
启用事件：组件从禁用变为启用时触发。与启动事件不同：启动事件只触发一次，启用事件每次启用都会触发，包括第一次激活和后续的禁用再启用。 适合做恢复运行状态、重新注册监听、刷新显示内容等启用时需要重新准备的工作。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | enableEvent |
| 分类 | 事件处理 |
| 二级分类 | 生命周期事件 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 组件每次启用时触发，适合在此执行重新激活逻辑 | - | 可选 |
使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
注意事项
- 适合的工作流类型：component。
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。
销毁事件
销毁事件：组件即将被销毁时触发，是最后清理的机会。 适合做移除全局事件监听、释放外部引用、清理动态创建的子对象等最终收尾工作。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | destroyEvent |
| 分类 | 事件处理 |
| 二级分类 | 生命周期事件 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 组件销毁时触发，适合在此执行清理逻辑 | - | 可选 |
使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
注意事项
- 适合的工作流类型：component。
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。
延迟更新事件
延迟更新事件：在所有更新事件执行完毕后触发。 适合做相机跟随角色、UI 血条跟随等依赖其他对象已更新完成后的逻辑。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | lateUpdateEvent |
| 分类 | 事件处理 |
| 二级分类 | 生命周期事件 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 每帧在所有更新事件执行完毕后触发，在渲染之前执行，适合做依赖更新结果的后处理逻辑 | - | 可选 |
deltaTime | 时间增量 | 数据 | number | 帧间隔 上一帧耗时 | - | 可选 |
使用场景
- 在组件加载、启动、更新、禁用和销毁阶段触发逻辑
- 把初始化、每帧刷新和清理逻辑拆到不同入口
- 制作角色控制、计时器、状态刷新等组件行为
注意事项
- 适合的工作流类型：component。
- 生命周期事件节点通常不需要执行输入。
- 更新类事件每帧触发，内部逻辑应保持轻量。