Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

AudioEffectHardLimiter

继承： AudioEffect < Resource < RefCounted < Object

向音频总线添加一个限制器音频效果。

防止音频信号超过指定的音量电平。

描述

“限制器”可以防止音频信号超过给定的音量分贝阈值。硬限制器预测音量峰值，并将在峰值超过上限阈值时平滑地应用增益衰减，以防止削波。它能保持波形并防止波形超过上限阈值。建议在主总线上添加一个作为安全措施，以防止音量突然达到峰值，并防止音量超过 0 分贝时由削波引起的失真。

如果需要削波，请考虑 AudioEffectDistortion.MODE_CLIP。

教程

• 音频总线

• 音效

属性

float	ceiling_db	-0.3
float	pre_gain_db	0.0
float	release	0.1

---

属性说明

float ceiling_db = -0.3 🔗

• void set_ceiling_db(value: float)

• float get_ceiling_db()

波形的最大允许值，单位为分贝。取值范围在 -24 到 0 之间。

默认值 -0.3 可以防止潜在的采样间峰值（ISP）超过 0 分贝，从而避免在一些较旧的硬件设备上产生轻微的失真。

---

float pre_gain_db = 0.0 🔗

• void set_pre_gain_db(value: float)

• float get_pre_gain_db()

限制前的增益，单位为分贝。取值范围为 -24 至 24。

---

float release = 0.1 🔗

• void set_release(value: float)

• float get_release()

增益衰减至完全释放所需的时间，单位为秒。取值范围为 0.01 至 3。