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 required

方法說明

AudioEffectInstance _instantiate() virtual required 🔗

覆寫此方法，可自訂在編輯器「音訊」面板或 AudioServer.add_bus_effect() 套用效果時所建立的 AudioEffectInstance。

extends AudioEffect

@export var strength = 4.0

func _instantiate():
    var effect = CustomAudioEffectInstance.new()
    effect.base = self

    return effect

注意： 建議在新實例中保留對原 AudioEffect 的參考，以便於執行時偵測屬性變化並相應調整。