Search Results for

    Show / Hide Table of Contents

    语音包实战

    中文 | 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 工程中操作:

    1. 在 Audio Bin 的 crew 下新建子文件夹,并导入录音。
    2. 在 Events 的 crew/ground 下新建子文件夹,用 Ctrl+D 复制现有分组,并修改后缀(例如 cn -> jp)。
    3. 用你的录音替换原 Playlist 中的片段,同时保留事件参数。
    4. 按 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"
      }
    ]
    
    In this article
    Back to top Panzer War Document