SuperAPI AI 工具集

audio-setup-mixers

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:将场景中的 Audio Source 按其所播放的内容分类,并路由到项目中已有的 Audio Mixer Group,用于清理混乱的混音器分配。

主要能力:通过 Unity CLI 在实时 Editor 中执行 C#,先盘点项目中所有 Mixer 及其 Group 名称,再查找场景内全部 Audio Source,依据其 Generator 资源名(如 FootStep4_Sound→Foley、Dialogue_Female_Scene4→Vox/Voice/Dialogue、GunShot→SFX、Menu_Theme_Variation→Music)归纳类别,资源名不具描述性时参考 GameObject 名或相邻 MonoBehaviour 名。随后提出路由方案与用户确认,最后批量分配输出组,并把整轮操作包在单个 undo 步骤中。

使用方式:先按 unity-cli 技能准备环境,确认 Editor 已连接、已添加 com.unity.pipeline 包,并确认命令目录中存在 eval(其存在取决于 Pipeline 包版本)。用 unity command eval --code '<snippet>' 运行 C#;eval 编译语句块而非文件,因此不能写 using 指令,类型必须完全限定。部分版本还注册 eval_file,使用前先查目录。unity command 默认超时 30 秒。

限制:创建 Mixer 或 Group 没有公开 API,本技能不会代为创建,需用户在 Audio Mixer 窗口手动添加,之后重新盘点确认名称与拼写。不要用反射创建 Group,也不要手改 .mixer 文件。路由结果保存在 Audio Source 上,只有保存场景后才持久化,需征得用户同意再保存。音量、效果与重父级不在范围内。若返回 NO SUCH GROUP 或 NOT IN THE MAPPING,应报告并与用户解决,不能静默跳过。无 Mixer 时应停止并请用户创建。