注册音频资源
音频文件准备好后，在 sounds.json 中登记 ID、路径、音量与音高。普通音效、船体分档声音集和音乐采用各自的结构；本节提供一份完整配置，下一节将这些 ID 用于都林、突击填弹器、舰船风格和市场。
本节预期阅读时间：~8 分钟。
本节预期操作时间：~10 分钟。
学习目标
完成后，您将能够：
- 创建普通声音、分档声音集和音乐条目；
- 设置 file、source、volume 与 pitch；
- 按同路径合并添加自有内容；
- 用 replace 控制整份数据读取，并定位资源错误。
前置知识
登记普通音效
打开或创建 MOD 的 data/config/sounds.json，顶层使用声音 ID 作为键。都林开火的局部条目如下：
{
"GearIn_weapon_fire": [
{
"file": "sounds/GearIn_weapon_fire.ogg",
"volume": 1,
"pitch": 1
}
]
}
file 指定资源路径，volume 设置音量，pitch 设置音高倍率，1 表示原始值。一个 ID 可以提供多个候选资源；当前数组只有一项，使用刚才准备的开火文件。
系统循环和 UI 反馈同样登记为普通音效，ID 分别为 GearIn_system_loop 与 GearIn_ui_feedback。登记结构相同，资源声道和播放方法仍按各自用途选择，声道已经在上一节确定。
登记舰船分档声音集
舰船风格中的 engineLoopSet 与 engineAccelerateSet 读取声音集。同一个声音集先列出资源，再按船体等级选择其中的索引，局部结构如下：
{
"GearIn_engine_loop": {
"sounds": [
{"file": "sounds/GearIn_system_loop.ogg", "pitch": 1, "volume": 1}
],
"FIGHTER": {"sounds": [0], "pitch": 1, "volume": 0.2},
"FRIGATE": {"sounds": [0], "pitch": 1, "volume": 0.3},
"DESTROYER": {"sounds": [0], "pitch": 1, "volume": 0.4},
"CRUISER": {"sounds": [0], "pitch": 1, "volume": 0.5},
"CAPITAL_SHIP": {"sounds": [0], "pitch": 1, "volume": 0.6}
}
}
sounds 数组第一个资源的索引为 0，各档的 sounds: [0] 都引用这一项。本例复用已有循环文件，每档采用相同索引，只将音量分档。以后准备了独立引擎资源，再扩充数组并替换索引即可。
声音集的档位和资源选择可以分别调整。 当前配置用于验证登记与引用；实际制作时，素材与各档参数分别依据小型引擎和大型引擎的听感选择。
GearIn_engine_accelerate 采用相同结构，暂用开火文件作为可辨认的瞬时音。它与循环声音集分别登记，完整配置在下面给出。
登记市场音乐
音乐条目集中写进顶层的 music 分类，局部片段如下：
{
"music": {
"GearIn_market_music": [
{
"source": "sounds",
"file": "GearIn_market_theme.ogg",
"volume": 0.8,
"pitch": 1
}
]
}
}
source 可以是资源目录，也可以是原版使用的音频归档。当前 source 为 sounds，file 为该目录内的文件名；两者组合后指向 sounds/GearIn_market_theme.ogg。音乐 ID 为 GearIn_market_music，实际文件可以保持不同名称，使用方通过这个 ID 取得曲目。
选择合并与替换范围
新增 ID 写入自有对象，游戏启动时与其他来源的 sounds.json 合并。当前只提交本节定义的内容，原版声音继续由原版提供。
需要替换整份配置时，在 mod_info.json 的 replace 数组中声明 data/config/sounds.json。路径逐字符一致后，该操作改变整份文件的读取范围，替换内容需要承担相关声音定义。当前新增声音使用普通合并即可。
完整最小例
保存到 data/config/sounds.json。已有文件时合入这些自有键，music 里的条目放进已有 music 对象。
{
"GearIn_weapon_fire": [
{
"file": "sounds/GearIn_weapon_fire.ogg",
"volume": 1,
"pitch": 1
}
],
"GearIn_system_loop": [
{
"file": "sounds/GearIn_system_loop.ogg",
"volume": 0.8,
"pitch": 1
}
],
"GearIn_ui_feedback": [
{
"file": "sounds/GearIn_ui_feedback.ogg",
"volume": 0.8,
"pitch": 1
}
],
"GearIn_engine_loop": {
"sounds": [
{
"file": "sounds/GearIn_system_loop.ogg",
"pitch": 1,
"volume": 1
}
],
"FIGHTER": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.2
},
"FRIGATE": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.3
},
"DESTROYER": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.4
},
"CRUISER": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.5
},
"CAPITAL_SHIP": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.6
}
},
"GearIn_engine_accelerate": {
"sounds": [
{
"file": "sounds/GearIn_weapon_fire.ogg",
"pitch": 1,
"volume": 1
}
],
"FIGHTER": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.2
},
"FRIGATE": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.3
},
"DESTROYER": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.4
},
"CRUISER": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.5
},
"CAPITAL_SHIP": {
"sounds": [
0
],
"pitch": 1,
"volume": 0.6
}
},
"music": {
"GearIn_market_music": [
{
"source": "sounds",
"file": "GearIn_market_theme.ogg",
"volume": 0.8,
"pitch": 1
}
]
}
}
验证方案
- 保存声音配置，确认上一节资源位于对应 file 或 source 目录。
- 重启游戏，检查 JSON 解析与声音资源加载记录。
- 核对普通音效、两套分档集和 music 分类中的 ID。
- 按下一节的具体接入播放声音，再调整某个条目的 volume，保存并重启比较。
预期结果：
- 配置可读取，文件路径指向已准备的 Ogg 资源。
- 普通音效和船体声音集位于顶层，音乐位于 music。
- 使用方能按 ID 取得资源，volume 变化后采用新值。
- 原版与其他自有条目继续按同路径合并读取。
故障分析
JSON 解析失败：对象、数组、字符串或逗号不完整。
- 解决方案：按编辑器与日志检查错误位置，保存后重启。
资源不存在：file 与 source 组合后的路径或大小写错误。
- 解决方案：普通音效按相对 MOD 根目录核对，音乐按 source 目录与 file 核对。
音乐条目没有播放：分类或 source 字段未对应音乐读取结构。
- 解决方案：将 ID 登记在 music 对象中，补齐目录与文件。
声音集分档不符：档位索引没有对应 sounds 数组资源。
- 解决方案：从 0 开始核对索引和每档 pitch、volume。
整文件替换范围不符：replace 路径不同或替换配置缺少相关定义。
- 解决方案：核对目标路径与整份配置的实际职责。
总结
声音注册将 ID 连接到资源及播放参数。普通条目提供文件候选，分档集按船体等级选择资源与音量，音乐按 source 读取文件；三种结构分别供对应的使用方读取。
登记完成后，下一节写入对象引用并测试播放。资源、注册与播放分开核对，便能把没有声音的问题定位到相应位置。
建议参考项
data/config/sounds.json：原版音效、分档集与音乐结构。mod_info.json：replace 整文件读取范围。