什么是音触 Studio？

音触 Studio 是音触内置的乐谱编辑器。它以「钢琴卷帘（Piano Roll）」的方式呈现乐谱：横轴是时间（节拍），纵轴是音高档位，每一个方块就是一次按键。你在这里排布的音符，就是自动演奏时游戏里被按下的键。

Windows 与 Android 上是同一套编辑器，功能与界面结构一致，差异只在输入方式和少数平台专属能力。本套文档不分平台，凡是只在某一端可用的功能都会就地标注 Windows 这样的标记。

它能做什么

• 可视化编辑：在网格上点、拖、框选音符，所见即所得。
• 实时试听：内置播放器与音色，编辑时随时听效果，配合节拍器和预备拍。
• 循环练段：在小节标尺上拖出 A–B 区间反复播放，专攻某一段。
• MIDI 步进录制：接上 MIDI 键盘，弹一个音写一个音符，节奏由网格决定而不由手速决定。
• 键盘映射：给每个音高档位指定游戏内按键，决定导出后按哪个键。
• 谱面体检：检查「编辑器里听着没问题，但导出后按不出来」的隐患。
• 整体移调：全曲统一升降若干档，带越界预检。
• AI 助手：用自然语言让 AI 直接读写谱面，改动可撤销。
• 多格式导出：Sky Studio 谱、MIDI、JSON。

核心概念

理解这四个概念，编辑器里的一切就都好懂了。

音高档位（Pitch）

Studio 不用绝对音名，而用档位序号：0 是最低音，数值越大音越高。一份乐谱的总档数在新建时确定（15 / 21 / 36），对应游戏内乐器的键位数。

注意方向

编辑区和钢琴键列都是高音在上、低音在下，但档位序号是 0 最低。所以屏幕最上面一行是序号最大的那一档。

钢琴键列上显示的是简谱唱名（1–7，加点表示高低八度），右侧小字是这一档映射到的游戏按键；显示 — 表示这一档还没配键，导出后按不出来。

节拍（Beat）与网格

音符的位置用节拍表示：0.0 是开头，1.0 是第 1 拍，2.5 是第 2 拍半。

音符位置只能落在网格线上，放置时会自动吸附。网格细分决定一格有多细：

细分	一格	相当于
1	1 拍	全音符
2	0.5 拍	二分音符
4	0.25 拍	四分音符（默认）
8	0.125 拍	八分音符
16	0.0625 拍	十六分音符

网格同时是「移动一格」「前进/后退一格」「MIDI 步进」的步长单位。

改网格会合并音符

把网格调粗时，原本挨得很近的音符会被吸到同一格上。同一音高同一拍只能有一个音符，多出来的会被合并掉（保留先出现的那个）。这一步可以撤销。

音符时长固定

游戏乐谱不支持长短音——点一次就是发一次声。所以每个音符的时长固定为 0.25 拍，不可调整。想表现长音，只能靠连续排布多个音符。

同位置唯一

同一音高、同一拍上只允许存在一个音符。重复添加会被忽略，拖动或粘贴到已占用的位置会被拒绝并提示「目标位置已有音符」。

工程参数范围

参数	范围	默认
BPM	30 – 300	120
拍号（每小节拍数）	2 – 16（分母固定为 4）	4/4
网格细分	1 / 2 / 4 / 8 / 16	4
音高档数	新建时选 15 / 21 / 36	—
横向缩放	50% – 200%	100%
编辑区长度	默认 40 拍（4/4 拍下 10 小节），可按 4 小节递增扩展	—

---

从 快速开始 走一遍完整流程，或直接查看 界面布局、编辑音符。