Cocos 组件 / 后效 / HBAO节点

学习目标

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

覆盖范围

• 节点数量：12
• 分类路径：Cocos 组件 / 后效 / HBAO

典型使用场景

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

通用注意事项

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

节点索引

节点	节点 ID	输入/输出	执行方式
获取 AO 饱和度	hbaoGetAOSaturation	1 / 1	立即继续
获取采样半径缩放	hbaoGetRadiusScale	1 / 1	立即继续
获取角度偏置	hbaoGetAngleBiasDegree	1 / 1	立即继续
获取模糊开关	hbaoGetNeedBlur	1 / 1	立即继续
获取模糊锐度	hbaoGetBlurSharpness	1 / 1	立即继续
获取全部属性	hbaoGetProperties	1 / 5	立即继续
设置 AO 饱和度	hbaoSetAOSaturation	3 / 2	立即继续
设置采样半径缩放	hbaoSetRadiusScale	3 / 2	立即继续
设置角度偏置	hbaoSetAngleBiasDegree	3 / 2	立即继续
设置模糊开关	hbaoSetNeedBlur	3 / 2	立即继续
设置模糊锐度	hbaoSetBlurSharpness	3 / 2	立即继续
设置全部属性	hbaoSetProperties	7 / 2	立即继续

获取 AO 饱和度

获取 AO 饱和度：返回当前 HBAO 组件的 AO 饱和度参数。 取值范围 0 ~ 10，默认值 1：- 控制 AO 结果从灰度遮蔽到保留更多颜色信息的程度；

• 默认值 1 更偏纯灰度遮蔽；
• 增大后 AO 结果会保留更多颜色饱和感，使遮蔽区域不那么中性灰；
• 注意：这是 AO 结果的色彩保留程度，不是 AO 强度总开关。

节点信息

字段	值
节点 ID	hbaoGetAOSaturation
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
aoSaturation	AO 饱和度	数据	number	HBAO AO 饱和度 范围 [0, 10]，默认值 1。值越低越接近中性灰遮蔽，值越高越保留颜色信息。不是 AO 强度总开关。	-	可选

使用场景

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

注意事项

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

---

获取采样半径缩放

获取采样半径缩放：返回当前 HBAO 的环境光遮蔽采样半径缩放值。 取值范围 0 ~ 10，默认值 1。值越大，遮蔽覆盖范围越广，模拟的阴影距离越远，但过大可能让画面显得脏。

节点信息

字段	值
节点 ID	hbaoGetRadiusScale
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
radiusScale	采样半径缩放	数据	number	HBAO 采样半径缩放 范围 [0, 10]，默认值 1。值越大遮蔽范围越广，但过大可能造成脏灰阴影。	-	可选

使用场景

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

注意事项

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

---

获取角度偏置

获取角度偏置：返回当前 HBAO 组件的角度偏置参数。 取值范围 0 ~ 100，默认值 10：- 该参数用于抑制浅角度采样造成的自遮蔽误判；

• 值越小更容易得到强遮蔽，但也更容易出现噪点或假阴影；
• 值越大则遮蔽更保守，细节阴影可能被削弱。

节点信息

字段	值
节点 ID	hbaoGetAngleBiasDegree
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
angleBiasDegree	角度偏置	数据	number	HBAO 角度偏置 范围 [0, 100]，默认值 10。用于抑制自遮蔽误判；过低易脏、过高会削弱细节阴影。	-	可选

使用场景

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

注意事项

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

---

获取模糊开关

获取模糊开关：返回当前 HBAO 组件是否执行模糊阶段。 默认值 true：- 开启时执行模糊，可降低颗粒噪点，让 AO 过渡更柔和；

• 关闭时跳过模糊阶段，保留更多原始 AO 细节，同时减少性能开销；但噪点和颗粒感会更明显；
• 关闭后模糊锐度参数基本失去意义。

节点信息

字段	值
节点 ID	hbaoGetNeedBlur
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
needBlur	模糊开关	数据	boolean	HBAO 模糊开关 默认 true。开启可降低噪点，关闭可保留更多原始 AO 细节并减少性能开销。	-	可选

使用场景

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

注意事项

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

---

获取模糊锐度

获取模糊锐度：返回当前 HBAO 组件的模糊锐度参数。 取值范围 0 ~ 10，默认值 3：- 值越大，模糊时越倾向保边（更锐），但噪点残留也可能更明显；

• 值越小，模糊更柔和，边缘过渡更平滑；
• 仅在模糊开关开启时才真正影响最终结果，关闭模糊后此值基本失去意义。

节点信息

字段	值
节点 ID	hbaoGetBlurSharpness
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
blurSharpness	模糊锐度	数据	number	HBAO 模糊锐度 范围 [0, 10]，默认值 3。仅在模糊开关开启时有意义；值越大越保边，值越小越柔和。	-	可选

使用场景

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

注意事项

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

---

获取全部属性

一次性读取全部属性：聚合读取采样半径缩放、角度偏置、模糊锐度、AO 饱和度、模糊开关。 适合需要同时读取多个属性时减少节点数量。

节点信息

字段	值
节点 ID	hbaoGetProperties
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
radiusScale	采样半径缩放	数据	number	HBAO 采样半径缩放 [0, 10]，默认值 1	-	可选
angleBiasDegree	角度偏置	数据	number	HBAO 角度偏置 [0, 100]，默认值 10	-	可选
blurSharpness	模糊锐度	数据	number	HBAO 模糊锐度 [0, 10]，默认值 3。仅在模糊开关开启时有意义。	-	可选
aoSaturation	AO 饱和度	数据	number	HBAO AO 饱和度 [0, 10]，默认值 1	-	可选
needBlur	模糊开关	数据	boolean	HBAO 模糊开关，默认 true	-	可选

使用场景

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

注意事项

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

---

设置 AO 饱和度

设置 AO 饱和度：修改 HBAO 组件的 AO 饱和度参数，影响 AO 结果偏灰还是保留更多材质色彩。 取值范围 0 ~ 10，默认值 1：- 值越低越接近中性灰遮蔽，与材质颜色更解耦；

• 值越高 AO 结果保留更多颜色饱和度，遮蔽感更融合材质色彩；
• 这不是 AO 强度总开关，仅控制颜色信息的保留程度。

节点信息

字段	值
节点 ID	hbaoSetAOSaturation
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填
aoSaturation	AO 饱和度	数据	number	HBAO AO 饱和度 范围 [0, 10]，默认值 1。值越低越接近中性灰，值越高越保留颜色。不是 AO 强度总开关。	输入框 默认值：1	必填

输出引脚

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

使用场景

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

注意事项

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

---

设置采样半径缩放

设置 HBAO 采样半径缩放：修改 HBAO 组件的 radiusScale 参数，控制 AO 采样半径。 取值范围 [0, 10]，默认值 1：- 该值控制 AO 采样半径，不是后处理分辨率缩放；

• 值越大，遮蔽范围越广，但过大可能把远处结构混成脏灰阴影；
• 推荐从较小值（如 0.5 ~ 2）开始调试，逐步增大。

节点信息

字段	值
节点 ID	hbaoSetRadiusScale
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填
radiusScale	采样半径缩放	数据	number	HBAO 采样半径缩放 范围 [0, 10]，默认值 1。控制 AO 采样半径，不是分辨率缩放。	输入框 默认值：1	必填

输出引脚

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

使用场景

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

注意事项

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

---

设置角度偏置

设置角度偏置：修改 HBAO 组件的角度偏置参数，用于抑制自遮蔽误判。 取值范围 0 ~ 100，默认值 10：- 这是高级抑噪/防误判参数，适合出现过度脏灰或假阴影时微调；

• 值越小得到越强的遮蔽效果，但噪点与假阴影风险也增加；
• 值越大遮蔽越保守，细节阴影可能被过多削弱。

节点信息

字段	值
节点 ID	hbaoSetAngleBiasDegree
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填
angleBiasDegree	角度偏置	数据	number	HBAO 角度偏置 范围 [0, 100]，默认值 10。用于抑制自遮蔽误判；过低易脏、过高会削弱细节阴影。	输入框 默认值：10	必填

输出引脚

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

使用场景

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

注意事项

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

---

设置模糊开关

设置模糊开关：控制 HBAO 是否执行模糊阶段。 默认值 true：- 开启时执行模糊，可降低颗粒噪点，让 AO 过渡更柔和；

• 关闭后更省性能，但噪点更明显；
• 关闭后模糊锐度基本失去意义。

节点信息

字段	值
节点 ID	hbaoSetNeedBlur
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填
needBlur	模糊开关	数据	boolean	HBAO 模糊开关 默认 true。关闭后更省性能但噪点更明显，且会让模糊锐度基本失去意义。	开关 默认值：true	必填

输出引脚

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

使用场景

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

注意事项

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

---

设置模糊锐度

设置模糊锐度：修改 HBAO 组件的模糊锐度参数，影响模糊阶段的保边程度。 取值范围 0 ~ 10，默认值 3：- 值越大，模糊越倾向保边，细节更锐，但噪点残留也可能更明显；

• 值越小，模糊更柔和，过渡更平滑；
• 关闭模糊（needBlur = false）时，此值对最终结果基本无影响。

节点信息

字段	值
节点 ID	hbaoSetBlurSharpness
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填
blurSharpness	模糊锐度	数据	number	HBAO 模糊锐度 范围 [0, 10]，默认值 3。仅在模糊开关开启时有意义；值越大越保边，关闭模糊后此值基本失去意义。	输入框 默认值：3	必填

输出引脚

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

使用场景

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

注意事项

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

---

设置全部属性

批量修改全部属性：聚合写入采样半径缩放、角度偏置、模糊锐度、AO 饱和度、模糊开关。 说明：除执行流与 HBAO 组件引脚外，所有可写属性引脚默认不公开，只有被显式公开的属性才参与写入。

节点信息

字段	值
节点 ID	hbaoSetProperties
分类	Cocos 组件
二级分类	后效
分组	HBAO
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
hbao	HBAO	数据	cc.Component / HBAO	目标 HBAO 组件 要操作的 HBAO 后效组件。 HBAO（基于水平线的环境光遮蔽）通过深度信息模拟物体接触面的阴影和缝隙遮蔽效果，增强场景的立体感和层次感。	-	必填
radiusScale	采样半径缩放	数据	number	HBAO 采样半径缩放 [0, 10]，默认值 1	输入框 默认值：1	可选 默认隐藏
angleBiasDegree	角度偏置	数据	number	HBAO 角度偏置 [0, 100]，默认值 10	输入框 默认值：10	可选 默认隐藏
blurSharpness	模糊锐度	数据	number	HBAO 模糊锐度 [0, 10]，默认值 3。仅在模糊开关开启时有意义。	输入框 默认值：3	可选 默认隐藏
aoSaturation	AO 饱和度	数据	number	HBAO AO 饱和度 [0, 10]，默认值 1	输入框 默认值：1	可选 默认隐藏
needBlur	模糊开关	数据	boolean	HBAO 模糊开关，默认 true	开关 默认值：true	可选 默认隐藏

输出引脚

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

使用场景

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

注意事项

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