该技能用于发布影片(launch film)的音乐与音效设计,资料将其范围明确为“歌曲、音效与混音”三部分,命令为影片仓库的 npm run ... 脚本(由 kit/scripts/new-film.sh 生成)。
一、用途与基本原则 资料称声音是“高级感”的一半,并给出十条规则,其中可操作要点包括:真实音效包是感知质量提升最大的单项,代码生成的声音仅用于对齐时间;每个动作都应有声音(资料示例:39.4 秒内 352 个 cue,约每秒 9 个);声音要与画面事件对应,没有视觉起因就不加声音;先选歌再动画,影片按歌曲网格剪辑;一切以节拍计数,beat 0 为 drop;drop 即产品首次亮相的揭示点;声音按最响点而非起点放置;cue 写在画面旁边并使用与动画相同的节拍和辅助函数;先按度量筛选,再由人耳选择;交付前测量最终 mp4 而非 wav。
二、主要能力(对应脚本) 参考资料,流程步骤包括:
- 研究参考片:npm run refs -- <video> out/refs/<name>,读取 analysis.json 与 audio_vs_cuts.png;Shazam 在 3 个点运行,用于识别换歌的影片。
- 获取干净音源:npm run music:fetch -- "<artist> <title> [instrumental]",若 Shazam 命名不同则拒绝;优先纯伴奏,因人声会与画面文字冲突。
- 版权先行:短名单前在表格中写明每首歌的授权路径;大厂牌歌曲需要同步与母带两类授权,资料称费用为五位数、耗时数周且可能被拒。
- 找 drop:npm run music:scan -- <folder> 按三项度量排序文件夹;npm run music:grid -- <file> --drops 列出单曲所有 drop 及其铺垫。
- 试听:npm run music:audition -- <file> <drop_s> [--film-drop 9] 生成 20 秒片段,使歌曲 drop 落在影片 drop 位置,并拒绝没有真实低频跃升的片段;脚本会打印约提前 9 秒的 YouTube 链接。
- 锁定网格:npm run music:grid -- public/music/<file> --bpm <n>,固定速度、从低频找 drop、按底鼓拟合相位,误差超过 30 ms 即失败;输出小节表并写入 src/music.json,随后在其中设置授权。
- 段落映射:安静小节承接问题、drop 为揭示、break 为主视觉镜头、re-drop 为 logo。
- 接缝检查:npm run music:seams 对每个乐句跳转打分;song() 在场景过长或过短时于剪辑点拼接,npm run check 会在延迟不是整乐句时给出两种修正提示。
- 写音效:在各场景画面旁用角色(如 v("whoosh", i))而非文件名写 sounds(add),事件到声音的对照见 sfx-vocabulary.md。
- 混音与检查:npm run mix 打印 cue、长度、LUFS 与真峰值;npm run audio:check 执行“无耳朵”检查并输出 out/cue-sheet.png,需人工阅读该图。
三、可自动验证与不可判断的边界 资料明确“你听不到”,但可证明多项事实:对比重构前后的 out/sound.json cue 列表;npm run final 打印 mp4 的 LUFS 与真峰值;music:seams 需 ≥0.9 且阶跃小于 3 dB;audio:check 列出 2 帧内无 cue 的命名节拍、标记同一侧 40 ms 内被更响 cue 掩盖的情况,并打印每秒 cue 数与 cue sheet。同时要求向用户说明限制:数字只能证明曲子有 drop,不能证明它听起来昂贵。
四、使用自带音频 kit 自带生成占位音频以便第一天就能对齐时间,但资料称其不足以对外展示。音效包:复制文件到 public/sfx/,运行 npm run sfx:stats,在 public/sfx/roles.json 中把每个文件映射到角色,运行 npm run check(缺失文件的 cue 会失败)。歌曲:放入 public/music/,运行 npm run music:grid -- public/music/<file> --bpm <n>,在 src/music.json 设置授权,运行 npm run check,拼接守卫会提示需增删的节拍数。资料强调不得将授权音频提交到公开仓库,也不得将任何音频放入插件本身;.gitignore 已排除 public/music 与 public/sfx 音频。
五、参考文件与相关技能 music.md 涵盖速度区间、参考歌曲、干净音源、授权、扫描、drop 图、试听、网格锁定数值、music.json、段落映射与乐句拼接;sfx-vocabulary.md 涵盖视觉事件到声音的角色映射、时序与电平、叠加、密度、声像与电平指南;mix.md 涵盖混音步骤、实测响度表、失败情形与 kit 的预防方式、无耳朵检查标准;sourcing.md 涵盖音效与音乐来源及授权、安装自有音效包与歌曲、不可发布的内容。相关技能:launch-film:make 负责网格与预算,launch-film:review 在展示任何剪辑前检查声音覆盖,launch-film:assets 涉及 3D 运动的音效。
六、限制 资料未提供该技能的费用、适用平台、效果保证或具体授权价格数值之外的收费信息;其能力依赖影片仓库脚本与本地音频文件,资料未说明在其他环境中的可用性。