音频插件

【标题】
《战锤40K：暗潮》音频功能扩展库 MOD 使用指南
【核心介绍】
为其他模组提供稳定、易用的自定义音频控制能力，支持位置音效、滤镜、Wwise事件触发、音效替换/静音/录制等核心功能。
【安装指南】
1. 下载并安装前置依赖模组：「DarktideLocalServer」（[NexusMods 链接]( 网址链接
2. 将本模组文件解压后，全部内容粘贴至游戏根目录 /mods 文件夹；
3. 在模组加载顺序中，本模组必须置于最上方，且紧接在「DarktideLocalServer」之后（缺一不可）；
4. 启动游戏前，必须在「Darktide 模组框架」设置中开启「开发者模式」与「显示开发者控制台」。
【功能详情】
✅ 已优化：
– 支持播放带空间定位的自定义音频文件（如爆炸声随距离衰减）；
– 提供多种音频滤镜（低通、混响等）及播放属性（音量、优先级、循环）；
– 可直接触发 Wwise 事件与对话语音；
– 支持钩住、替换、静音或实时记录任意游戏音效；
– 内置单元测试，提升与其他模组联用时的稳定性。
❌ 未修改：
– 游戏原生音频引擎底层逻辑；
– 非音频类系统（如UI、角色模型、武器逻辑）。
✨ 额外调整：
– 开发者控制台集成音频调试指令（如 `audio.log` 实时捕获音效触发）；
– 提供标准化 API 接口，供其他模组安全调用（无需重复实现音频管理逻辑）。
【使用要求】
– 必须安装游戏官方模组框架，并更新至 v1.0 或更高版本；
– 必须已安装并启用「DarktideLocalServer」模组（v1.2+）；
– 推荐启用开发者模式（非强制但影响调试功能可用性）。
【兼容性说明】
– 兼容范围：所有基于 Darktide 模组框架 v1.0+ 构建的音频类模组；
– 不兼容模组：自行修改 Wwise 初始化流程或劫持音频线程的第三方模组（如未声明兼容的私有音频注入器）；
– 兼容补丁：暂未推出专用兼容补丁。
【注意事项】
– 若未按要求将本模组置于加载顺序最上方（且紧邻「DarktideLocalServer」），音频功能将完全失效；
– 「开发者模式」与「显示开发者控制台」两项设置必须同时开启，否则调试指令与部分日志功能不可用；
– 本模组本身不包含音效资源，需配合其他音频功能模组（见下方列表）使用；
– 模组运行时可能短暂增加 CPU 占用（${5%），属正常现象，不影响帧率。