页面打开时会自动加载同目录下的 songs.json 作为在线曲库(托管到 Cloudflare 后,更新该文件即可更新曲库,无需改 HTML);
也可以手动导入 JSON 文件(可一次导入多首,导入的曲子保存在本机浏览器)。
{
"name": "我的小曲", // 必填,曲名
"bpm": 100, // 必填,速度:每分钟四分音符数(自动播放用)
"seq": "C4 C4 G4:2 | F4 F4 E4 E4 D4 D4 C4:2"
}
seq:空格分隔的音符序列。| 为小节线(仅显示用,可省略)。音名:拍数,如 G4:2 表示 G4 弹 2 拍;不写拍数默认为 1 拍,支持小数如 E4:0.5(八分音符)。C4 ~ B5,黑键用 #,如 F#4、A#5。"notes": ["C4", {"note":"G4","beats":2}, "|", ...]。[{...}, {...}] 一次导入多首。
默认布局(全覆盖 C4–B5):
低音区(C4–B4):白键 Z X C V B N M,黑键 S D G H J;
高音区(C5–B5):白键 Q W E R T Y U,黑键 2 3 5 6 7。
跟弹模式:曲谱上蓝色高亮为当前要弹的音,琴键同步高亮;弹对自动前进,弹错不推进。
自动播放:按曲谱 bpm 与拍数自动演奏,琴键与曲谱同步高亮,可随时停止;右侧下拉框可切倍速。
自定义键位:点击「自定义键位」后,先点一个琴键,再按下想绑定的键盘按键(Esc 取消);映射保存在本机浏览器。
自由弹奏:不跟随曲谱,随意弹奏(键盘 / 鼠标点击均可)。