尧图网站建设 
文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载导读本篇指南围绕 Godot Engine 官方文档中的AudioEffectBandPassFilter类展开系统讲解带通滤波器的数学原理、与带阻BandLimit/Notch等滤波器的区别、在音频总线上的完整配置方法以及模拟电话音、老式扬声器和哇音吉他等经典音色的实战技巧。读完本文你将掌握在 Godot 项目中正确添加带通滤波器、调校 cutoff 与 resonance 参数并实时调制音色的完整能力。一、什么是带通滤波器AudioEffectBandPassFilter是 Godot 官方文档中定义的一种音频总线效果器其核心行为是允许 cutoff_hz 阈值频率附近的频段原样通过pass unchanged同时衰减阈值之外的频率。官方类参考 class_audioeffectbandpassfilter.rst 明确指出它是AudioEffectBandLimitFilter带阻/带限与AudioEffectNotchFilter陷波的对立形态。从继承链看它的位置非常清晰AudioEffectBandPassFilter └─ AudioEffectFilter基类提供 cutoff_hz、resonance、db 等通用属性 └─ AudioEffect └─ Resource └─ RefCounted └─ Object也就是说带通滤波器本身没有新增任何独有属性全部参数都继承自 AudioEffectFilter。官方文档在 audio_effects.rst 中这样概括它的用途带通滤波器允许 cutoff 点附近的频率原样通过衰减该点之外的频率。它是带限滤波器与陷波滤波器的对立面。该滤波器可用于模拟声音通过老式电话线或扩音器megaphone的效果调制 cutoff 点可以模拟哇音吉他踏板wah-wah guitar pedal的声音比如 Jimi Hendrix《Voodoo Child (Slight Return)》中的吉他。1.1 与相邻滤波器家族的关系Godot 的滤波器家族全部继承自AudioEffectFilter官方文档将其划分为三类带通滤波器属于带通/带阻/陷波这一组滤波器类型行为特征典型用途官方文档AudioEffectBandPassFilter带通保留 cutoff 附近频段衰减其余频率模拟老式电话、扩音器、哇音吉他AudioEffectBandLimitFilter带限/带阻衰减 cutoff 附近频段保留其余频率比陷波更宽更弱为其他声音腾出频段空间AudioEffectNotchFilter陷波衰减 cutoff 附近频段比带限更窄更强彻底移除某个特定、不想要的频率AudioEffectLowPassFilter低通衰减高于 cutoff 的频率模拟水下、隔墙、远处等闷的声音AudioEffectHighPassFilter高通衰减低于 cutoff 的频率去除低频力度为贝斯和冲击音让出低频空间AudioEffectLowShelfFilter低架控制 cutoff 以下所有频率的增益调整声音的低频强度AudioEffectHighShelfFilter高架控制 cutoff 以上所有频率的增益提升或降低声音的清晰度这一家族关系的权威出处是 class_audioeffectfilter.rst它同时强调基类 AudioEffectFilter 不应被直接使用应始终选择继承它的具体效果器。1.2 官方文档给出的核心应用场景官方对AudioEffectBandPassFilter的场景描述高度凝练原文要点如下模拟弱扬声器的声音文档在类参考中直接写明 This filter can be used to emulate sounds coming from weak speakersclass_audioeffectbandpassfilter.rst电话音/扩音器效果音色教程中强调可模拟老式电话线或 megaphone 的窄带声音质感audio_effects.rst哇音吉他效果通过动态调制 cutoff 点模拟 wah-wah 踏板为混音腾出空间与带阻/陷波互补让其他声音在目标频段更有存在感。二、参数详解继承自 AudioEffectFilter 的四个核心属性带通滤波器的全部调校都落在基类的四个属性上。官方文档在 class_audioeffectfilter.rst 中给出了完整的属性表与默认值属性类型默认值含义cutoff_hzfloat2000.0滤波器频率阈值Hz范围 1 ~ 20500dbFilterDB枚举0FILTER_6DB截止曲线的陡峭度每倍频程 dB 数即滤波器阶数gainfloat1.0受影响频率的增益范围 0 ~ 4仅低架/高架滤波器可用resonancefloat0.5cutoff 频率处及其附近的增益范围 0 ~ 12.1 cutoff_hz频率阈值官方文档定义为滤波器的频率阈值单位 Hz取值范围 1 到 20500class_audioeffectfilter.rst。在带通滤波器语境下它决定了哪一段频率原样通过的中心位置低于或高于该值越远的频率被衰减得越厉害。对应底层访问方法为set_cutoff(value)与get_cutoff()可在运行时动态修改以实现哇音等调制效果。2.2 db截止斜率滤波器阶数db属性决定截止曲线的陡峭度官方枚举定义如下class_audioeffectfilter.rst枚举常量值含义FILTER_6DB0每倍频程衰减 6 dB一阶FILTER_12DB1每倍频程衰减 12 dB二阶FILTER_18DB2每倍频程衰减 18 dB三阶FILTER_24DB3每倍频程衰减 24 dB四阶关于倍频程一个倍频程即 cutoff_hz 上方两倍频率或下方一半频率。官方文档明确说明Higher orders have a more aggressive cutoff——阶数越高截止越激进、滤波特性越鲜明。需要说明的是这个 dB 倍频程概念与总线电平的 dB 含义不同前者描述滤波斜率每倍频程多少分贝的衰减速率后者描述音量振幅每 6 dB 响度加倍/减半详见 audio_buses.rst 的分贝刻度章节。2.3 gain受影响频率的增益官方文档明确标注gain 属性仅对低架LowShelf和高架HighShelf滤波器生效取值范围 0 ~ 4class_audioeffectfilter.rst。因此在带通滤波器上该属性不起作用这解释了为何带通滤波器的音色塑造完全依靠 cutoff、resonance 与 db 三者的组合。2.4 resonance共振峰带通滤波器的灵魂参数官方定义cutoff 频率处或紧邻处的增益取值范围 0 ~ 1class_audioeffectfilter.rst。官方文档特别针对带通/带阻/陷波这一组给出了行为说明对于带通和陷波滤波器它会在 cutoff 频率阈值处加宽或收窄滤波器class_audioeffectfilter.rst。实际效果resonance 越高cutoff 中心处出现一个越尖锐的共振峰类似哨音的鼻音质感带通频带收窄、选择性更强resonance 越低频带更宽、更平坦。这正是模拟电话音窄而尖质感的关键旋钮。三、如何在音频总线中添加带通滤波器3.1 前置知识音频总线机制Godot 的音频引擎允许创建任意数量的音频总线每条总线可挂载任意数量的效果处理器只有设备硬件性能会成为上限audio_buses.rst。总线位于编辑器底部面板最左侧是Master总线其余总线可灵活路由声音始终从右往左传递以避免无限路由循环。音频通过总线播放的标准流程是创建AudioStreamPlayer节点 → 加载AudioStream→ 选择目标总线 → 开启Playing属性。详见 audio_buses.rst。3.2 编辑器中的操作步骤打开编辑器底部面板的Audio选项卡在目标总线如新建的 Effects 总线或直接选 Master上点击Add Effect从效果列表中选取BandPassFilter在效果器面板中调整Cutoff (Hz)、Resonance与DB三个参数将需要处理的AudioStreamPlayer的Bus属性指向该总线播放即可听到滤波后的声音。3.3 运行时通过代码添加AudioServer API在代码中带通滤波器与其他 AudioEffect 一样是普通的Resource可通过AudioServer.add_bus_effect()动态挂载到总线。相关 API 在 class_audioserver.rst 中有完整定义# 创建一个带通滤波器资源 var band_pass : AudioEffectBandPassFilter.new() band_pass.cutoff_hz 1500.0 # 保留 1500 Hz 附近的频段 band_pass.resonance 0.7 # 较高的共振塑造鼻音质感 band_pass.db AudioEffectFilter.FILTER_12DB # 每倍频程 12 dB 的截止斜率 # 获取Effect总线的索引并把滤波器挂到该总线上 var bus_idx : AudioServer.get_bus_index(Effect) AudioServer.add_bus_effect(bus_idx, band_pass) # 运行时动态调制 cutoff 以实现哇音/扫频效果 band_pass.cutoff_hz 500.0 3000.0 * (0.5 0.5 * sin(Time.get_ticks_msec() / 1000.0))关键 API 一览均定义于 class_audioserver.rst方法签名要点用途add_bus_effect(bus_idx: int, effect: AudioEffect, at_position: int -1)将效果添加到指定总线at_position指定插入位置默认 -1 表示追加到末尾get_bus_index(bus_name: StringName) - int按名称取总线索引get_bus_effect(bus_idx: int, effect_idx: int) - AudioEffect读取总线上指定位置的效果get_bus_effect_count(bus_idx: int) - int统计总线上的效果数量get_bus_effect_instance(bus_idx, effect_idx, channel 0)获取效果实例供频谱分析等高级用途注意官方在 audio_buses.rst 中给出警告——在 Web 平台如果 AudioStreamPlayer 的播放模式为默认的Sample总线效果不受支持只有切换到Stream模式才能生效代价是未启用线程时延迟增加。四、实战用带通滤波器实现三种经典音色4.1 老式电话音Telephone Voice电话的带宽极窄约 300 Hz ~ 3 kHz且带有明显的窄带鼻音。官方文档正是推荐用带通滤波器模拟声音通过老式电话线或扩音器audio_effects.rst。var phone : AudioEffectBandPassFilter.new() phone.cutoff_hz 1500.0 # 中心频率落在人声最清晰的频段 phone.resonance 0.9 # 高共振制造窄而尖的电话质感 phone.db AudioEffectFilter.FILTER_24DB # 陡峭截止彻底切掉带外频率将人物对话的音频流路由到挂载该效果的专用总线即可获得立竿见影的隔着一部老电话的效果。4.2 弱扬声器 / 老式收音机音色官方类参考明确提及该滤波器可用于模拟弱扬声器class_audioeffectbandpassfilter.rst。弱扬声器如廉价喇叭的频响范围窄、中频突出var speaker : AudioEffectBandPassFilter.new() speaker.cutoff_hz 1000.0 speaker.resonance 0.5 # 中等共振保持一定自然度 speaker.db AudioEffectFilter.FILTER_12DB适合用于游戏内场景背景音如走廊里传来的广播、邻居家的电视机。4.3 哇音吉他Wah-Wah官方音色教程指出调制 cutoff 点即可模拟哇音吉他踏板。实现要点是每帧动态改变cutoff_hzextends AudioStreamPlayer var band_pass: AudioEffectBandPassFilter func _ready() - void: var bus_idx : AudioServer.get_bus_index(Master) band_pass AudioEffectBandPassFilter.new() band_pass.cutoff_hz 800.0 band_pass.resonance 0.8 band_pass.db AudioEffectFilter.FILTER_12DB AudioServer.add_bus_effect(bus_idx, band_pass) func _process(delta: float) - void: # 让 cutoff 在 500 Hz ~ 3500 Hz 之间往复扫动 var t : (sin(Time.get_ticks_msec() / 250.0) 1.0) / 2.0 band_pass.cutoff_hz 500.0 t * 3000.0五、与其他滤波器搭配使用的混音技巧带通滤波器的价值常体现在与其他效果器的协作中与 BandLimit / Notch 互补官方文档指出带限滤波器为其他声音在 cutoff 点腾出空间class_audioeffectbandlimitfilter.rst陷波滤波器则因衰减强烈可彻底移除特定且不想要的频率class_audioeffectnotchfilter.rst。三者按需组合可实现精确的频段调度。与低通/高通组合低通制造闷感水下、隔墙高通削掉低频力度audio_effects.rst。带通则是只留一段的极端形态。遵循混音铁律官方在总线文档中提醒混音输出不应超过 0 dB否则产生数字削波clipping失真audio_buses.rst。带通滤波本身会衰减大量频段通常可安全放大后再挂到 Master。总线自动休眠Godot 会检测到总线静默数秒后自动禁用该总线含全部效果因此无需手动开关带通滤波器audio_buses.rst。六、常见误区与使用注意事项gain 参数在带通滤波器上无效官方明确 gain 仅作用于低架/高架滤波器class_audioeffectfilter.rst不要期望通过 gain 提升带通后的响度。cutoff_hz 范围限制官方规定范围为 1 ~ 20500 Hzclass_audioeffectfilter.rst超出范围的值会被引擎约束调制时应注意边界。resonance 过高的副作用resonance 靠近 1.0 时会产生极窄的尖锐共振峰容易让声音刺耳或接近自激振荡感实战中应结合 0.2 ~ 0.9 区间试听。Web 平台限制AudioStreamPlayer 处于 Sample 播放模式时总线效果不可用需切换 Stream 模式audio_buses.rst。不要直接使用 AudioEffectFilter 基类官方明确应使用继承它的具体效果器而非基类本身class_audioeffectfilter.rst。七、参考资料类参考classes/class_audioeffectbandpassfilter.rst继承链、官方描述基类属性classes/class_audioeffectfilter.rstcutoff_hz / db / gain / resonance 完整定义相邻滤波器classes/class_audioeffectbandlimitfilter.rst、classes/class_audioeffectnotchfilter.rst音色教程tutorials/audio/audio_effects.rst带通、带阻、陷波、高通、低通等效果说明总线教程tutorials/audio/audio_buses.rst总线路由、添加效果、dB 刻度运行时 APIclasses/class_audioserver.rstadd_bus_effect、get_bus_index 等赞分享文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载相关推荐Godot 音频带限滤波器 AudioEffectBandLimitFilter 实战指南原理、参数配置与运行时控制Godot 音频带限滤波器 AudioEffectBandLimitFilter 实战指南原理、参数配置与运行时控制 导读 AudioEffectBandLi文档教程游戏开发PuerTS for Unity从 Python 调用 C —— import 机制、泛型实例化与索引器访问实战指南PuerTS for Unity从 Python 调用 C —— import 机制、泛型实例化与索引器访问实战指南 本文围绕 PuerTSUnity 版文档教程游戏开发miniaudio滤波器应用指南低通、高通、带通滤波器实现详解miniaudio滤波器应用指南低通、高通、带通滤波器实现详解 miniaudio是一个功能强大的单文件C语言音频播放和捕获库它提供了丰富的数字信号处理功能音频处理上一篇AWS CLI 实战使用 list-public-keys 查看 CloudFront 账户下的全部公钥下一篇Apache Thrift Node.js 协议模糊测试实战基于 Jazzer.js 的 Fuzz 目标编写与运行指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Godot 音频带通滤波器（AudioEffectBandPassFilter）完全指南：原理、参数配置与实战应用
文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载导读本篇指南围绕 Godot Engine 官方文档中的AudioEffectBandPassFilter类展开系统讲解带通滤波器的数学原理、与带阻BandLimit/Notch等滤波器的区别、在音频总线上的完整配置方法以及模拟电话音、老式扬声器和哇音吉他等经典音色的实战技巧。读完本文你将掌握在 Godot 项目中正确添加带通滤波器、调校 cutoff 与 resonance 参数并实时调制音色的完整能力。一、什么是带通滤波器AudioEffectBandPassFilter是 Godot 官方文档中定义的一种音频总线效果器其核心行为是允许 cutoff_hz 阈值频率附近的频段原样通过pass unchanged同时衰减阈值之外的频率。官方类参考 class_audioeffectbandpassfilter.rst 明确指出它是AudioEffectBandLimitFilter带阻/带限与AudioEffectNotchFilter陷波的对立形态。从继承链看它的位置非常清晰AudioEffectBandPassFilter └─ AudioEffectFilter基类提供 cutoff_hz、resonance、db 等通用属性 └─ AudioEffect └─ Resource └─ RefCounted └─ Object也就是说带通滤波器本身没有新增任何独有属性全部参数都继承自 AudioEffectFilter。官方文档在 audio_effects.rst 中这样概括它的用途带通滤波器允许 cutoff 点附近的频率原样通过衰减该点之外的频率。它是带限滤波器与陷波滤波器的对立面。该滤波器可用于模拟声音通过老式电话线或扩音器megaphone的效果调制 cutoff 点可以模拟哇音吉他踏板wah-wah guitar pedal的声音比如 Jimi Hendrix《Voodoo Child (Slight Return)》中的吉他。1.1 与相邻滤波器家族的关系Godot 的滤波器家族全部继承自AudioEffectFilter官方文档将其划分为三类带通滤波器属于带通/带阻/陷波这一组滤波器类型行为特征典型用途官方文档AudioEffectBandPassFilter带通保留 cutoff 附近频段衰减其余频率模拟老式电话、扩音器、哇音吉他AudioEffectBandLimitFilter带限/带阻衰减 cutoff 附近频段保留其余频率比陷波更宽更弱为其他声音腾出频段空间AudioEffectNotchFilter陷波衰减 cutoff 附近频段比带限更窄更强彻底移除某个特定、不想要的频率AudioEffectLowPassFilter低通衰减高于 cutoff 的频率模拟水下、隔墙、远处等闷的声音AudioEffectHighPassFilter高通衰减低于 cutoff 的频率去除低频力度为贝斯和冲击音让出低频空间AudioEffectLowShelfFilter低架控制 cutoff 以下所有频率的增益调整声音的低频强度AudioEffectHighShelfFilter高架控制 cutoff 以上所有频率的增益提升或降低声音的清晰度这一家族关系的权威出处是 class_audioeffectfilter.rst它同时强调基类 AudioEffectFilter 不应被直接使用应始终选择继承它的具体效果器。1.2 官方文档给出的核心应用场景官方对AudioEffectBandPassFilter的场景描述高度凝练原文要点如下模拟弱扬声器的声音文档在类参考中直接写明 This filter can be used to emulate sounds coming from weak speakersclass_audioeffectbandpassfilter.rst电话音/扩音器效果音色教程中强调可模拟老式电话线或 megaphone 的窄带声音质感audio_effects.rst哇音吉他效果通过动态调制 cutoff 点模拟 wah-wah 踏板为混音腾出空间与带阻/陷波互补让其他声音在目标频段更有存在感。二、参数详解继承自 AudioEffectFilter 的四个核心属性带通滤波器的全部调校都落在基类的四个属性上。官方文档在 class_audioeffectfilter.rst 中给出了完整的属性表与默认值属性类型默认值含义cutoff_hzfloat2000.0滤波器频率阈值Hz范围 1 ~ 20500dbFilterDB枚举0FILTER_6DB截止曲线的陡峭度每倍频程 dB 数即滤波器阶数gainfloat1.0受影响频率的增益范围 0 ~ 4仅低架/高架滤波器可用resonancefloat0.5cutoff 频率处及其附近的增益范围 0 ~ 12.1 cutoff_hz频率阈值官方文档定义为滤波器的频率阈值单位 Hz取值范围 1 到 20500class_audioeffectfilter.rst。在带通滤波器语境下它决定了哪一段频率原样通过的中心位置低于或高于该值越远的频率被衰减得越厉害。对应底层访问方法为set_cutoff(value)与get_cutoff()可在运行时动态修改以实现哇音等调制效果。2.2 db截止斜率滤波器阶数db属性决定截止曲线的陡峭度官方枚举定义如下class_audioeffectfilter.rst枚举常量值含义FILTER_6DB0每倍频程衰减 6 dB一阶FILTER_12DB1每倍频程衰减 12 dB二阶FILTER_18DB2每倍频程衰减 18 dB三阶FILTER_24DB3每倍频程衰减 24 dB四阶关于倍频程一个倍频程即 cutoff_hz 上方两倍频率或下方一半频率。官方文档明确说明Higher orders have a more aggressive cutoff——阶数越高截止越激进、滤波特性越鲜明。需要说明的是这个 dB 倍频程概念与总线电平的 dB 含义不同前者描述滤波斜率每倍频程多少分贝的衰减速率后者描述音量振幅每 6 dB 响度加倍/减半详见 audio_buses.rst 的分贝刻度章节。2.3 gain受影响频率的增益官方文档明确标注gain 属性仅对低架LowShelf和高架HighShelf滤波器生效取值范围 0 ~ 4class_audioeffectfilter.rst。因此在带通滤波器上该属性不起作用这解释了为何带通滤波器的音色塑造完全依靠 cutoff、resonance 与 db 三者的组合。2.4 resonance共振峰带通滤波器的灵魂参数官方定义cutoff 频率处或紧邻处的增益取值范围 0 ~ 1class_audioeffectfilter.rst。官方文档特别针对带通/带阻/陷波这一组给出了行为说明对于带通和陷波滤波器它会在 cutoff 频率阈值处加宽或收窄滤波器class_audioeffectfilter.rst。实际效果resonance 越高cutoff 中心处出现一个越尖锐的共振峰类似哨音的鼻音质感带通频带收窄、选择性更强resonance 越低频带更宽、更平坦。这正是模拟电话音窄而尖质感的关键旋钮。三、如何在音频总线中添加带通滤波器3.1 前置知识音频总线机制Godot 的音频引擎允许创建任意数量的音频总线每条总线可挂载任意数量的效果处理器只有设备硬件性能会成为上限audio_buses.rst。总线位于编辑器底部面板最左侧是Master总线其余总线可灵活路由声音始终从右往左传递以避免无限路由循环。音频通过总线播放的标准流程是创建AudioStreamPlayer节点 → 加载AudioStream→ 选择目标总线 → 开启Playing属性。详见 audio_buses.rst。3.2 编辑器中的操作步骤打开编辑器底部面板的Audio选项卡在目标总线如新建的 Effects 总线或直接选 Master上点击Add Effect从效果列表中选取BandPassFilter在效果器面板中调整Cutoff (Hz)、Resonance与DB三个参数将需要处理的AudioStreamPlayer的Bus属性指向该总线播放即可听到滤波后的声音。3.3 运行时通过代码添加AudioServer API在代码中带通滤波器与其他 AudioEffect 一样是普通的Resource可通过AudioServer.add_bus_effect()动态挂载到总线。相关 API 在 class_audioserver.rst 中有完整定义# 创建一个带通滤波器资源 var band_pass : AudioEffectBandPassFilter.new() band_pass.cutoff_hz 1500.0 # 保留 1500 Hz 附近的频段 band_pass.resonance 0.7 # 较高的共振塑造鼻音质感 band_pass.db AudioEffectFilter.FILTER_12DB # 每倍频程 12 dB 的截止斜率 # 获取Effect总线的索引并把滤波器挂到该总线上 var bus_idx : AudioServer.get_bus_index(Effect) AudioServer.add_bus_effect(bus_idx, band_pass) # 运行时动态调制 cutoff 以实现哇音/扫频效果 band_pass.cutoff_hz 500.0 3000.0 * (0.5 0.5 * sin(Time.get_ticks_msec() / 1000.0))关键 API 一览均定义于 class_audioserver.rst方法签名要点用途add_bus_effect(bus_idx: int, effect: AudioEffect, at_position: int -1)将效果添加到指定总线at_position指定插入位置默认 -1 表示追加到末尾get_bus_index(bus_name: StringName) - int按名称取总线索引get_bus_effect(bus_idx: int, effect_idx: int) - AudioEffect读取总线上指定位置的效果get_bus_effect_count(bus_idx: int) - int统计总线上的效果数量get_bus_effect_instance(bus_idx, effect_idx, channel 0)获取效果实例供频谱分析等高级用途注意官方在 audio_buses.rst 中给出警告——在 Web 平台如果 AudioStreamPlayer 的播放模式为默认的Sample总线效果不受支持只有切换到Stream模式才能生效代价是未启用线程时延迟增加。四、实战用带通滤波器实现三种经典音色4.1 老式电话音Telephone Voice电话的带宽极窄约 300 Hz ~ 3 kHz且带有明显的窄带鼻音。官方文档正是推荐用带通滤波器模拟声音通过老式电话线或扩音器audio_effects.rst。var phone : AudioEffectBandPassFilter.new() phone.cutoff_hz 1500.0 # 中心频率落在人声最清晰的频段 phone.resonance 0.9 # 高共振制造窄而尖的电话质感 phone.db AudioEffectFilter.FILTER_24DB # 陡峭截止彻底切掉带外频率将人物对话的音频流路由到挂载该效果的专用总线即可获得立竿见影的隔着一部老电话的效果。4.2 弱扬声器 / 老式收音机音色官方类参考明确提及该滤波器可用于模拟弱扬声器class_audioeffectbandpassfilter.rst。弱扬声器如廉价喇叭的频响范围窄、中频突出var speaker : AudioEffectBandPassFilter.new() speaker.cutoff_hz 1000.0 speaker.resonance 0.5 # 中等共振保持一定自然度 speaker.db AudioEffectFilter.FILTER_12DB适合用于游戏内场景背景音如走廊里传来的广播、邻居家的电视机。4.3 哇音吉他Wah-Wah官方音色教程指出调制 cutoff 点即可模拟哇音吉他踏板。实现要点是每帧动态改变cutoff_hzextends AudioStreamPlayer var band_pass: AudioEffectBandPassFilter func _ready() - void: var bus_idx : AudioServer.get_bus_index(Master) band_pass AudioEffectBandPassFilter.new() band_pass.cutoff_hz 800.0 band_pass.resonance 0.8 band_pass.db AudioEffectFilter.FILTER_12DB AudioServer.add_bus_effect(bus_idx, band_pass) func _process(delta: float) - void: # 让 cutoff 在 500 Hz ~ 3500 Hz 之间往复扫动 var t : (sin(Time.get_ticks_msec() / 250.0) 1.0) / 2.0 band_pass.cutoff_hz 500.0 t * 3000.0五、与其他滤波器搭配使用的混音技巧带通滤波器的价值常体现在与其他效果器的协作中与 BandLimit / Notch 互补官方文档指出带限滤波器为其他声音在 cutoff 点腾出空间class_audioeffectbandlimitfilter.rst陷波滤波器则因衰减强烈可彻底移除特定且不想要的频率class_audioeffectnotchfilter.rst。三者按需组合可实现精确的频段调度。与低通/高通组合低通制造闷感水下、隔墙高通削掉低频力度audio_effects.rst。带通则是只留一段的极端形态。遵循混音铁律官方在总线文档中提醒混音输出不应超过 0 dB否则产生数字削波clipping失真audio_buses.rst。带通滤波本身会衰减大量频段通常可安全放大后再挂到 Master。总线自动休眠Godot 会检测到总线静默数秒后自动禁用该总线含全部效果因此无需手动开关带通滤波器audio_buses.rst。六、常见误区与使用注意事项gain 参数在带通滤波器上无效官方明确 gain 仅作用于低架/高架滤波器class_audioeffectfilter.rst不要期望通过 gain 提升带通后的响度。cutoff_hz 范围限制官方规定范围为 1 ~ 20500 Hzclass_audioeffectfilter.rst超出范围的值会被引擎约束调制时应注意边界。resonance 过高的副作用resonance 靠近 1.0 时会产生极窄的尖锐共振峰容易让声音刺耳或接近自激振荡感实战中应结合 0.2 ~ 0.9 区间试听。Web 平台限制AudioStreamPlayer 处于 Sample 播放模式时总线效果不可用需切换 Stream 模式audio_buses.rst。不要直接使用 AudioEffectFilter 基类官方明确应使用继承它的具体效果器而非基类本身class_audioeffectfilter.rst。七、参考资料类参考classes/class_audioeffectbandpassfilter.rst继承链、官方描述基类属性classes/class_audioeffectfilter.rstcutoff_hz / db / gain / resonance 完整定义相邻滤波器classes/class_audioeffectbandlimitfilter.rst、classes/class_audioeffectnotchfilter.rst音色教程tutorials/audio/audio_effects.rst带通、带阻、陷波、高通、低通等效果说明总线教程tutorials/audio/audio_buses.rst总线路由、添加效果、dB 刻度运行时 APIclasses/class_audioserver.rstadd_bus_effect、get_bus_index 等赞分享文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载相关推荐Godot 音频带限滤波器 AudioEffectBandLimitFilter 实战指南原理、参数配置与运行时控制Godot 音频带限滤波器 AudioEffectBandLimitFilter 实战指南原理、参数配置与运行时控制 导读 AudioEffectBandLi文档教程游戏开发PuerTS for Unity从 Python 调用 C —— import 机制、泛型实例化与索引器访问实战指南PuerTS for Unity从 Python 调用 C —— import 机制、泛型实例化与索引器访问实战指南 本文围绕 PuerTSUnity 版文档教程游戏开发miniaudio滤波器应用指南低通、高通、带通滤波器实现详解miniaudio滤波器应用指南低通、高通、带通滤波器实现详解 miniaudio是一个功能强大的单文件C语言音频播放和捕获库它提供了丰富的数字信号处理功能音频处理上一篇AWS CLI 实战使用 list-public-keys 查看 CloudFront 账户下的全部公钥下一篇Apache Thrift Node.js 协议模糊测试实战基于 Jazzer.js 的 Fuzz 目标编写与运行指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考