Cocos 导演 / 常驻节点 / Director节点

学习目标

掌握 Cocos 导演 / 常驻节点 / Director 节点的用途、引脚和常见组合方式。

覆盖范围

• 节点数量：3
• 分类路径：Cocos 导演 / 常驻节点 / Director

典型使用场景

• 组合节点完成游戏逻辑
• 作为中小型游戏功能模块的一部分

通用注意事项

• 按引脚类型连接节点，避免把执行流和数据流混用。
• 修改上游类型或资源命名后，应重新检查相关连线。

节点索引

节点	节点 ID	输入/输出	执行方式
是否为常驻根节点	directorIsPersistRootNode	1 / 1	立即继续
添加常驻根节点	directorAddPersistRootNode	2 / 2	立即继续
移除常驻根节点	directorRemovePersistRootNode	2 / 2	立即继续

是否为常驻根节点

是否为常驻根节点：检查这个节点现在是不是会跨场景保留。

节点信息

字段	值
节点 ID	directorIsPersistRootNode
分类	Cocos 导演
二级分类	常驻节点
分组	Director
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
node	节点	数据	cc.Node	节点 要声明或取消为常驻根节点的目标节点。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
isPersistRoot	是常驻根节点	数据	boolean	常驻状态 true 表示该节点当前已声明为常驻根节点。	-	可选

使用场景

• 连接到同类节点组合完整游戏逻辑
• 在中小型游戏中封装一段明确的行为

注意事项

• 适合的工作流类型：component、library、method、function、class。

---

添加常驻根节点

添加常驻根节点：让这个节点在切换场景后继续保留，不被一起销毁。 注意：目标节点必须直接挂在场景根下，否则不会生效。

节点信息

字段	值
节点 ID	directorAddPersistRootNode
分类	Cocos 导演
二级分类	常驻节点
分组	Director
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
node	节点	数据	cc.Node	节点 要声明或取消为常驻根节点的目标节点。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
node	节点	数据	cc.Node	节点（透传） 把当前操作的节点继续传给后续节点。	-	可选

使用场景

• 连接到同类节点组合完整游戏逻辑
• 在中小型游戏中封装一段明确的行为

注意事项

• 适合的工作流类型：component、library、method、function、class。

---

移除常驻根节点

移除常驻根节点：让这个节点恢复成普通节点，后续切换场景时可以被正常销毁。

节点信息

字段	值
节点 ID	directorRemovePersistRootNode
分类	Cocos 导演
二级分类	常驻节点
分组	Director
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
node	节点	数据	cc.Node	节点 要声明或取消为常驻根节点的目标节点。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
node	节点	数据	cc.Node	节点（透传） 把当前操作的节点继续传给后续节点。	-	可选

使用场景

• 连接到同类节点组合完整游戏逻辑
• 在中小型游戏中封装一段明确的行为

注意事项

• 适合的工作流类型：component、library、method、function、class。