扒谱卡在和弦听辨
吉他手在排练室扒一首日系摇滚，前奏的七和弦与九和弦反复听辨不准，卡在第二小节整整二十分钟。打开本工具，用鼠标点出怀疑的音符组合，实时听和弦声响，同时对照钢琴卷帘的视觉排列，确认是 Cmaj9 而非 Cmaj7。确认后直接导出 MIDI 片段，导入 DAW 比对原曲，一次过关。
未录制
已记录 0 个音符 · 时长 0.0s
电脑键盘弹奏：中央八度白键
ASDFGHJ（C D E F G A B），
黑键 WETYU（C# D# F# G# A#）；
高八度白键 KL;，黑键 OP。按下发声、松开停止；按 八度移调 整体升降。
就绪 · 点击琴键或按电脑键盘开始弹奏
钢琴 · 4 个八度 · 28 白键
第一节
关于本工具
About半夜想录一段即兴钢琴旋律，打开 DAW 却发现声卡驱动报错。这个工具让浏览器变成一台 MIDI 工作站：键盘鼠标或触屏直接弹奏，录下的音符可导出为标准 MIDI 文件，拖进任何编曲软件继续编辑。所有音序处理都在本地完成，录音数据不会离开设备——适合灵感速记、扒带练习或临时演示，不依赖外接硬件。
使用场景
编曲灵感碎片记录
凌晨两点在出租屋写歌，脑子闪过一段 8 小节旋律，手边没有 MIDI 键盘，手机录音又怕天亮后听不清哼唱。打开本工具，用键盘鼠标逐音点出动机，踩下延音踏板模拟真实手感，录完后导出 MIDI 文件，直接拖进 Logic Pro 继续配器。从闪现到存档，全程不到三分钟。
钢琴教学作业批改
线上钢琴课布置了车尔尼 599 第 34 条，学生发来一段手机录音，伴奏声部被环境噪音盖住。老师打开本工具，用鼠标在钢琴卷帘上逐音重录学生的右手旋律，生成 MIDI 对比原谱，发现第 12 小节有半音级进错误。将正确 MIDI 导出发给学生，学生导入自己的打谱软件，一眼看清错音位置。
游戏配乐音效试听
独立游戏开发者要设计一段「地牢机关激活」的上升音阶，手头没有合成器，也不想在 DAW 里调半天音色。用本工具快速点出 C-E-G-C 上行琶音，切换不同八度试听紧张感，确认合适后导出 MIDI，直接拖进 Wwise 挂载钢琴音源做原型。整个音效设计从构思到导出，不到五分钟。
合唱团分声部示范
社区合唱团排练《城南送别》，女高音声部有 3 个临时升降号，团员总唱不准。指挥打开本工具，只弹女高音声部的旋律线，用高八度音色突出音准，录成 MIDI 发到微信群。团员在家用手机播放 MIDI 跟唱，比听全曲伴奏更易抓住自己的声部，排练效率提升明显。
第二节
使用指南
Getting Started使用步骤
- 1点击键盘上的琴键或连接 MIDI 设备，琴键会高亮并发出对应音高
- 2按下「录音」按钮，弹奏内容实时记录为音符序列，界面显示录音时长
- 3弹奏结束后点击「停止」，录音列表中出现一条新条目，标注时长与音符数
- 4点击条目旁的「导出」按钮，浏览器直接下载一个 .mid 文件，文件名含时间戳
输入输出示例
| 输入 | 输出 | 说明 |
|---|---|---|
| 点击键盘 C4 → 录制 2 秒 → 停止 | MIDI 文件（.mid），包含 1 个音符：C4，时长 2 秒，力度 100 | 常规：最基本的单音录制，验证核心功能（音符识别、时长、力度）是否正常 |
| 依次点击 C4、E4、G4（C 大三和弦）→ 录制 3 秒 → 停止 | MIDI 文件，包含 3 个音符：C4、E4、G4，同时开始，时长 3 秒 | 常规：多音同时弹奏，验证和弦录制与多轨道输出是否正确 |
| 不点击任何键 → 直接点击“录制” → 等待 5 秒 → 停止 | MIDI 文件，0 个音符，时长 5 秒 | 边界：空录制，验证工具对无输入情况的处理（应输出空 MIDI 而非报错） |
| 快速连续点击 C4 10 次（间隔 < 0.1 秒）→ 录制 1 秒 → 停止 | MIDI 文件，包含 10 个 C4 音符，每个音符时长极短（约 0.05 秒），力度可能因点击速度略有波动 | 边界：极高频率的重复音符，验证工具对快速连击的采样精度与音符分离能力 |
| 按住 C4 键不放 → 录制 30 秒 → 松开 → 停止 | MIDI 文件，包含 1 个 C4 音符，时长 30 秒，力度恒定 | 边界：超长持续音符，验证工具对长时值音符的录制稳定性（无中断或截断） |
| 点击键盘 C4（力度 127）→ 录制 1 秒 → 停止 | MIDI 文件，包含 1 个 C4 音符，力度 127 | 易错：最大力度值，验证工具是否支持 MIDI 力度范围 0-127，且输出正确 |
| 点击键盘 C4 → 点击 C#4（升半音）→ 录制 2 秒 → 停止 | MIDI 文件，包含 2 个音符：C4（音高 60）、C#4（音高 61），各自独立 | 易错：半音相邻音符，验证工具对黑键（升/降号）的识别与音高编号映射是否正确 |
| 点击键盘 C4 → 导出 MIDI → 用其他软件（如 GarageBand）导入该文件 | 导出的 .mid 文件可在其他 DAW 中正常播放，音符 C4 位置、时长、力度与原录制一致 | 易错：跨软件兼容性，验证导出的 MIDI 是否符合标准格式（SMF），无私有扩展导致无法导入 |
常见错误对照
1.用鼠标点键盘时没先激活音色，弹出来的是默认钢琴声
✗ 错误
打开页面直接点键盘，发现声音不对，再点音色下拉框✓ 修复
先点击音色选择（如“电钢琴”“管风琴”），再开始弹奏键盘部分实现中音色切换只影响后续按键，已按下的键不会重发新音色，需先选音色再弹。
2.录制时点了录音按钮但没点停止，直接关页面导致录音丢失
✗ 错误
点红色录音按钮开始弹，弹完直接关闭浏览器标签页✓ 修复
弹完后点停止按钮（通常方形图标），再点导出/保存录音数据存在内存中，关闭页面会触发页面卸载，未持久化的录音数据全部丢失。
3.导出 MIDI 后直接双击打开，系统没有关联播放器
✗ 错误
下载 .mid 文件后双击，弹出“无法打开此文件”✓ 修复
将 .mid 文件拖入 DAW（如 GarageBand、FL Studio）或专用 MIDI 播放器浏览器只负责导出标准 MIDI 文件，不负责播放；操作系统默认不关联 .mid 扩展名。
4.录制时同时按了多个键，导出 MIDI 后和弦音头不对齐
✗ 错误
录制时快速按下 C、E、G 三个键，导出后三个音的开始时间有微小偏移✓ 修复
录制和弦时尽量同时按下所有键，或后期在 DAW 中量化对齐浏览器键盘事件有毫秒级延迟差异，同时按下的多个键会生成不同时间戳，需要量化处理。
5.用触屏设备弹奏时没关掉系统手势，触发返回/刷新
✗ 错误
在手机/平板上弹钢琴键盘，手指滑动时页面跟着滚动或返回✓ 修复
在浏览器设置中关闭“滑动返回”手势，或使用全屏模式（F11）触屏浏览器默认将水平滑动识别为导航手势，会拦截键盘区域的触摸事件。
6.导出 MIDI 后以为能直接听到声音，没导入任何软件
✗ 错误
下载 .mid 文件后直接再次上传到本工具，期望播放✓ 修复
将 .mid 导入 DAW 或 MIDI 播放器，或在本工具内先点击播放按钮试听MIDI 是控制指令序列（音符、力度、时长），不是音频文件；需要合成器才能发声。
7.键盘按键和钢琴键位对不上，以为是工具坏了
✗ 错误
按键盘上的 A 键，听到的是 C 音，以为音准有问题✓ 修复
查看键盘映射图（通常页面有标注），A 键对应 C 音是标准映射计算机键盘不是钢琴键盘，常见映射为：第一排字母（A S D F）对应 C D E F，与音名无关。
8.录制时打开了多个浏览器标签页，录音混在一起
✗ 错误
同时打开两个工具标签页，分别弹奏，导出时发现音符混乱✓ 修复
每次只在一个标签页内录制，或关闭其他标签页的音频上下文浏览器 AudioContext 是全局共享的，多个标签页的录音会相互干扰，导致输出文件包含杂音。
第三节
工作原理
How It Works核心公式
f = 440 × 2^{(n - 69) / 12}
变量说明
f音符频率，单位 HznMIDI 音符编号，0–127
示例
中央 C 的 MIDI 编号为 60：f = 440 × 2^{(60 - 69)/12} = 440 × 2^{-0.75} ≈ 440 × 0.5946 ≈ 261.6 Hz。该频率对应钢琴键盘第 40 键（C4），是标准调音基准。
用户操作
本地处理
输出结果
第五节
常见问题
Q & A问用这个弹琴，键盘上的键能对应电脑键盘吗？＋
答
可以。默认映射为：电脑键盘的 A S D F G H J 对应 C D E F G A B（白键），W E T Y U 对应 #C #D #F #G #A（黑键）。按 Z 降低八度，按 X 升高八度。在页面左侧的「键盘映射」面板可自定义键位，适合手小或习惯不同布局的用户。
问录完的 MIDI 文件怎么导出？能直接下载吗？＋
答
弹奏过程中点击「录制」按钮开始录音，结束录制后页面会生成一条录音记录。点击该记录右侧的「导出 MIDI」按钮，浏览器会自动下载一个 .mid 文件。该文件可在任意 DAW（如 FL Studio、Cubase）或 MIDI 播放器中打开编辑，音高、时长、力度信息都会保留。
问为什么我按键盘没声音？已经点了页面了。＋
答
常见原因有三个：1. 浏览器未授予音频权限——首次点击页面时浏览器会请求权限，需点击「允许」；2. 浏览器标签页被静音——检查标签页图标是否有喇叭静音标志；3. 系统音量或浏览器音量过低。推荐使用 Chrome 或 Edge 最新版，Safari 需在「站点设置」中开启自动播放。
问这个工具能接 MIDI 键盘弹吗？＋
答
不支持。本工具仅通过电脑键盘或触摸屏（手机/平板）操作，无法识别外接 USB MIDI 键盘的信号。如需使用物理 MIDI 键盘，建议改用系统本地的 DAW 或专门的 Web MIDI API 工具。但本工具录制的 MIDI 导出后可在其他软件中通过 MIDI 键盘回放编辑。
问手机竖屏的时候键盘显示不全，怎么调？＋
答
手机浏览器默认竖屏时，琴键数量自动缩减为 1-2 个八度以适应屏幕宽度。建议将手机横屏使用，可显示完整 3 个八度。如果横屏后仍显示不全，可缩小页面（双指捏合）或开启浏览器的「桌面版网站」模式。部分安卓浏览器可在设置中关闭「强制缩放」。
问录好的 MIDI 能转成 MP3 或 WAV 吗？＋
答
本工具只导出 MIDI 文件（.mid），不直接输出音频。MIDI 是乐谱指令序列，不是波形音频。如需转 MP3/WAV，可将导出的 .mid 文件导入 GarageBand、FL Studio 等软件，选择音源后渲染导出为音频。也可使用在线 MIDI 转音频工具，但音质取决于所选音源库。
问为什么我录的 MIDI 播放出来音高不对？＋
答
可能原因：1. 录制时按了八度升降键（Z/X）——这些键会改变后续按键的八度位置，检查录制过程中是否误触；2. 导出后在其他软件中播放时音源音高基准不同（如 440Hz vs 432Hz），但 MIDI 数据本身是标准音高编号，与调音基准无关。建议在本工具内先回放确认原始录制是否正确。
隐私保证所有计算与处理均在你的浏览器本地完成，输入数据不会上传服务器，也不会保存或共享。