audio_effect_create

此函数创建新的音频效果,并返回AudioEffect 结构,您可以通过它访问和修改它。或者,您可以将结构传递给函数以立即初始化效果的参数。

有关可创建的音频效果列表,请参见AudioEffectType 枚举

返回结构的成员取决于创建的音频效果的类型。有关所有可能的音频效果结构,请参见:音频效果结构

 

语法:

audio_effect_create(type, [params]);

参数类型描述
typeAudioEffectType Enum要创建的音频效果类型(例如AudioEffectType.Reverb1)
paramsStruct可选 音效参数(可选参数见音效结构)

 

返回:

AudioEffect Struct

 

示例1:

var _ef_distortion = audio_effect_create(AudioEffectType.Bitcrusher);
_ef_distortion.gain = 1.1;
_ef_distortion.factor = 20;
_ef_distortion.resolution = 8;
_ef_distortion.mix = 0.5;
audio_bus_main.effects[0] = _ef_distortion;

上面的代码首先使用 audio_effect_create 创建新的失真效果类型 AudioEffectType.Bitcrusher。然后通过设置效果参数来配置效果。

最后,它将效果分配给主音频总线,由主音频总线开始处理效果。

 

示例2:

audio_bus_main.effects[0] = audio_effect_create(AudioEffectType.Bitcrusher, {
    gain: 1.1, factor: 20, resolution: 8, mix: 0.5
});

上面的代码首先创建一个新的失真效果,如示例1所示,并通过传递一个包含某些参数的值的结构来立即初始化其参数。