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

学习目标

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

覆盖范围

节点数量：6
分类路径：Cocos 组件 / 3D物理 / CylinderCollider

典型使用场景

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

通用注意事项

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

节点索引

节点	节点 ID	输入/输出	执行方式
获取半径	`cylinderColliderGetRadius`	1 / 1	立即继续
获取朝向轴	`cylinderColliderGetDirection`	1 / 1	立即继续
获取高度	`cylinderColliderGetHeight`	1 / 1	立即继续
设置半径	`cylinderColliderSetRadius`	3 / 2	立即继续
设置朝向轴	`cylinderColliderSetDirection`	3 / 2	立即继续
设置高度	`cylinderColliderSetHeight`	3 / 2	立即继续

获取半径

获取圆柱端面半径（radius）：返回圆柱碰撞体本地空间的端面半径。这是圆柱端面（截面圆）的半径。节点缩放会叠加影响最终碰撞体在世界中的大小。常用于读取柱子或桶状物体的碰撞半径，用于区域判定或碰撞检测。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`cylinderCollider`	圆柱碰撞体	数据	cc.Component / CylinderCollider	目标 CylinderCollider 组件要操作的圆柱碰撞体组件。 CylinderCollider 是 3D 物理中的圆柱形碰撞体，常用于立柱、桶、圆柱机关、竖向触发区等场景。几何参数 radius、height、direction 共同决定最终碰撞体积与朝向，本地几何参数会与节点缩放共同决定最终世界碰撞体效果。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`radius`	半径	数据	number	端面半径（本地空间）圆柱端面截面圆的半径。节点缩放会叠加影响最终碰撞体在世界中的大小。	-	可选

使用场景

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

注意事项

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

获取朝向轴

获取圆柱朝向轴（direction）：返回圆柱碰撞体的轴向朝向，决定圆柱沿哪个轴拉伸高度。取值：0（X_AXIS）=X 轴方向，1（Y_AXIS）=Y 轴方向，2（Z_AXIS）=Z 轴方向。半径作用在与该轴垂直的截面上。默认值 1（Y 轴）最常用于竖向立柱；水平圆柱通常使用 0（X 轴）或 2（Z 轴）。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`cylinderCollider`	圆柱碰撞体	数据	cc.Component / CylinderCollider	目标 CylinderCollider 组件要操作的圆柱碰撞体组件。 CylinderCollider 是 3D 物理中的圆柱形碰撞体，常用于立柱、桶、圆柱机关、竖向触发区等场景。几何参数 radius、height、direction 共同决定最终碰撞体积与朝向，本地几何参数会与节点缩放共同决定最终世界碰撞体效果。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`direction`	朝向轴	数据	enum / physics.EAxisDirection	圆柱朝向轴（EAxisDirection）取值：0（X_AXIS）=X 轴方向，1（Y_AXIS）=Y 轴方向，2（Z_AXIS）=Z 轴方向。	-	可选

使用场景

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

注意事项

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

获取高度

获取圆柱轴向高度（height）：返回圆柱碰撞体本地空间沿当前轴向的完整高度。这是完整高度，节点缩放会叠加影响最终碰撞体在世界中的大小。常用于读取柱子或桶状物体的碰撞高度，用于空间判定。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`cylinderCollider`	圆柱碰撞体	数据	cc.Component / CylinderCollider	目标 CylinderCollider 组件要操作的圆柱碰撞体组件。 CylinderCollider 是 3D 物理中的圆柱形碰撞体，常用于立柱、桶、圆柱机关、竖向触发区等场景。几何参数 radius、height、direction 共同决定最终碰撞体积与朝向，本地几何参数会与节点缩放共同决定最终世界碰撞体效果。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`height`	高度	数据	number	轴向高度（本地空间）圆柱沿当前轴向的完整高度。节点缩放会叠加影响最终碰撞体在世界中的大小。	-	可选

使用场景

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

注意事项

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

设置半径

设置圆柱端面半径（radius）：修改圆柱碰撞体本地空间的端面半径。节点缩放会叠加影响最终碰撞体在世界中的大小。常用于动态调整柱子或桶状物体的碰撞粗细。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`exe`	-	执行流	执行流	执行入口	-	可选
`cylinderCollider`	圆柱碰撞体	数据	cc.Component / CylinderCollider	目标 CylinderCollider 组件要操作的圆柱碰撞体组件。 CylinderCollider 是 3D 物理中的圆柱形碰撞体，常用于立柱、桶、圆柱机关、竖向触发区等场景。几何参数 radius、height、direction 共同决定最终碰撞体积与朝向，本地几何参数会与节点缩放共同决定最终世界碰撞体效果。	-	必填
`radius`	半径	数据	number	端面半径圆柱端面截面圆的半径（本地空间）。节点缩放会叠加影响最终碰撞体在世界中的大小。	输入框默认值：0.5	必填

输出引脚

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

使用场景

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

注意事项

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

设置朝向轴

设置圆柱朝向轴（direction）：修改圆柱碰撞体的轴向朝向，决定圆柱高度沿哪个本地轴展开。取值：0（X_AXIS）=X 轴方向，1（Y_AXIS）=Y 轴方向，2（Z_AXIS）=Z 轴方向。半径作用在与朝向轴垂直的截面上。默认 Y 轴（竖向）适用于立柱；X 轴或 Z 轴适用于横躺的圆柱体。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`exe`	-	执行流	执行流	执行入口	-	可选
`cylinderCollider`	圆柱碰撞体	数据	cc.Component / CylinderCollider	目标 CylinderCollider 组件要操作的圆柱碰撞体组件。 CylinderCollider 是 3D 物理中的圆柱形碰撞体，常用于立柱、桶、圆柱机关、竖向触发区等场景。几何参数 radius、height、direction 共同决定最终碰撞体积与朝向，本地几何参数会与节点缩放共同决定最终世界碰撞体效果。	-	必填
`direction`	朝向轴	数据	enum / physics.EAxisDirection	圆柱朝向轴（EAxisDirection）取值：0（X_AXIS）=X 轴方向，1（Y_AXIS）=Y 轴方向，2（Z_AXIS）=Z 轴方向。	下拉选择默认值：“Y_AXIS”	必填

输出引脚

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

使用场景

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

注意事项

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

设置高度

设置圆柱轴向高度（height）：修改圆柱碰撞体本地空间沿轴向的完整高度。节点缩放会叠加影响最终碰撞体在世界中的大小。高度方向由 direction 属性决定。常用于动态调整柱子或桶状物体的碰撞高度。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
`exe`	-	执行流	执行流	执行入口	-	可选
`cylinderCollider`	圆柱碰撞体	数据	cc.Component / CylinderCollider	目标 CylinderCollider 组件要操作的圆柱碰撞体组件。 CylinderCollider 是 3D 物理中的圆柱形碰撞体，常用于立柱、桶、圆柱机关、竖向触发区等场景。几何参数 radius、height、direction 共同决定最终碰撞体积与朝向，本地几何参数会与节点缩放共同决定最终世界碰撞体效果。	-	必填
`height`	高度	数据	number	轴向高度圆柱沿当前轴向的完整高度（本地空间）。节点缩放会叠加影响最终碰撞体在世界中的大小。	输入框默认值：2	必填

输出引脚

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

使用场景

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

注意事项

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