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 _instantiate() virtual 🔗

覆盖此方法以自定义在编辑器的音频面板中应用此效果时创建的AudioEffectInstance，或者通过AudioServer.add_bus_effect()创建的AudioEffectInstance。

extends AudioEffect



@export var strength = 4.0



func _instantiate():

        var effect = CustomAudioEffectInstance.new()

        effect.base = self



        return effect

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