尧图网站建设 
文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载AudioEffectLowShelfFilter低频搁架滤波器是 Godot 引擎内置音频效果之一用于在音频总线上控制所有低于指定截止频率cutoff_hz频段的增益是调整声音力度strength与低频厚度的核心工具。本文以 class_audioeffectlowshelffilter.rst 为主体结合其基类 AudioEffectFilter 的完整参数定义与 AudioServer 的运行时 API系统讲解低频搁架滤波器的声学原理、每一个可调参数的含义与取值范围、在编辑器与脚本两种场景下的配置方法以及它与其他滤波器高通、低通、搁架、带通等的选型差异。读完本文你将能够独立在 Godot 项目中为任意音频总线添加、调校并动态控制一个低频搁架滤波器让低频饱满而不浑浊、人声清晰而不发闷。什么是低频搁架Low-Shelf滤波器在 AudioEffectLowShelfFilter 的官方类描述中其核心定义只有一句话Adds a low-shelf filter to an audio bus. A low-shelf filter controls the gain of all frequencies belowcutoff_hz.搁架shelf是 EQ 领域的经典滤波形状它在截止频率以下的部分对整体频段做统一的增益提升或衰减而在截止频率以上的部分几乎不产生影响增益响应曲线在频谱图上呈现出一个搁板形状。与之相对的是高通/低通pass滤波器——后者会直接切除截止频率一侧的频率成分而非仅调整增益。在 Godot 中低频搁架滤波器可以增加声音的力量感提升低频增益让鼓点、低音、爆炸声更有冲击力削减浑浊感衰减低频增益为其他声音如人声、对白腾出频段空间模拟设备限制衰减低频模拟电话听筒、老式收音机等窄带听感。官方 Audio effects 教程 对 LowShelfFilter 的定位描述如下A low-shelf filter controls the gain of all frequencies below thecutoffpoint. This filter can be used to adjust the strength of a sound, by increasing or decreasing the gain of the bass range.这与高通滤波器移除低频内容让声音变薄、低频搁架滤波器整体调节低频增益形成了明确的职责区分。继承体系所有滤波器共享的基类AudioEffectLowShelfFilter不定义自己的独立属性它的一切参数都继承自基类AudioEffectFilter。其完整继承链为AudioEffectLowShelfFilter AudioEffectFilter AudioEffect Resource RefCounted Object从 AudioEffectFilter 的文档可以看到Godot 中一共有 7 个滤波器类共享这一套参数体系搁架滤波器Shelf filtersAudioEffectLowShelfFilter低频搁架与AudioEffectHighShelfFilter高频搁架用于提升/衰减高频清晰度带通与陷波Band-pass and notchAudioEffectBandPassFilter、AudioEffectBandLimitFilter、AudioEffectNotchFilter高通/低通Low/high-passAudioEffectLowPassFilter与AudioEffectHighPassFilter。基类文档特别强调Use effects that inherit this class instead of using it directly——不要直接实例化AudioEffectFilter而应使用其派生类。同时Audio effects 教程 中的 Filter 小节也提示该效果不应直接使用它是其他滤波器的公共父类。在实现层面所有效果都以Resource形式存在可以序列化到音频总线布局文件如res://default_bus_layout.tres中也可以像普通资源一样在代码中new出来使用。核心参数详解cutoff_hz、db、gain 与 resonanceAudioEffectLowShelfFilter的全部可调参数定义在基类 AudioEffectFilter 的属性表中共 4 个。下表完整列出其类型、默认值与说明属性类型默认值取值范围说明cutoff_hzfloat2000.01 ~ 20500滤波器的频率阈值Hz。低于该频率的频段受搁架滤波器增益控制dbFilterDB枚举0FILTER_6DB0 ~ 3截止曲线的陡度单位为 dB/倍频程即滤波器的阶数gainfloat1.00 ~ 4受滤波器影响频段的增益倍数。仅对 LowShelf 与 HighShelf 两种搁架滤波器生效resonancefloat0.50 ~ 1截止频率点处或其紧邻频带的增益行为随滤波器类型不同而不同cutoff_hz截止频率对应 setter/getterset_cutoff(value)/get_cutoff()。cutoff_hz是搁架滤波器的分界点所有低于该频率的频段都受gain控制高于该频率的频段基本不受影响。其取值范围为 1 到 20500 Hz覆盖了从次声波边缘到人耳听觉上限的整个可听范围。默认值 2000 Hz 处于中频偏低的位置——在这个阈值下提升增益主要影响的是低频与中低频的身体感。实际调音建议想让底鼓/贝斯更厚实可将cutoff_hz设在 80~250 Hz 之间再配合增益提升想让对白人声更突出、降低伴奏低频干扰可将cutoff_hz设在 150~300 Hz 并略微衰减增益需要配合音乐风格整体压低低频如电话音效果时可将阈值设到 400~1000 Hz 并大幅衰减。db滤波曲线陡度倍频程 dB 数对应 setter/getterset_db(value)/get_db()。db是枚举类型FilterDB决定搁架曲线从平坦过渡到目标增益有多陡也就是滤波器阶数order。基类文档将其定义为截止曲线在每倍频程octave上的陡度——倍频程即截止频率上方两倍频率或下方一半频率。常量值含义FILTER_6DB0每倍频程 6 dB一阶曲线最平缓过渡最自然FILTER_12DB1每倍频程 12 dB二阶FILTER_18DB2每倍频程 18 dB三阶FILTER_24DB3每倍频程 24 dB四阶曲线最陡截止效果最激进文档明确指出Higher orders have a more aggressive cutoff阶数越高截止越激进。对于搁架滤波器而言较低的阶数6/12 dB能做出更暖、更平滑的低频过渡适合音乐性调音较高的阶数18/24 dB则更接近切除效果适合需要明显频段隔离的场合。gain受控频段的增益搁架滤波器专属对应 setter/getterset_gain(value)/get_gain()。gain是搁架滤波器的灵魂参数——它决定了截止频率以下频段被放大还是衰减多少。需要特别注意的是基类文档明确标注Gain of the frequencies affected by the filter. This property is only available forAudioEffectLowShelfFilterandAudioEffectHighShelfFilter.也就是说gain只在两种搁架滤波器上生效高通/低通/带通/陷波滤波器不会使用该属性它们自身也没有提升某频段的能力。取值范围为 0 到 4gain 1.0默认频率响应不改变滤波器处于旁路效果gain 1.0提升低频增益让声音更厚实、更有力量gain 1.0衰减低频增益让声音更薄、更干净。AudioEffectLowShelfFilter的类描述正是围绕这一参数展开的This filter can be used to adjust the strength of a sound, by increasing or decreasing its low-end通过提升或衰减低频来调整声音的力度。在编辑器界面上增益通常以线性倍数显示如需换算为 dB可参考 Audio buses 教程 中关于分贝标度的说明每 6 dB 对应振幅加倍或减半。resonance截止点共振对应 setter/getterset_resonance(value)/get_resonance()。resonance控制截止频率点或其紧邻频带的增益取值范围 0 到 1默认 0.5。基类文档详细说明了它随滤波器类型而不同的行为搁架滤波器含 LowShelf通过提升紧邻截止频率的频段、衰减另一侧频段来强调或掩盖阶数效果——通俗地说更大的 resonance 会让截止点附近出现一个明显的峰或谷使滤波特征更有声有色带通/陷波滤波器用于在截止点处加宽或收窄滤波带宽高通/低通滤波器用于在截止点处增强或削弱频率响应。对低频搁架滤波器而言resonance配合db可以制造出类似低音强调的 Q 值感但需要注意过大的 resonance 会让截止点附近的频率出现明显隆起在某些素材上可能产生嗡嗡声。实战一在音频总线上添加 LowShelfFilter编辑器操作Godot 的所有音频效果都挂在**音频总线Audio Bus**上任何经过该总线的声音都会依次被总线上的效果链处理。在编辑器中操作如下打开编辑器底部的Audio音频面板可以看到音频总线列表最左侧是Master主总线详见 Audio buses 教程 的总线介绍选中一条非 Master 总线或 Master 本身点击总线单元上的Add Effect下拉菜单在效果列表中选择LowShelfFilter。效果会按添加顺序依次作用因此请把它放在效果链中合理的位置如放在均衡/压缩之前或之后视混音需求而定在效果参数面板中调整cutoff_hz、db、gain、resonance四个参数实时试听总线上的声音。Godot 编辑器的效果列表即对应引擎内置的全部音频效果LowShelfFilter与 Amplify、BandLimitFilter、BandPassFilter、Chorus、Compressor 等并列展示界面示意见 tutorials/audio/img/audio_buses4.webp效果列表位于总线面板的 Add Effect 菜单中总线布局默认自动保存到res://default_bus_layout.tres自定义布局也可通过Load / Save As按钮另存之后随项目一起打包分发。需要注意官方 Audio buses 教程 提示音频效果功能在 Web 平台上有使用限制——若AudioStreamPlayer的播放模式为默认的Sample效果不生效只有在Stream模式下才可用但会增加延迟。开发 Web 导出版本时务必检查这一设置。实战二通过脚本动态创建与调节GDScript / C#低频搁架滤波器同样可以在运行时通过代码动态添加和修改。Godot 提供了一套完整的总线效果运行时 API定义在 AudioServer 中常用的包括add_bus_effect(bus_idx, effect, at_position -1)向指定总线添加效果-1表示追加到效果链末尾get_bus_index(bus_name)按名称获取总线索引总线名称比索引更稳定详见下文总线重排说明get_bus_effect(bus_idx, effect_idx)获取总线上某个位置的效果引用用于后续改参get_bus_effect_count(bus_idx)获取总线上的效果数量set_bus_effect_enabled(bus_idx, effect_idx, enabled)动态开关某个效果set_bus_bypass_effects(bus_idx, enable)一键旁路总线上全部效果方便 A/B 对比。以下 GDScript 示例演示了如何创建低频搁架滤波器并挂到指定总线# 获取名为 Music 的总线索引不存在时返回 -1请先确认总线已存在 var bus_idx : AudioServer.get_bus_index(Music) # 创建低频搁架滤波器资源 var low_shelf : AudioEffectLowShelfFilter.new() low_shelf.cutoff_hz 200.0 # 截止频率只影响 200 Hz 以下的频段 low_shelf.db AudioEffectFilter.FILTER_12DB # 每倍频程 12 dB中等陡度 low_shelf.gain 1.8 # 低频增益提升到 1.8 倍让低音更重 low_shelf.resonance 0.6 # 截止点附近轻微强调 # 添加到总线的效果链末尾 AudioServer.add_bus_effect(bus_idx, low_shelf)对应的 C# 版本int busIdx AudioServer.GetBusIndex(Music); var lowShelf new AudioEffectLowShelfFilter { CutoffHz 200.0f, Db AudioEffectFilter.FilterDb.Filter12Db, Gain 1.8f, Resonance 0.6f }; AudioServer.AddBusEffect(busIdx, lowShelf);运行期间还可以随时调整参数并动态开关效果例如做一个低频逐渐增强的过场func _process(delta: float) - void: var shelf : AudioServer.get_bus_effect(bus_idx, 0) as AudioEffectLowShelfFilter shelf.gain min(shelf.gain delta * 0.5, 2.5) # 对比效果先旁路再恢复 AudioServer.set_bus_effect_enabled(bus_idx, 0, false) # 临时关闭低频搁架 AudioServer.set_bus_effect_enabled(bus_idx, 0, true) # 重新启用如果你通过脚本创建总线还可以结合AudioServer.add_bus(at_position)与set_bus_name(bus_idx, name)先建总线再挂效果。参考 recording_with_microphone.rst 中get_bus_indexget_bus_effect的用法模式可以确认这套 API 在录制、效果访问等场景下是被官方教程实际采用的标准做法。关于总线重排的细节Audio buses 教程 指出 Stream Player 通过总线名称引用总线添加/移动总线不会丢失引用但重命名总线会导致引用失效并回落到Master。因此动态脚本中应优先用名称查索引而不是硬编码索引号。与其他滤波器/效果器的选型对比低频搁架滤波器只是 AudioEffectFilter 家族的一员弄清它与近邻效果的区别才能选对工具需求推荐效果理由整体提升/衰减低频保留低频内容LowShelfFilter只调整低频增益不切除频率提升/衰减高频清晰度HighShelfFilter与 LowShelf 对称控制截止频率以上的频段切除低频让声音变薄HighPassFilter直接衰减截止频率以下的内容切除高频模拟闷响/水下声LowPassFilter直接衰减截止频率以上的内容突出/隔离某一窄带BandPassFilter保留截止点附近频段衰减两侧去除某个特定窄带频率NotchFilter / BandLimitFilter在截止点处挖坑为其他声音腾空间从 audio_effects.rst 的对比描述可以提炼出核心判断依据搁架Shelf调增益频率不被移除只是被整体放大或缩小——LowShelf 管低频段HighShelf 管高频段高通/低通Pass切频率一侧频率被明显衰减声音质感会发生结构性变化带通/带限/陷波Band/Notch动窄带只针对截止点附近的窄频带做文章。此外官方教程建议将低频搁架与均衡器EQ、压缩器Compressor、**硬限幅器HardLimiter**搭配使用例如在 Master 总线上用 EQ 先清理设备扬声器无法良好还原的低频再用 LowShelf 做音乐性的低频塑形最后以硬限幅器兜底防止削波clipping。关于 dB 标度与 0 dB 上限的混音规则请阅读 Audio buses 教程 的 Decibel scale 一节。混音实践要点先听再调官方教程强调尝试每一种效果以感知它们如何改变声音。调整 LowShelf 时建议在 A/B 状态下反复对比可用set_bus_effect_enabled或编辑器中的效果开关避免凭直觉堆参数。增益值域意识gain上限为 4线性倍数换算约为 12 dB 左右。过大增益配合总线叠加可能导致削波可先降源音量或加硬限幅器。截止频率要贴合素材不要盲目使用默认 2000 Hz。人声主导的场景通常把 LowShelf 的截止点压低100~300 Hz音乐/音效主导的场景再根据底鼓、贝斯的音域选择。阶数决定性格6 dB/oct 的搁架曲线温和自然24 dB/oct 则接近切除。低频搁架多数场景推荐 6~12 dB/oct避免过渡区出现明显染色。配合总线路由使用低频搁架可以只挂在某个专门的总线上例如只对 BGM 总线生效不影响对白这正是 Godot 总线路由 效果链设计的典型用法。参考文档索引关联类文档classes/class_audioeffectlowshelffilter.rst基类与全部参数定义classes/class_audioeffectfilter.rst高频搁架对照类classes/class_audioeffecthighshelffilter.rst音频总线系统tutorials/audio/audio_buses.rst全部音频效果总览tutorials/audio/audio_effects.rst运行时总线/效果 APIclasses/class_audioserver.rst音频总线界面示意tutorials/audio/img/audio_buses4.webp赞分享文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载相关推荐Radix Vuereka-uiRoving Focus 组件完全指南实现 roving tabindex 焦点管理Radix Vuereka uiRoving Focus 组件完全指南实现 roving tabindex 焦点管理 导读 Roving Focus 是文档教程游戏开发Godot 高通滤波器 AudioEffectHighPassFilter 实战指南原理、参数与音频总线集成Godot 高通滤波器 AudioEffectHighPassFilter 实战指南原理、参数与音频总线集成 导读 AudioEffectHighPassFi文档教程游戏开发Godot 音频带通滤波器AudioEffectBandPassFilter完全指南原理、参数配置与实战应用Godot 音频带通滤波器AudioEffectBandPassFilter完全指南原理、参数配置与实战应用 导读 本篇指南围绕 Godot Engine文档教程游戏开发上一篇ExplorerPatcher终极指南5个技巧让Windows界面焕然一新下一篇XGP存档提取器实战指南3步完成Xbox Game Pass游戏存档迁移创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Godot 音频总线低频搁架滤波器（AudioEffectLowShelfFilter）完全指南：原理、参数与实战配置
文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载AudioEffectLowShelfFilter低频搁架滤波器是 Godot 引擎内置音频效果之一用于在音频总线上控制所有低于指定截止频率cutoff_hz频段的增益是调整声音力度strength与低频厚度的核心工具。本文以 class_audioeffectlowshelffilter.rst 为主体结合其基类 AudioEffectFilter 的完整参数定义与 AudioServer 的运行时 API系统讲解低频搁架滤波器的声学原理、每一个可调参数的含义与取值范围、在编辑器与脚本两种场景下的配置方法以及它与其他滤波器高通、低通、搁架、带通等的选型差异。读完本文你将能够独立在 Godot 项目中为任意音频总线添加、调校并动态控制一个低频搁架滤波器让低频饱满而不浑浊、人声清晰而不发闷。什么是低频搁架Low-Shelf滤波器在 AudioEffectLowShelfFilter 的官方类描述中其核心定义只有一句话Adds a low-shelf filter to an audio bus. A low-shelf filter controls the gain of all frequencies belowcutoff_hz.搁架shelf是 EQ 领域的经典滤波形状它在截止频率以下的部分对整体频段做统一的增益提升或衰减而在截止频率以上的部分几乎不产生影响增益响应曲线在频谱图上呈现出一个搁板形状。与之相对的是高通/低通pass滤波器——后者会直接切除截止频率一侧的频率成分而非仅调整增益。在 Godot 中低频搁架滤波器可以增加声音的力量感提升低频增益让鼓点、低音、爆炸声更有冲击力削减浑浊感衰减低频增益为其他声音如人声、对白腾出频段空间模拟设备限制衰减低频模拟电话听筒、老式收音机等窄带听感。官方 Audio effects 教程 对 LowShelfFilter 的定位描述如下A low-shelf filter controls the gain of all frequencies below thecutoffpoint. This filter can be used to adjust the strength of a sound, by increasing or decreasing the gain of the bass range.这与高通滤波器移除低频内容让声音变薄、低频搁架滤波器整体调节低频增益形成了明确的职责区分。继承体系所有滤波器共享的基类AudioEffectLowShelfFilter不定义自己的独立属性它的一切参数都继承自基类AudioEffectFilter。其完整继承链为AudioEffectLowShelfFilter AudioEffectFilter AudioEffect Resource RefCounted Object从 AudioEffectFilter 的文档可以看到Godot 中一共有 7 个滤波器类共享这一套参数体系搁架滤波器Shelf filtersAudioEffectLowShelfFilter低频搁架与AudioEffectHighShelfFilter高频搁架用于提升/衰减高频清晰度带通与陷波Band-pass and notchAudioEffectBandPassFilter、AudioEffectBandLimitFilter、AudioEffectNotchFilter高通/低通Low/high-passAudioEffectLowPassFilter与AudioEffectHighPassFilter。基类文档特别强调Use effects that inherit this class instead of using it directly——不要直接实例化AudioEffectFilter而应使用其派生类。同时Audio effects 教程 中的 Filter 小节也提示该效果不应直接使用它是其他滤波器的公共父类。在实现层面所有效果都以Resource形式存在可以序列化到音频总线布局文件如res://default_bus_layout.tres中也可以像普通资源一样在代码中new出来使用。核心参数详解cutoff_hz、db、gain 与 resonanceAudioEffectLowShelfFilter的全部可调参数定义在基类 AudioEffectFilter 的属性表中共 4 个。下表完整列出其类型、默认值与说明属性类型默认值取值范围说明cutoff_hzfloat2000.01 ~ 20500滤波器的频率阈值Hz。低于该频率的频段受搁架滤波器增益控制dbFilterDB枚举0FILTER_6DB0 ~ 3截止曲线的陡度单位为 dB/倍频程即滤波器的阶数gainfloat1.00 ~ 4受滤波器影响频段的增益倍数。仅对 LowShelf 与 HighShelf 两种搁架滤波器生效resonancefloat0.50 ~ 1截止频率点处或其紧邻频带的增益行为随滤波器类型不同而不同cutoff_hz截止频率对应 setter/getterset_cutoff(value)/get_cutoff()。cutoff_hz是搁架滤波器的分界点所有低于该频率的频段都受gain控制高于该频率的频段基本不受影响。其取值范围为 1 到 20500 Hz覆盖了从次声波边缘到人耳听觉上限的整个可听范围。默认值 2000 Hz 处于中频偏低的位置——在这个阈值下提升增益主要影响的是低频与中低频的身体感。实际调音建议想让底鼓/贝斯更厚实可将cutoff_hz设在 80~250 Hz 之间再配合增益提升想让对白人声更突出、降低伴奏低频干扰可将cutoff_hz设在 150~300 Hz 并略微衰减增益需要配合音乐风格整体压低低频如电话音效果时可将阈值设到 400~1000 Hz 并大幅衰减。db滤波曲线陡度倍频程 dB 数对应 setter/getterset_db(value)/get_db()。db是枚举类型FilterDB决定搁架曲线从平坦过渡到目标增益有多陡也就是滤波器阶数order。基类文档将其定义为截止曲线在每倍频程octave上的陡度——倍频程即截止频率上方两倍频率或下方一半频率。常量值含义FILTER_6DB0每倍频程 6 dB一阶曲线最平缓过渡最自然FILTER_12DB1每倍频程 12 dB二阶FILTER_18DB2每倍频程 18 dB三阶FILTER_24DB3每倍频程 24 dB四阶曲线最陡截止效果最激进文档明确指出Higher orders have a more aggressive cutoff阶数越高截止越激进。对于搁架滤波器而言较低的阶数6/12 dB能做出更暖、更平滑的低频过渡适合音乐性调音较高的阶数18/24 dB则更接近切除效果适合需要明显频段隔离的场合。gain受控频段的增益搁架滤波器专属对应 setter/getterset_gain(value)/get_gain()。gain是搁架滤波器的灵魂参数——它决定了截止频率以下频段被放大还是衰减多少。需要特别注意的是基类文档明确标注Gain of the frequencies affected by the filter. This property is only available forAudioEffectLowShelfFilterandAudioEffectHighShelfFilter.也就是说gain只在两种搁架滤波器上生效高通/低通/带通/陷波滤波器不会使用该属性它们自身也没有提升某频段的能力。取值范围为 0 到 4gain 1.0默认频率响应不改变滤波器处于旁路效果gain 1.0提升低频增益让声音更厚实、更有力量gain 1.0衰减低频增益让声音更薄、更干净。AudioEffectLowShelfFilter的类描述正是围绕这一参数展开的This filter can be used to adjust the strength of a sound, by increasing or decreasing its low-end通过提升或衰减低频来调整声音的力度。在编辑器界面上增益通常以线性倍数显示如需换算为 dB可参考 Audio buses 教程 中关于分贝标度的说明每 6 dB 对应振幅加倍或减半。resonance截止点共振对应 setter/getterset_resonance(value)/get_resonance()。resonance控制截止频率点或其紧邻频带的增益取值范围 0 到 1默认 0.5。基类文档详细说明了它随滤波器类型而不同的行为搁架滤波器含 LowShelf通过提升紧邻截止频率的频段、衰减另一侧频段来强调或掩盖阶数效果——通俗地说更大的 resonance 会让截止点附近出现一个明显的峰或谷使滤波特征更有声有色带通/陷波滤波器用于在截止点处加宽或收窄滤波带宽高通/低通滤波器用于在截止点处增强或削弱频率响应。对低频搁架滤波器而言resonance配合db可以制造出类似低音强调的 Q 值感但需要注意过大的 resonance 会让截止点附近的频率出现明显隆起在某些素材上可能产生嗡嗡声。实战一在音频总线上添加 LowShelfFilter编辑器操作Godot 的所有音频效果都挂在**音频总线Audio Bus**上任何经过该总线的声音都会依次被总线上的效果链处理。在编辑器中操作如下打开编辑器底部的Audio音频面板可以看到音频总线列表最左侧是Master主总线详见 Audio buses 教程 的总线介绍选中一条非 Master 总线或 Master 本身点击总线单元上的Add Effect下拉菜单在效果列表中选择LowShelfFilter。效果会按添加顺序依次作用因此请把它放在效果链中合理的位置如放在均衡/压缩之前或之后视混音需求而定在效果参数面板中调整cutoff_hz、db、gain、resonance四个参数实时试听总线上的声音。Godot 编辑器的效果列表即对应引擎内置的全部音频效果LowShelfFilter与 Amplify、BandLimitFilter、BandPassFilter、Chorus、Compressor 等并列展示界面示意见 tutorials/audio/img/audio_buses4.webp效果列表位于总线面板的 Add Effect 菜单中总线布局默认自动保存到res://default_bus_layout.tres自定义布局也可通过Load / Save As按钮另存之后随项目一起打包分发。需要注意官方 Audio buses 教程 提示音频效果功能在 Web 平台上有使用限制——若AudioStreamPlayer的播放模式为默认的Sample效果不生效只有在Stream模式下才可用但会增加延迟。开发 Web 导出版本时务必检查这一设置。实战二通过脚本动态创建与调节GDScript / C#低频搁架滤波器同样可以在运行时通过代码动态添加和修改。Godot 提供了一套完整的总线效果运行时 API定义在 AudioServer 中常用的包括add_bus_effect(bus_idx, effect, at_position -1)向指定总线添加效果-1表示追加到效果链末尾get_bus_index(bus_name)按名称获取总线索引总线名称比索引更稳定详见下文总线重排说明get_bus_effect(bus_idx, effect_idx)获取总线上某个位置的效果引用用于后续改参get_bus_effect_count(bus_idx)获取总线上的效果数量set_bus_effect_enabled(bus_idx, effect_idx, enabled)动态开关某个效果set_bus_bypass_effects(bus_idx, enable)一键旁路总线上全部效果方便 A/B 对比。以下 GDScript 示例演示了如何创建低频搁架滤波器并挂到指定总线# 获取名为 Music 的总线索引不存在时返回 -1请先确认总线已存在 var bus_idx : AudioServer.get_bus_index(Music) # 创建低频搁架滤波器资源 var low_shelf : AudioEffectLowShelfFilter.new() low_shelf.cutoff_hz 200.0 # 截止频率只影响 200 Hz 以下的频段 low_shelf.db AudioEffectFilter.FILTER_12DB # 每倍频程 12 dB中等陡度 low_shelf.gain 1.8 # 低频增益提升到 1.8 倍让低音更重 low_shelf.resonance 0.6 # 截止点附近轻微强调 # 添加到总线的效果链末尾 AudioServer.add_bus_effect(bus_idx, low_shelf)对应的 C# 版本int busIdx AudioServer.GetBusIndex(Music); var lowShelf new AudioEffectLowShelfFilter { CutoffHz 200.0f, Db AudioEffectFilter.FilterDb.Filter12Db, Gain 1.8f, Resonance 0.6f }; AudioServer.AddBusEffect(busIdx, lowShelf);运行期间还可以随时调整参数并动态开关效果例如做一个低频逐渐增强的过场func _process(delta: float) - void: var shelf : AudioServer.get_bus_effect(bus_idx, 0) as AudioEffectLowShelfFilter shelf.gain min(shelf.gain delta * 0.5, 2.5) # 对比效果先旁路再恢复 AudioServer.set_bus_effect_enabled(bus_idx, 0, false) # 临时关闭低频搁架 AudioServer.set_bus_effect_enabled(bus_idx, 0, true) # 重新启用如果你通过脚本创建总线还可以结合AudioServer.add_bus(at_position)与set_bus_name(bus_idx, name)先建总线再挂效果。参考 recording_with_microphone.rst 中get_bus_indexget_bus_effect的用法模式可以确认这套 API 在录制、效果访问等场景下是被官方教程实际采用的标准做法。关于总线重排的细节Audio buses 教程 指出 Stream Player 通过总线名称引用总线添加/移动总线不会丢失引用但重命名总线会导致引用失效并回落到Master。因此动态脚本中应优先用名称查索引而不是硬编码索引号。与其他滤波器/效果器的选型对比低频搁架滤波器只是 AudioEffectFilter 家族的一员弄清它与近邻效果的区别才能选对工具需求推荐效果理由整体提升/衰减低频保留低频内容LowShelfFilter只调整低频增益不切除频率提升/衰减高频清晰度HighShelfFilter与 LowShelf 对称控制截止频率以上的频段切除低频让声音变薄HighPassFilter直接衰减截止频率以下的内容切除高频模拟闷响/水下声LowPassFilter直接衰减截止频率以上的内容突出/隔离某一窄带BandPassFilter保留截止点附近频段衰减两侧去除某个特定窄带频率NotchFilter / BandLimitFilter在截止点处挖坑为其他声音腾空间从 audio_effects.rst 的对比描述可以提炼出核心判断依据搁架Shelf调增益频率不被移除只是被整体放大或缩小——LowShelf 管低频段HighShelf 管高频段高通/低通Pass切频率一侧频率被明显衰减声音质感会发生结构性变化带通/带限/陷波Band/Notch动窄带只针对截止点附近的窄频带做文章。此外官方教程建议将低频搁架与均衡器EQ、压缩器Compressor、**硬限幅器HardLimiter**搭配使用例如在 Master 总线上用 EQ 先清理设备扬声器无法良好还原的低频再用 LowShelf 做音乐性的低频塑形最后以硬限幅器兜底防止削波clipping。关于 dB 标度与 0 dB 上限的混音规则请阅读 Audio buses 教程 的 Decibel scale 一节。混音实践要点先听再调官方教程强调尝试每一种效果以感知它们如何改变声音。调整 LowShelf 时建议在 A/B 状态下反复对比可用set_bus_effect_enabled或编辑器中的效果开关避免凭直觉堆参数。增益值域意识gain上限为 4线性倍数换算约为 12 dB 左右。过大增益配合总线叠加可能导致削波可先降源音量或加硬限幅器。截止频率要贴合素材不要盲目使用默认 2000 Hz。人声主导的场景通常把 LowShelf 的截止点压低100~300 Hz音乐/音效主导的场景再根据底鼓、贝斯的音域选择。阶数决定性格6 dB/oct 的搁架曲线温和自然24 dB/oct 则接近切除。低频搁架多数场景推荐 6~12 dB/oct避免过渡区出现明显染色。配合总线路由使用低频搁架可以只挂在某个专门的总线上例如只对 BGM 总线生效不影响对白这正是 Godot 总线路由 效果链设计的典型用法。参考文档索引关联类文档classes/class_audioeffectlowshelffilter.rst基类与全部参数定义classes/class_audioeffectfilter.rst高频搁架对照类classes/class_audioeffecthighshelffilter.rst音频总线系统tutorials/audio/audio_buses.rst全部音频效果总览tutorials/audio/audio_effects.rst运行时总线/效果 APIclasses/class_audioserver.rst音频总线界面示意tutorials/audio/img/audio_buses4.webp赞分享文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载相关推荐Radix Vuereka-uiRoving Focus 组件完全指南实现 roving tabindex 焦点管理Radix Vuereka uiRoving Focus 组件完全指南实现 roving tabindex 焦点管理 导读 Roving Focus 是文档教程游戏开发Godot 高通滤波器 AudioEffectHighPassFilter 实战指南原理、参数与音频总线集成Godot 高通滤波器 AudioEffectHighPassFilter 实战指南原理、参数与音频总线集成 导读 AudioEffectHighPassFi文档教程游戏开发Godot 音频带通滤波器AudioEffectBandPassFilter完全指南原理、参数配置与实战应用Godot 音频带通滤波器AudioEffectBandPassFilter完全指南原理、参数配置与实战应用 导读 本篇指南围绕 Godot Engine文档教程游戏开发上一篇ExplorerPatcher终极指南5个技巧让Windows界面焕然一新下一篇XGP存档提取器实战指南3步完成Xbox Game Pass游戏存档迁移创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考