使用指南

节点事件节点

事件处理 / 节点事件节点手册，包含 2 个节点的用途、引脚、使用场景和注意事项。

学习目标

理解工作流从哪里开始执行，以及如何把生命周期、输入、自定义事件转成后续游戏逻辑。

节点	节点 ID	输入/输出	执行方式
绑定节点事件	`nodeEventBind`	4 / 2	立即继续
触发节点事件	`nodeEventEmit`	4 / 1	立即继续

绑定节点事件：在指定场景节点上监听特定事件，事件触发后运行对应的执行事件节点。适合做节点交互：例如在某个角色节点上绑定”触碰”事件，每次有物体碰到该角色时自动执行处理逻辑。绑定成功后会输出一个绑定句柄，可用于后续取消绑定。

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`exe`	-	执行流	执行流	连接到此端口以注册节点事件监听	-	可选
`event`	事件	事件	事件	事件入口连接到执行事件节点的事件输出引脚	-	必填
`node`	节点	数据	cc.Node	目标节点要监听事件的场景节点	-	必填
`eventName`	事件名	数据	enum / NodeEventNameEnum	事件名选择要监听的节点事件类型，例如 TOUCH_START	下拉选择	必填

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`exe`	-	执行流	执行流	事件触发时从此处执行绑定的回调逻辑	-	可选
`handle`	句柄	数据	eventHandle	绑定句柄用于后续取消这个具体监听。	-	可选

发送节点事件：在指定场景节点上触发一个事件，所有绑定该节点事件的组件都会收到并执行相应逻辑。可以附带一个负载对象来传递额外数据：例如在玩家节点上发送”移动”事件时带上目标位置。

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`exe`	-	执行流	执行流	连接到此端口以触发节点事件	-	可选
`node`	节点	数据	cc.Node	目标节点要触发事件的场景节点	-	必填
`eventName`	事件名	数据	enum / NodeEventNameEnum	要触发的节点事件名称，需与绑定的事件名一致	下拉选择	必填
`payload`	负载	数据	unknown	事件负载随事件派发的对象	-	可选

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`exe`	-	执行流	执行流	事件触发后从此处继续执行下游逻辑	-	可选