游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载导读本文面向使用 Turbulenz 引擎开发 HTML5 游戏的音频工程师与前端开发者系统讲解 SoundEffect 与 SoundEffectSlot 对象 的完整 API如何通过SoundDevice.createEffect创建混响Reverb与回声Echo效果、每个参数的物理含义与取值范围、如何借助SoundEffectSlot将同一效果复用到多个声源以及从效果创建到声源挂接的完整调用链路。读完本文你将能够为游戏环境走廊、大厅、洞穴、开阔地形配置可调的实时音频效果并理解这些效果在当前引擎实现中的平台能力边界。SoundEffect 对象概览SoundEffect对象代表一个由一组参数创建出来的音频效果它可以被关联attach到一个效果槽effect slot上。效果本身不直接发声它通过后续的SoundEffectSlot与声源Source/GlobalSource的输出链路结合对经过它的声音进行处理。根据 SoundDevice API 文档一个SoundEffect对象只能通过SoundDevice.createEffect()构造示例如下var effect soundDevice.createEffect({ name : HallwayReverb01, type : Reverb, delay : 0.15 });createEffect的公共参数只有两个name要创建的效果名称字符串type要创建的效果类型字符串。如果该类型不被支持createEffect将创建失败并返回null。当效果创建成功后它会继承该类型所定义的全部属性采用传入值未传入的属性取默认值。本文档列出的所有属性均可通过 getter 读取、通过 setter 写入。在 TypeScript 类型声明 中SoundEffectParameters将全部参数标记为可选也印证了未传参数即采用默认值的行为。值得注意在 WebGL 后端的 SoundDevice 实现 中createEffect与createEffectSlot的当前实现直接返回null。这意味着效果处理链路依赖底层 OpenAL EFX 渲染器提供纯 HTML5 音频后端目前不包含效果实现详见后文平台能力边界一节。通用属性name效果的标识名称可读写。常用于在代码中区分同一场景中创建的不同效果实例。// Get var name effect.name; // Set effect.name HallwayReverb01;type效果的类型字符串只读。在createEffect时由type参数决定例如Reverb、Echo。// Get var type effect.type;Reverb 混响效果参数详解混响Reverb效果模拟声音在空间中的多次反射与衰减。Turbulenz 的 Reverb 效果参数完整覆盖了早期反射、后期混响、频谱塑造与空气吸收等物理维度。各参数汇总如下随后逐一展开参数含义取值范围默认值单位density模态密度控制晚期混响染色0.0 ~ 1.01.0线性diffusion回波密度0.0 ~ 1.01.0线性乘数gain混响主音量0.0 ~ 1.00.32线性增益gainHF高频反射声衰减低通0.0 ~ 1.00.89线性增益decayTime混响衰减时间0.1 ~ 20.01.49秒decayHFRatio高频衰减时间相对低频之比0.1 ~ 2.00.83线性乘数reflectionsGain早期反射总量相对gain0.0 ~ 3.160.05线性增益reflectionsDelay直达声到首次反射的延迟0.0 ~ 0.30.007秒lateReverbGain后期混响总量相对gain0.0 ~ 10.01.26线性增益lateReverbDelay后期混响相对首次反射的开始时间0.0 ~ 0.10.011秒roomRollOffFactor反射声按距离衰减的滚降系数0.0 ~ 10.00.0线性乘数airAbsorptionGainHF传播介质导致的高频距离衰减0.892 ~ 1.00.994每米线性增益decayHFLimit是否自动限制高频衰减时间true / falsetrue布尔density—— 模态密度Reverb Modal Density 控制晚期混响的染色coloration。降低该值会给晚期混响增加更多染色感使尾音听起来更金属或更空洞趋近 1.0 时染色最少混响更平滑。// Get var density effect.density; // Set effect.density 0.3;范围0.0到1.0默认1.0diffusion—— 回波密度Reverb Diffusion 控制混响衰减过程中的回波密度。默认值 1.0 提供最高密度降低扩散度会让混响呈现更颗粒状grainy的特性这在打击乐声源上尤其明显。若设为 0.0后期混响听起来会像一连串彼此分离的独立回声。// Get var diffusion effect.diffusion; // Set effect.diffusion 0.3;范围0.0到1.0默认1.0单位线性乘数值gain—— 混响主音量Reverb Gain 是所有反射声包括早期反射与后期混响的总音量控制它设定最终混音中加入的反射与混响的最大量。取值从 1.00 dB最大量到 0.0-100 dB完全没有反射声。// Get var gain effect.gain; // Set effect.gain 0.4;范围0.0到1.0默认0.32单位线性增益gainHF—— 高频反射衰减Reverb Gain HF 通过在反射声上施加一个全局低通滤波器来衰减高频。取 1.00 dB表示不滤波取 0.0-100 dB表示高频反射声几乎完全消失。它作用于所有送入该混响实例的声源反射声。// Get var gainHF effect.gainHF; // Set effect.gainHF 0.6;范围0.0到1.0默认0.89单位线性增益decayTime—— 混响衰减时间Decay Time 设定混响的衰减时长。0.1 秒通常对应表面吸声极强的小房间20.0 秒通常对应表面非常活跃反射强的大空间。// Get var decayTime effect.decayTime; // Set effect.decayTime 1.9;范围0.1到20.0默认1.49单位秒decayHFRatio—— 高频衰减时间比Decay HF Ratio 设定 Decay Time 的频谱特性即高频衰减时间相对于低频衰减时间的比值取 1.0 时是中性的所有频率的衰减时间相等大于 1.0 时高频衰减时间更长你会听到更明亮、高频拖尾更长的混响小于 1.0 时高频衰减时间更短混响听起来更自然更闷。// Get var decayHFRatio effect.decayHFRatio; // Set effect.decayHFRatio 1.9;范围0.1到2.0默认0.83单位线性乘数值reflectionsGain—— 早期反射总量Reflections Gain 控制早期反射initial reflections相对gain的总量。gain设定的是反射声总体量早期反射 后期混响而本属性在此基础上进一步调整早期反射部分最大值 3.1610 dB最小值 0.0-100 dB即完全没有早期反射。它不影响后续的混响衰减过程。调音建议来自原文档增大早期反射可以模拟更狭小的空间或更近的墙壁若同时配合减小reflectionsDelay缩短反射延迟效果更明显要模拟开阔或半开阔环境可以保持早期反射量不变同时降低lateReverbGain后期混响量。// Get var reflectionsGain effect.reflectionsGain; // Set effect.reflectionsGain 2.1;范围0.0到3.16默认0.05单位线性增益reflectionsDelay—— 早期反射延迟Reflections Delay 是从直达声到达听者到第一次反射声到达之间的时间差0 到 300 毫秒。增大或减小该值可以模拟更远或更近的反射面从而控制听者对房间大小的感知。// Get var reflectionsDelay effect.reflectionsDelay; // Set effect.reflectionsDelay 0.1;范围0.0到0.3默认0.007单位秒注意代码中按秒书写0.3 秒即 300 毫秒lateReverbGain—— 后期混响总量Late Reverb Gain 控制后期混响相对gain的总量最大值 10.020 dB最小值 0.0-100 dB即完全没有后期混响。需要注意Late Reverb Gain 与 Decay Time 是相互独立的属性。只调整decayTime而不改动lateReverbGain时后期混响的总强度振幅平方的平均值保持不变——混响只是被拉长或压缩响度并不会随之变化。// Get var lateReverbGain effect.lateReverbGain; // Set effect.lateReverbGain 3;范围0.0到10.0默认1.26单位线性增益lateReverbDelay—— 后期混响开始时间Late Reverb Delay 定义后期混响相对于首次早期反射的起始时间0 到 100 毫秒。减小或增大该值可用于模拟更小或更大的房间。// Get var lateReverbDelay effect.lateReverbDelay; // Set effect.lateReverbDelay 0.23;范围0.0到0.1默认0.011单位秒roomRollOffFactor—— 反射声距离衰减系数Room Rolloff Factor 是按声源-听者距离来衰减反射声含反射与混响的两种手段之一。它的定义方式与 OpenAL 的 Rolloff Factor 相同但作用于混响声而非直达声。取 1.0 表示距离每翻一倍反射声衰减 6 dB其他取值相当于对(源听距离 - Reference Distance)施加一个缩放系数。Reference Distance 是 OpenAL 声源参数定义了距离滚降生效的内边界声源比该距离更近时直达声不再随靠近而增强反射声同理。默认值为 0.0因为默认情况下 Effects Extension 的混响效果会为每个声源自动管理反射声电平以模拟典型房间中反射声随距离的自然滚降。注意如果声源属性标志auxiliarySendFilterGainAuto被设为false则不再自动管理。你可以把roomRollOffFactor当作自动控制的补充选项用来夸大或取代默认的自动滚降。// Get var roomRollOffFactor effect.roomRollOffFactor; // Set effect.roomRollOffFactor 0.7;范围0.0到10.0默认0.0单位线性乘数值airAbsorptionGainHF—— 空气吸收高频衰减Air Absorption Gain HF 控制由传播介质空气引起的高频随距离衰减只作用于反射声。你可以用它模拟透过潮湿空气、干燥空气、烟雾等介质传播的声音效果。默认值 0.994约 -0.05 dB每米对应典型的空气湿度、温度等常规条件降低该值模拟吸收性更强的介质例如空气中湿度更高提高该值模拟吸收性更弱的介质例如干燥的沙漠空气。// Get var airAbsorptionGainHF effect.airAbsorptionGainHF; // Set effect.airAbsorptionGainHF 0.938;范围0.892到1.0默认0.994单位每米线性增益decayHFLimit—— 高频衰减时间自动限制当该标志为true时高频衰减时间会自动保持在一个由airAbsorptionGainHF设定值推导出的上限之下。该限制与decayHFRatio的取值无关也不会改动decayHFRatio的值。开启后你可以放心增大decayTime而不用担心高频出现不自然的超长衰减从而维持自然的混响尾音设为false则不对高频衰减时间做自动限制。// Get var decayHFLimit effect.decayHFLimit; // Set effect.decayHFLimit false;范围true或false默认trueEcho 回声效果参数详解Echo 效果生成输入信号的离散、延迟副本实例延迟量与反馈量均可控。它的延迟是双抽头two tap结构——你可以控制两路独立回声实例之间的相互作用。参数汇总参数含义取值范围默认值delay原声到第一个tap的延迟0.0 ~ 0.2070.1lrdelay第一个 tap 到第二个 tap 的延迟0.0 ~ 0.4040.1damping每个回声的高频阻尼量0.0 ~ 0.990.5feedback输出反馈回输入的量0.0 ~ 1.00.5spread各回声的声像pan程度-1.0 ~ 1.0-1.0delay—— 首个回声延迟控制原声与第一个tap回声实例之间的延迟。此后Echo Delay 的值还会用于确定第二个 tap与下一个第一个 tap之间的时间间隔。// Get var delay effect.delay; // Set effect.delay 0.046;范围0.0到0.207默认0.1lrdelay—— 双 tap 间延迟控制第一个tap与第二个tap之间的延迟。此后Echo LR Delay 的值还会用于确定每个第一个 tap与下一个第二个 tap之间的时间间隔。// Get var lrdelay effect.lrdelay; // Set effect.lrdelay 0.1337;范围0.0到0.404默认0.1damping—— 回声高频阻尼控制施加在每个回声上的高频阻尼量。由于声音会被反复反馈产生后续回声阻尼会使回声在强度与音色上逐次变柔和——回声一次比一次更闷、更弱。// Get var damping effect.damping; // Set effect.damping 0.78;范围0.0到0.99默认0.5feedback—— 回声反馈量控制输出信号反馈回输入的量。用该参数可以制造级联cascading回声效果满值接近 1.0时相同的采样会无限重复下去低于满值时采样会重复并逐渐衰减。// Get var feedback effect.feedback; // Set effect.feedback 0.235;范围0.0到1.0默认0.5spread—— 回声声像展开控制每个回声被硬声像hard panned的程度1.0 时第一个 tap 被硬声像到极左第二个 tap 硬声像到极右-1.0 时结果相反默认值即 -1.0越接近 0.0声像展开越弱。// Get var spread effect.spread; // Set effect.spread -0.5;范围-1.0到1.0默认-1.0SoundEffectSlot 对象详解SoundEffectSlot对象是一个效果的容器。一个槽可以同时关联多个声源实现单个效果处理多个声源输出的复用模式。它通过SoundDevice.createEffectSlot()创建var effectSlot soundDevice.createEffectSlot({ effect : effect, gain : 0.8 });createEffectSlot的参数effect要与槽配合使用的SoundEffect对象只能在创建槽时设置gain应用到槽输出的增益0.0 表示静音。如果effect不是有效的SoundEffect对象或参数不正确createEffectSlot返回null见 SoundDevice API 文档。effect—— 槽内效果只读附加到槽上的效果对象。该值只能在SoundEffectSlot创建时指定之后不可更改。// Get var effect effectSlot.effect;gain—— 槽输出增益应用于SoundEffectSlot输出的增益0.0 为静音。可以用它来单独调整效果湿声在最终混音中的比例而无需改动声源本身的音量。// Get var gain effectSlot.gain; // Set effectSlot.gain 0.1;范围0.0到1.0默认1.0单位线性增益auxiliarySendAuto—— 自动发送调整启用或禁用基于声源与听者物理位置的自动发送调整。当应用希望用混响效果模拟听者或一组声源周围的环境时应将该属性保持启用。// Get var auxiliarySendAuto effectSlot.auxiliarySendAuto; // Set effectSlot.auxiliarySendAuto true;范围true或false默认true实战链路从效果创建到声源挂接将效果真正作用于声音需要走完效果 → 槽 → 声源 Auxiliary Send的完整链路。以 3D 声源Source为例// 1. 创建混响效果未指定的属性取默认值 var effect soundDevice.createEffect({ name : HallwayReverb01, type : Reverb, decayTime : 1.9, gain : 0.4, density : 0.3 }); if (!effect) { // type 不支持或参数错误时返回 null } // 2. 创建效果槽装载效果 var effectSlot soundDevice.createEffectSlot({ effect : effect, gain : 0.8 }); // 3. 将效果槽挂接到声源的 Auxiliary Send 输出 var result source.setAuxiliarySendFilter(0, effectSlot, null); // result false 表示该声源没有 index 0 这个 Auxiliary Send 输出根据 Source API 文档 与 GlobalSource API 文档setAuxiliarySendFilter(index, effectSlot, filter)的要点如下indexAuxiliary Send 的索引。soundDevice.alcMaxAuxiliarySends给出每个声源最多可用的 Auxiliary Send 数量例如值为 2 时index可取 0 或 1effectSlot要应用的效果槽对象传null表示关闭该路发送filter在送入效果槽之前对声源输出做前置处理的SoundFilter对象例如低通滤波器参考 SoundFilter API 文档传null表示不经过滤波在同一索引上重复设置会替换掉之前的效果槽/滤波器函数返回true表示操作成功返回false表示出错例如声源不支持该索引。对不关心空间定位的音效UI 提示音、背景音乐等可以改用GlobalSource它同样提供setAuxiliarySendFilter效果槽的用法完全一致。此外还需注意定期调用soundDevice.update()SoundDevice 的update方法会轮询正在播放的声源状态并更新数据文档建议每个渲染帧调用一次例如通过TurbulenzEngine.setInterval(renderFrame, 1000 / 60)以保证自动发送调整auxiliarySendAuto等基于位置的特性持续生效销毁顺序在调用TurbulenzEngine.flush()之前必须把所有使用过的 Auxiliary Send 与 Direct 输出都置为null如source.setAuxiliarySendFilter(0, null, null)否则可能导致声音对象销毁时报错。平台能力边界需要明确当前仓库的实现边界。SoundDevice 的官方定位是使用 OpenAL 提供 3D 声音支持见 SoundDevice API 文档 开头并且暴露了alcEfxVersion、alcMaxAuxiliarySends、extensions等属性——其中alcEfxVersion是 OpenAL 实现对 EFXEffects Extension扩展支持的版本字符串alcMaxAuxiliarySends则是每个声源可用的 Auxiliary Send 上限这些都直接与 SoundEffect 的可用性相关。但从当前仓库的 WebGL/HTML5 后端源码看sounddevice.ts 中createEffect、createEffectSlot、createFilter的实现均为直接返回null声源的setAuxiliarySendFilter同样返回false见同文件第 1106-1116 行。由此可以推断效果处理EFX能力依赖具备 OpenAL 渲染器的原生后端提供纯 HTML5 音频后端目前不包含 SoundEffect/SoundEffectSlot 的实现。也就是说在纯浏览器 WebGL 环境下调用createEffect会得到null开发者应当先检查返回值或依据运行环境原生 OpenAL 后端 / HTML5 后端做能力降级处理。类型定义速查若使用 TypeScript 开发可直接参考 turbulenz.d.ts 中的接口定义interface SoundEffectParameters { name : string; type : string; // Echo delay? : number; lrdelay? : number; damping? : number; feedback? : number; spread? : number; // Reverb density? : number; diffusion? : number; gain? : number; gainHF? : number; decayTime? : number; decayHFRatio? : number; reflectionsGain? : number; reflectionsDelay? : number; lateReverbGain? : number; lateReverbDelay? : number; roomRollOffFactor? : number; airAbsorptionGainHF? : number; decayHFLimit? : number; } interface SoundEffectSlotParameters { effect : SoundEffect; gain : number; }该文件同时定义了SoundEffect、SoundEffectSlot的运行时属性接口name、type、全部 Reverb/Echo 参数以及effect、gain、auxiliarySendAuto与本文前面各属性一一对应可作为编写强类型代码时的权威参照。小结SoundEffect与SoundEffectSlot构成了 Turbulenz 引擎音频效果系统的一对核心对象前者负责定义效果是什么13 个 Reverb 参数 5 个 Echo 参数覆盖密度、扩散、增益、衰减、延迟、距离滚降与空气吸收等全部维度后者负责效果如何接入混音链路可复用于多个声源、可独立调节湿声增益、可基于位置自动调整发送量。配合SoundDevice.createEffect/createEffectSlot与声源的setAuxiliarySendFilter即可在支持 OpenAL EFX 的平台上为游戏搭建完整的空间音频效果管线而在纯 HTML5 后端上需要依据createEffect返回null的特性做好能力检测与降级。赞分享游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载相关推荐Turbulenz SoundDevice 音频设备 API 详解基于 OpenAL 的 3D 声音引擎实战指南Turbulenz SoundDevice 音频设备 API 详解基于 OpenAL 的 3D 声音引擎实战指南 Turbulenz 引擎的 SoundDev游戏开发图形学Turbulenz 引擎高层 GPU 粒子系统 API 详解ParticleManager 与 ParticleArchetype 完全指南Turbulenz 引擎高层 GPU 粒子系统 API 详解ParticleManager 与 ParticleArchetype 完全指南 本篇技术指南围绕游戏开发图形学MoviePy MultiplyVolume 音频音量倍增效果详解参数、原理与实战MoviePy MultiplyVolume 音频音量倍增效果详解参数、原理与实战 导读 MultiplyVolume 是 MoviePy 中用于 统一缩放音音视频视频处理音频处理上一篇scriptc交叉编译教程如何用zig从macOS构建Linux和Windows可执行文件下一篇CLM-v0.1-8B 技术全解析Contrastive Language Model 的架构、推理与微调实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载导读本文面向使用 Turbulenz 引擎开发 HTML5 游戏的音频工程师与前端开发者系统讲解 SoundEffect 与 SoundEffectSlot 对象 的完整 API如何通过SoundDevice.createEffect创建混响Reverb与回声Echo效果、每个参数的物理含义与取值范围、如何借助SoundEffectSlot将同一效果复用到多个声源以及从效果创建到声源挂接的完整调用链路。读完本文你将能够为游戏环境走廊、大厅、洞穴、开阔地形配置可调的实时音频效果并理解这些效果在当前引擎实现中的平台能力边界。SoundEffect 对象概览SoundEffect对象代表一个由一组参数创建出来的音频效果它可以被关联attach到一个效果槽effect slot上。效果本身不直接发声它通过后续的SoundEffectSlot与声源Source/GlobalSource的输出链路结合对经过它的声音进行处理。根据 SoundDevice API 文档一个SoundEffect对象只能通过SoundDevice.createEffect()构造示例如下var effect soundDevice.createEffect({ name : HallwayReverb01, type : Reverb, delay : 0.15 });createEffect的公共参数只有两个name要创建的效果名称字符串type要创建的效果类型字符串。如果该类型不被支持createEffect将创建失败并返回null。当效果创建成功后它会继承该类型所定义的全部属性采用传入值未传入的属性取默认值。本文档列出的所有属性均可通过 getter 读取、通过 setter 写入。在 TypeScript 类型声明 中SoundEffectParameters将全部参数标记为可选也印证了未传参数即采用默认值的行为。值得注意在 WebGL 后端的 SoundDevice 实现 中createEffect与createEffectSlot的当前实现直接返回null。这意味着效果处理链路依赖底层 OpenAL EFX 渲染器提供纯 HTML5 音频后端目前不包含效果实现详见后文平台能力边界一节。通用属性name效果的标识名称可读写。常用于在代码中区分同一场景中创建的不同效果实例。// Get var name effect.name; // Set effect.name HallwayReverb01;type效果的类型字符串只读。在createEffect时由type参数决定例如Reverb、Echo。// Get var type effect.type;Reverb 混响效果参数详解混响Reverb效果模拟声音在空间中的多次反射与衰减。Turbulenz 的 Reverb 效果参数完整覆盖了早期反射、后期混响、频谱塑造与空气吸收等物理维度。各参数汇总如下随后逐一展开参数含义取值范围默认值单位density模态密度控制晚期混响染色0.0 ~ 1.01.0线性diffusion回波密度0.0 ~ 1.01.0线性乘数gain混响主音量0.0 ~ 1.00.32线性增益gainHF高频反射声衰减低通0.0 ~ 1.00.89线性增益decayTime混响衰减时间0.1 ~ 20.01.49秒decayHFRatio高频衰减时间相对低频之比0.1 ~ 2.00.83线性乘数reflectionsGain早期反射总量相对gain0.0 ~ 3.160.05线性增益reflectionsDelay直达声到首次反射的延迟0.0 ~ 0.30.007秒lateReverbGain后期混响总量相对gain0.0 ~ 10.01.26线性增益lateReverbDelay后期混响相对首次反射的开始时间0.0 ~ 0.10.011秒roomRollOffFactor反射声按距离衰减的滚降系数0.0 ~ 10.00.0线性乘数airAbsorptionGainHF传播介质导致的高频距离衰减0.892 ~ 1.00.994每米线性增益decayHFLimit是否自动限制高频衰减时间true / falsetrue布尔density—— 模态密度Reverb Modal Density 控制晚期混响的染色coloration。降低该值会给晚期混响增加更多染色感使尾音听起来更金属或更空洞趋近 1.0 时染色最少混响更平滑。// Get var density effect.density; // Set effect.density 0.3;范围0.0到1.0默认1.0diffusion—— 回波密度Reverb Diffusion 控制混响衰减过程中的回波密度。默认值 1.0 提供最高密度降低扩散度会让混响呈现更颗粒状grainy的特性这在打击乐声源上尤其明显。若设为 0.0后期混响听起来会像一连串彼此分离的独立回声。// Get var diffusion effect.diffusion; // Set effect.diffusion 0.3;范围0.0到1.0默认1.0单位线性乘数值gain—— 混响主音量Reverb Gain 是所有反射声包括早期反射与后期混响的总音量控制它设定最终混音中加入的反射与混响的最大量。取值从 1.00 dB最大量到 0.0-100 dB完全没有反射声。// Get var gain effect.gain; // Set effect.gain 0.4;范围0.0到1.0默认0.32单位线性增益gainHF—— 高频反射衰减Reverb Gain HF 通过在反射声上施加一个全局低通滤波器来衰减高频。取 1.00 dB表示不滤波取 0.0-100 dB表示高频反射声几乎完全消失。它作用于所有送入该混响实例的声源反射声。// Get var gainHF effect.gainHF; // Set effect.gainHF 0.6;范围0.0到1.0默认0.89单位线性增益decayTime—— 混响衰减时间Decay Time 设定混响的衰减时长。0.1 秒通常对应表面吸声极强的小房间20.0 秒通常对应表面非常活跃反射强的大空间。// Get var decayTime effect.decayTime; // Set effect.decayTime 1.9;范围0.1到20.0默认1.49单位秒decayHFRatio—— 高频衰减时间比Decay HF Ratio 设定 Decay Time 的频谱特性即高频衰减时间相对于低频衰减时间的比值取 1.0 时是中性的所有频率的衰减时间相等大于 1.0 时高频衰减时间更长你会听到更明亮、高频拖尾更长的混响小于 1.0 时高频衰减时间更短混响听起来更自然更闷。// Get var decayHFRatio effect.decayHFRatio; // Set effect.decayHFRatio 1.9;范围0.1到2.0默认0.83单位线性乘数值reflectionsGain—— 早期反射总量Reflections Gain 控制早期反射initial reflections相对gain的总量。gain设定的是反射声总体量早期反射 后期混响而本属性在此基础上进一步调整早期反射部分最大值 3.1610 dB最小值 0.0-100 dB即完全没有早期反射。它不影响后续的混响衰减过程。调音建议来自原文档增大早期反射可以模拟更狭小的空间或更近的墙壁若同时配合减小reflectionsDelay缩短反射延迟效果更明显要模拟开阔或半开阔环境可以保持早期反射量不变同时降低lateReverbGain后期混响量。// Get var reflectionsGain effect.reflectionsGain; // Set effect.reflectionsGain 2.1;范围0.0到3.16默认0.05单位线性增益reflectionsDelay—— 早期反射延迟Reflections Delay 是从直达声到达听者到第一次反射声到达之间的时间差0 到 300 毫秒。增大或减小该值可以模拟更远或更近的反射面从而控制听者对房间大小的感知。// Get var reflectionsDelay effect.reflectionsDelay; // Set effect.reflectionsDelay 0.1;范围0.0到0.3默认0.007单位秒注意代码中按秒书写0.3 秒即 300 毫秒lateReverbGain—— 后期混响总量Late Reverb Gain 控制后期混响相对gain的总量最大值 10.020 dB最小值 0.0-100 dB即完全没有后期混响。需要注意Late Reverb Gain 与 Decay Time 是相互独立的属性。只调整decayTime而不改动lateReverbGain时后期混响的总强度振幅平方的平均值保持不变——混响只是被拉长或压缩响度并不会随之变化。// Get var lateReverbGain effect.lateReverbGain; // Set effect.lateReverbGain 3;范围0.0到10.0默认1.26单位线性增益lateReverbDelay—— 后期混响开始时间Late Reverb Delay 定义后期混响相对于首次早期反射的起始时间0 到 100 毫秒。减小或增大该值可用于模拟更小或更大的房间。// Get var lateReverbDelay effect.lateReverbDelay; // Set effect.lateReverbDelay 0.23;范围0.0到0.1默认0.011单位秒roomRollOffFactor—— 反射声距离衰减系数Room Rolloff Factor 是按声源-听者距离来衰减反射声含反射与混响的两种手段之一。它的定义方式与 OpenAL 的 Rolloff Factor 相同但作用于混响声而非直达声。取 1.0 表示距离每翻一倍反射声衰减 6 dB其他取值相当于对(源听距离 - Reference Distance)施加一个缩放系数。Reference Distance 是 OpenAL 声源参数定义了距离滚降生效的内边界声源比该距离更近时直达声不再随靠近而增强反射声同理。默认值为 0.0因为默认情况下 Effects Extension 的混响效果会为每个声源自动管理反射声电平以模拟典型房间中反射声随距离的自然滚降。注意如果声源属性标志auxiliarySendFilterGainAuto被设为false则不再自动管理。你可以把roomRollOffFactor当作自动控制的补充选项用来夸大或取代默认的自动滚降。// Get var roomRollOffFactor effect.roomRollOffFactor; // Set effect.roomRollOffFactor 0.7;范围0.0到10.0默认0.0单位线性乘数值airAbsorptionGainHF—— 空气吸收高频衰减Air Absorption Gain HF 控制由传播介质空气引起的高频随距离衰减只作用于反射声。你可以用它模拟透过潮湿空气、干燥空气、烟雾等介质传播的声音效果。默认值 0.994约 -0.05 dB每米对应典型的空气湿度、温度等常规条件降低该值模拟吸收性更强的介质例如空气中湿度更高提高该值模拟吸收性更弱的介质例如干燥的沙漠空气。// Get var airAbsorptionGainHF effect.airAbsorptionGainHF; // Set effect.airAbsorptionGainHF 0.938;范围0.892到1.0默认0.994单位每米线性增益decayHFLimit—— 高频衰减时间自动限制当该标志为true时高频衰减时间会自动保持在一个由airAbsorptionGainHF设定值推导出的上限之下。该限制与decayHFRatio的取值无关也不会改动decayHFRatio的值。开启后你可以放心增大decayTime而不用担心高频出现不自然的超长衰减从而维持自然的混响尾音设为false则不对高频衰减时间做自动限制。// Get var decayHFLimit effect.decayHFLimit; // Set effect.decayHFLimit false;范围true或false默认trueEcho 回声效果参数详解Echo 效果生成输入信号的离散、延迟副本实例延迟量与反馈量均可控。它的延迟是双抽头two tap结构——你可以控制两路独立回声实例之间的相互作用。参数汇总参数含义取值范围默认值delay原声到第一个tap的延迟0.0 ~ 0.2070.1lrdelay第一个 tap 到第二个 tap 的延迟0.0 ~ 0.4040.1damping每个回声的高频阻尼量0.0 ~ 0.990.5feedback输出反馈回输入的量0.0 ~ 1.00.5spread各回声的声像pan程度-1.0 ~ 1.0-1.0delay—— 首个回声延迟控制原声与第一个tap回声实例之间的延迟。此后Echo Delay 的值还会用于确定第二个 tap与下一个第一个 tap之间的时间间隔。// Get var delay effect.delay; // Set effect.delay 0.046;范围0.0到0.207默认0.1lrdelay—— 双 tap 间延迟控制第一个tap与第二个tap之间的延迟。此后Echo LR Delay 的值还会用于确定每个第一个 tap与下一个第二个 tap之间的时间间隔。// Get var lrdelay effect.lrdelay; // Set effect.lrdelay 0.1337;范围0.0到0.404默认0.1damping—— 回声高频阻尼控制施加在每个回声上的高频阻尼量。由于声音会被反复反馈产生后续回声阻尼会使回声在强度与音色上逐次变柔和——回声一次比一次更闷、更弱。// Get var damping effect.damping; // Set effect.damping 0.78;范围0.0到0.99默认0.5feedback—— 回声反馈量控制输出信号反馈回输入的量。用该参数可以制造级联cascading回声效果满值接近 1.0时相同的采样会无限重复下去低于满值时采样会重复并逐渐衰减。// Get var feedback effect.feedback; // Set effect.feedback 0.235;范围0.0到1.0默认0.5spread—— 回声声像展开控制每个回声被硬声像hard panned的程度1.0 时第一个 tap 被硬声像到极左第二个 tap 硬声像到极右-1.0 时结果相反默认值即 -1.0越接近 0.0声像展开越弱。// Get var spread effect.spread; // Set effect.spread -0.5;范围-1.0到1.0默认-1.0SoundEffectSlot 对象详解SoundEffectSlot对象是一个效果的容器。一个槽可以同时关联多个声源实现单个效果处理多个声源输出的复用模式。它通过SoundDevice.createEffectSlot()创建var effectSlot soundDevice.createEffectSlot({ effect : effect, gain : 0.8 });createEffectSlot的参数effect要与槽配合使用的SoundEffect对象只能在创建槽时设置gain应用到槽输出的增益0.0 表示静音。如果effect不是有效的SoundEffect对象或参数不正确createEffectSlot返回null见 SoundDevice API 文档。effect—— 槽内效果只读附加到槽上的效果对象。该值只能在SoundEffectSlot创建时指定之后不可更改。// Get var effect effectSlot.effect;gain—— 槽输出增益应用于SoundEffectSlot输出的增益0.0 为静音。可以用它来单独调整效果湿声在最终混音中的比例而无需改动声源本身的音量。// Get var gain effectSlot.gain; // Set effectSlot.gain 0.1;范围0.0到1.0默认1.0单位线性增益auxiliarySendAuto—— 自动发送调整启用或禁用基于声源与听者物理位置的自动发送调整。当应用希望用混响效果模拟听者或一组声源周围的环境时应将该属性保持启用。// Get var auxiliarySendAuto effectSlot.auxiliarySendAuto; // Set effectSlot.auxiliarySendAuto true;范围true或false默认true实战链路从效果创建到声源挂接将效果真正作用于声音需要走完效果 → 槽 → 声源 Auxiliary Send的完整链路。以 3D 声源Source为例// 1. 创建混响效果未指定的属性取默认值 var effect soundDevice.createEffect({ name : HallwayReverb01, type : Reverb, decayTime : 1.9, gain : 0.4, density : 0.3 }); if (!effect) { // type 不支持或参数错误时返回 null } // 2. 创建效果槽装载效果 var effectSlot soundDevice.createEffectSlot({ effect : effect, gain : 0.8 }); // 3. 将效果槽挂接到声源的 Auxiliary Send 输出 var result source.setAuxiliarySendFilter(0, effectSlot, null); // result false 表示该声源没有 index 0 这个 Auxiliary Send 输出根据 Source API 文档 与 GlobalSource API 文档setAuxiliarySendFilter(index, effectSlot, filter)的要点如下indexAuxiliary Send 的索引。soundDevice.alcMaxAuxiliarySends给出每个声源最多可用的 Auxiliary Send 数量例如值为 2 时index可取 0 或 1effectSlot要应用的效果槽对象传null表示关闭该路发送filter在送入效果槽之前对声源输出做前置处理的SoundFilter对象例如低通滤波器参考 SoundFilter API 文档传null表示不经过滤波在同一索引上重复设置会替换掉之前的效果槽/滤波器函数返回true表示操作成功返回false表示出错例如声源不支持该索引。对不关心空间定位的音效UI 提示音、背景音乐等可以改用GlobalSource它同样提供setAuxiliarySendFilter效果槽的用法完全一致。此外还需注意定期调用soundDevice.update()SoundDevice 的update方法会轮询正在播放的声源状态并更新数据文档建议每个渲染帧调用一次例如通过TurbulenzEngine.setInterval(renderFrame, 1000 / 60)以保证自动发送调整auxiliarySendAuto等基于位置的特性持续生效销毁顺序在调用TurbulenzEngine.flush()之前必须把所有使用过的 Auxiliary Send 与 Direct 输出都置为null如source.setAuxiliarySendFilter(0, null, null)否则可能导致声音对象销毁时报错。平台能力边界需要明确当前仓库的实现边界。SoundDevice 的官方定位是使用 OpenAL 提供 3D 声音支持见 SoundDevice API 文档 开头并且暴露了alcEfxVersion、alcMaxAuxiliarySends、extensions等属性——其中alcEfxVersion是 OpenAL 实现对 EFXEffects Extension扩展支持的版本字符串alcMaxAuxiliarySends则是每个声源可用的 Auxiliary Send 上限这些都直接与 SoundEffect 的可用性相关。但从当前仓库的 WebGL/HTML5 后端源码看sounddevice.ts 中createEffect、createEffectSlot、createFilter的实现均为直接返回null声源的setAuxiliarySendFilter同样返回false见同文件第 1106-1116 行。由此可以推断效果处理EFX能力依赖具备 OpenAL 渲染器的原生后端提供纯 HTML5 音频后端目前不包含 SoundEffect/SoundEffectSlot 的实现。也就是说在纯浏览器 WebGL 环境下调用createEffect会得到null开发者应当先检查返回值或依据运行环境原生 OpenAL 后端 / HTML5 后端做能力降级处理。类型定义速查若使用 TypeScript 开发可直接参考 turbulenz.d.ts 中的接口定义interface SoundEffectParameters { name : string; type : string; // Echo delay? : number; lrdelay? : number; damping? : number; feedback? : number; spread? : number; // Reverb density? : number; diffusion? : number; gain? : number; gainHF? : number; decayTime? : number; decayHFRatio? : number; reflectionsGain? : number; reflectionsDelay? : number; lateReverbGain? : number; lateReverbDelay? : number; roomRollOffFactor? : number; airAbsorptionGainHF? : number; decayHFLimit? : number; } interface SoundEffectSlotParameters { effect : SoundEffect; gain : number; }该文件同时定义了SoundEffect、SoundEffectSlot的运行时属性接口name、type、全部 Reverb/Echo 参数以及effect、gain、auxiliarySendAuto与本文前面各属性一一对应可作为编写强类型代码时的权威参照。小结SoundEffect与SoundEffectSlot构成了 Turbulenz 引擎音频效果系统的一对核心对象前者负责定义效果是什么13 个 Reverb 参数 5 个 Echo 参数覆盖密度、扩散、增益、衰减、延迟、距离滚降与空气吸收等全部维度后者负责效果如何接入混音链路可复用于多个声源、可独立调节湿声增益、可基于位置自动调整发送量。配合SoundDevice.createEffect/createEffectSlot与声源的setAuxiliarySendFilter即可在支持 OpenAL EFX 的平台上为游戏搭建完整的空间音频效果管线而在纯 HTML5 后端上需要依据createEffect返回null的特性做好能力检测与降级。赞分享游戏开发图形学【免费下载链接】turbulenz_engineTurbulenz is a modular 3D and 2D game framework for making HTML5 powered games for browsers, desktops and mobile devices.项目地址https://gitcode.com/gh_mirrors/tu/turbulenz_engine点击查看免费下载相关推荐Turbulenz SoundDevice 音频设备 API 详解基于 OpenAL 的 3D 声音引擎实战指南Turbulenz SoundDevice 音频设备 API 详解基于 OpenAL 的 3D 声音引擎实战指南 Turbulenz 引擎的 SoundDev游戏开发图形学Turbulenz 引擎高层 GPU 粒子系统 API 详解ParticleManager 与 ParticleArchetype 完全指南Turbulenz 引擎高层 GPU 粒子系统 API 详解ParticleManager 与 ParticleArchetype 完全指南 本篇技术指南围绕游戏开发图形学MoviePy MultiplyVolume 音频音量倍增效果详解参数、原理与实战MoviePy MultiplyVolume 音频音量倍增效果详解参数、原理与实战 导读 MultiplyVolume 是 MoviePy 中用于 统一缩放音音视频视频处理音频处理上一篇scriptc交叉编译教程如何用zig从macOS构建Linux和Windows可执行文件下一篇CLM-v0.1-8B 技术全解析Contrastive Language Model 的架构、推理与微调实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
