语音包实战
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。
python Docs/Manual/manual/tools/tutorials.py run voice-pack-practice --capture
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"package": "${fixture}/Docs_${runId}_Package.asset",
"pipeline": "${fixture}/Docs_${runId}_Pipeline.asset",
"packageGuid": "5cd6ae9b-1231-5334-90e0-87a3974c3d4a",
"bankConfig": "${fixture}/TutorialVoiceBank.asset",
"bankPipeline": "${fixture}/TutorialVoicePipeline.asset",
"crew": "${fixture}/TutorialCrewVoice.asset"
},
"calls": [
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateFolder",
"args": [
"${fixtureParent}",
"${folder}"
]
},
"expect": {
"contains": "(String)"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateAsset",
"args": [
"@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.ModPackageData)",
"${package}"
]
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateAsset",
"args": [
"@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.ModPackageBuildPiplineData)",
"${pipeline}"
]
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${package}/localizedModName/defaultName",
"value": "Tutorial Package"
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${package}/localizedDescription/defaultName",
"value": "Documentation teaching package"
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${package}/author",
"value": "Documentation"
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${package}/supportURL",
"value": "https://doc.game.windyverse.net/"
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${package}/guid",
"value": "${packageGuid}"
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${pipeline}/linkedModPackage",
"value": "@asset:${package}"
},
"expect": {
"contains": "OK:"
},
"phase": "build"
}
]
}
按 FMOD 工程设置 在可用的 Studio 工程中操作:
- 在 Audio Bin 的
crew下新建子文件夹,并导入录音。 - 在 Events 的
crew/ground下新建子文件夹,用 Ctrl+D 复制现有分组,并修改后缀(例如cn->jp)。 - 用你的录音替换原 Playlist 中的片段,同时保留事件参数。
- 按 Ctrl+2 打开 Mixer,确认新事件路由到
dialogs组。在 Banks 下另外建一个语音 Bank,把这些事件分配给该 Bank。构建需要的目标平台,再在 FMOD 工程的Build子目录检查相应平台的.bank文件。
回到 Unity,创建 SoundBankBuildPiplineData。在 Desktop/Mobile 分别指定对应的输出目录。用 Pick Multi Banks 从输出中选择 .bank 文件,检查配置列表自动生成的 SoundBankConfig 和各平台路径,再保存。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateAsset",
"args": [
"@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.SoundBankConfig)",
"${bankConfig}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateAsset",
"args": [
"@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.SoundBankBuildPiplineData)",
"${bankPipeline}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${bankConfig}/soundBankName",
"value": "tanks_crews_cn"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEngine.JsonUtility/FromJsonOverwrite",
"args": [
"{\"eventRefList\":[]}",
"@asset:${bankConfig}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Editor.SoundBankConfigEditor/RefreshBanks",
"args": [
"@asset:${bankConfig}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${bankPipeline}/desktopSoundBankPath",
"value": "../Fmod/Build/Desktop"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${bankPipeline}/mobileSoundBankPath",
"value": "../Fmod/Build/Mobile"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
"args": [
"local U, E = CS.UnityEngine, CS.UnityEditor\nlocal bank = E.AssetDatabase.LoadMainAssetAtPath('${bankConfig}')\nlocal pipeline = E.AssetDatabase.LoadMainAssetAtPath('${bankPipeline}')\nlocal configType = CS.ShanghaiWindy.Core.SoundBankBuildPiplineData.Config\nlocal row = configType()\nrow.soundBankConfig = bank\nrow.desktopSoundBankPath = pipeline.desktopSoundBankPath .. '/' .. bank.soundBankName .. '.bank'\nrow.mobileSoundBankPath = pipeline.mobileSoundBankPath .. '/' .. bank.soundBankName .. '.bank'\nlocal rows = CS.System.Array.CreateInstance(typeof(configType), 1)\nrows:SetValue(row, 0)\npipeline.configs = rows\nassert(CS.System.IO.File.Exists(row.desktopSoundBankPath))\nE.EditorUtility.SetDirty(pipeline)\nE.AssetDatabase.SaveAssets()\nreturn 'Bank row linked'\n",
"link-voice-bank",
"null"
]
},
"expect": {
"contains": "Bank row linked"
}
}
]
创建 CrewFmodVoiceData,用事件选择器为 StartBattleEvent 等字段绑定上一节创建的事件。把乘员语音资源和 Bank 构建资源都加入模组构建管线的 Linked Objects,再对目标平台构建并打包。

点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateAsset",
"args": [
"@static:UnityEngine.ScriptableObject/CreateInstance(ShanghaiWindy.Core.CrewFmodVoiceData)",
"${crew}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${crew}/voiceName/defaultName",
"value": "Tutorial Crew"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
"args": [
"local E = CS.UnityEditor\nlocal bank = E.AssetDatabase.LoadMainAssetAtPath('${bankConfig}')\nlocal crew = E.AssetDatabase.LoadMainAssetAtPath('${crew}')\nfor index = 0, bank.eventRefList.Count - 1 do\n local evt = bank.eventRefList[index]\n if evt.Path:lower():find('start_battle_cn', 1, true) then\n crew.StartBattleEvent = evt\n E.EditorUtility.SetDirty(crew)\n E.AssetDatabase.SaveAssets()\n return evt.Path\n end\nend\nerror('No start-battle event found in bank')\n",
"wire-voice-crew",
"null"
]
},
"expect": {
"contains": "start_battle_cn"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${crew}/StartBattleEvent/Path"
},
"expect": {
"contains": "start_battle_cn"
}
},
{
"tool": "invoke",
"arguments": {
"path": "asset:${pipeline}/linkedObjects/Add",
"args": [
"@asset:${bankPipeline}"
]
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "asset:${pipeline}/linkedObjects/Add",
"args": [
"@asset:${crew}"
]
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.EditorUtility/SetDirty",
"args": [
"@asset:${pipeline}"
]
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/SaveAssets",
"args": []
},
"expect": {
"contains": "OK:"
},
"phase": "build"
},
{
"tool": "modpack_plan",
"arguments": {
"pipeline": "${pipeline}"
},
"expect": {
"equals": {
"ok": true,
"built": false
},
"contains": "\"crewvoice\""
},
"phase": "build"
},
{
"tool": "modpack_build",
"arguments": {
"pipeline": "${pipeline}"
},
"expect": {
"equals": {
"ok": true,
"archiveExists": true,
"published": false,
"installed": false
}
},
"capture": {
"archivePath": {
"path": "archivePath"
}
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "static:Frontend.Editor.ModPackageWorkshopMeta/WriteSidecar",
"args": [
"${archivePath}"
]
},
"expect": {
"contains": ".modpack.json"
},
"capture": {
"sidecarPath": {
"regex": "\\(String\\) (.+)"
}
},
"phase": "build"
},
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.File/ReadAllText",
"args": [
"${sidecarPath}"
]
},
"expect": {
"contains": "${packageGuid}"
},
"phase": "build"
}
]