AudioEffect

继承： Resource < RefCounted < Object

派生： AudioEffectAmplify, AudioEffectCapture, AudioEffectChorus, AudioEffectCompressor, AudioEffectDelay, AudioEffectDistortion, AudioEffectEQ, AudioEffectFilter, AudioEffectHardLimiter, AudioEffectLimiter, AudioEffectPanner, AudioEffectPhaser, AudioEffectPitchShift, AudioEffectRecord, AudioEffectReverb, AudioEffectSpectrumAnalyzer, AudioEffectStereoEnhance

音频效果资源的基类。

描述

音频效果的基础 Resource。在编辑器中，可以在“音频”面板中为当前的总线布局添加音频效果。在运行时，也可以通过 AudioServer.add_bus_effect、AudioServer.remove_bus_effect、AudioServer.get_bus_effect 来操作音频效果。

应用到总线时，音频效果会创建一个对应的 AudioEffectInstance 实例。由这个实例来负责根据原始音频效果的属性操作声音。

教程

• 音频总线

• 音频麦克风录音演示

方法

方法说明

AudioEffectInstance _instantiate() virtual 🔗

覆盖该方法以自定义新创建的 AudioEffectInstance，它是在编辑器的音频面板中将该效果应用于总线时，或通过 AudioServer.add_bus_effect 时创建的。

extends AudioEffect
@export var strength = 4.0
func _instantiate():
    var effect = CustomAudioEffectInstance.new()
    effect.base = self
    return effect

注意：建议在新实例中保留对原始 AudioEffect 的引用。根据实现，这允许效果实例在运行时监听更改并进行相应的修改。