Cocos 组件 / 3D物理 / BoxCollider节点

学习目标

访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。

覆盖范围

• 节点数量：2
• 分类路径：Cocos 组件 / 3D物理 / BoxCollider

典型使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

通用注意事项

• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
• 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。

节点索引

节点	节点 ID	输入/输出	执行方式
获取盒体尺寸	boxColliderGetSize	1 / 1	立即继续
设置盒体尺寸	boxColliderSetSize	3 / 2	立即继续

获取盒体尺寸

获取盒体完整尺寸：返回 BoxCollider 的本地空间盒体尺寸。 尺寸以完整宽×高×深定义（非半尺寸），节点缩放会叠加影响最终碰撞体在世界中的大小。 常用于读取碰撞箱大小，用于 UI 显示、动态调整碰撞区域或条件判断。

节点信息

字段	值
节点 ID	boxColliderGetSize
分类	Cocos 组件
二级分类	3D物理
分组	BoxCollider
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
boxCollider	-	数据	cc.Component / BoxCollider	目标 BoxCollider 组件 要操作的盒形碰撞体组件。 BoxCollider 是 3D 物理最常用的基础碰撞体，size 描述本地空间盒体的完整尺寸（宽×高×深），与节点缩放叠加后决定最终碰撞体积。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
size	尺寸	数据	vector3	盒体完整尺寸 本地空间盒体的完整尺寸：x=宽，y=高，z=深。 这是完整尺寸而非半尺寸。节点缩放会叠加影响最终碰撞体在世界中的大小。	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置盒体尺寸

设置盒体完整尺寸：修改 BoxCollider 的本地空间盒体尺寸。 尺寸以完整宽×高×深定义（非半尺寸），节点缩放会叠加影响最终碰撞体在世界中的大小。 常用于动态调整碰撞箱大小，如角色蹲下时缩小碰撞体、道具变大时扩大碰撞区域。

节点信息

字段	值
节点 ID	boxColliderSetSize
分类	Cocos 组件
二级分类	3D物理
分组	BoxCollider
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
boxCollider	-	数据	cc.Component / BoxCollider	目标 BoxCollider 组件 要操作的盒形碰撞体组件。 BoxCollider 是 3D 物理最常用的基础碰撞体，size 描述本地空间盒体的完整尺寸（宽×高×深），与节点缩放叠加后决定最终碰撞体积。	-	必填
size	尺寸	数据	vector3	盒体完整尺寸 本地空间盒体的完整尺寸：x=宽，y=高，z=深。 这是完整尺寸而非半尺寸。节点缩放会叠加影响最终碰撞体在世界中的大小。	可编辑控件 默认值：{“x”:1,“y”:1,“z”:1}	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
boxCollider	-	数据	cc.Component / BoxCollider	目标 BoxCollider 组件 透传当前操作的 BoxCollider 组件，便于链式操作。	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。