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...

AudioEffectDelay

继承： AudioEffect < Resource < RefCounted < Object

为音频总线添加延迟音频效果。

通过在一段时间后重新播放输入音频来模拟回声效果。

描述

“延迟”效果会在一段时间后将输入的音频信号重新播放。每次重复都称为一个“延迟抽头”或简称为“抽头”。通过多次回放延迟抽头可以创建反复出现且逐渐衰减的回声。延迟效果的跨度很大，既可以是轻微的回声，也可以是先前声音与新声音明显混合的效果。

另见 AudioEffectReverb，以了解模糊而连续的回声效果。

教程

属性

float

dry

1.0

bool

feedback_active

false

float

feedback_delay_ms

340.0

float

feedback_level_db

-6.0

float

feedback_lowpass

16000.0

bool

tap1_active

true

float

tap1_delay_ms

250.0

float

tap1_level_db

-6.0

float

tap1_pan

0.2

bool

tap2_active

true

float

tap2_delay_ms

500.0

float

tap2_level_db

-12.0

float

tap2_pan

-0.4

属性说明

float dry = 1.0 🔗

原始音频的音量比例。取值范围为 0 到 1。

bool feedback_active = false 🔗

  • void set_feedback_active(value: bool)

  • bool is_feedback_active()

如果为 true，则启用反馈，在播放抽头后重复它们。

float feedback_delay_ms = 340.0 🔗

  • void set_feedback_delay_ms(value: float)

  • float get_feedback_delay_ms()

反馈延迟时间，单位为毫秒。取值范围为 0 至 1500。

float feedback_level_db = -6.0 🔗

  • void set_feedback_level_db(value: float)

  • float get_feedback_level_db()

反馈增益，单位为分贝。取值范围为 -60 至 0。

float feedback_lowpass = 16000.0 🔗

  • void set_feedback_lowpass(value: float)

  • float get_feedback_lowpass()

反馈的低通滤波器，单位为 Hz。高于此值的频率将被滤除。取值范围为 1 至 16000。

bool tap1_active = true 🔗

  • void set_tap1_active(value: bool)

  • bool is_tap1_active()

如果为 true，将启用首个抽头。

float tap1_delay_ms = 250.0 🔗

  • void set_tap1_delay_ms(value: float)

  • float get_tap1_delay_ms()

相对于原始音频的首个抽头延迟时间，以毫秒为单位。取值范围为 0 至 1500。

float tap1_level_db = -6.0 🔗

  • void set_tap1_level_db(value: float)

  • float get_tap1_level_db()

首个抽头的增益，单位为分贝。取值范围为 -60 到 0。

float tap1_pan = 0.2 🔗

  • void set_tap1_pan(value: float)

  • float get_tap1_pan()

首个延迟抽头的声像位置。负值将声音向左平移，正值向右平移。取值范围为 -1 至 1。

bool tap2_active = true 🔗

  • void set_tap2_active(value: bool)

  • bool is_tap2_active()

如果为 true，将启用第二拍。

float tap2_delay_ms = 500.0 🔗

  • void set_tap2_delay_ms(value: float)

  • float get_tap2_delay_ms()

相对于原始音频的第二个抽头的延迟时间，以毫秒为单位。取值范围为 0 到 1500。

float tap2_level_db = -12.0 🔗

  • void set_tap2_level_db(value: float)

  • float get_tap2_level_db()

第二个抽头的增益，单位为分贝。取值范围为 -60 至 0。

float tap2_pan = -0.4 🔗

  • void set_tap2_pan(value: float)

  • float get_tap2_pan()

第二个抽头的声像位置。负值将声音向左平移，正值向右平移。取值范围为 -1 到 1。