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

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() 时创建的。

extends AudioEffect

@export var strength = 4.0

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

    return effect

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