MusicXML 是一种记录了小节、音高、休止符、时值、声部与奏法记号的结构化数字乐谱文件。它不同于仅保存版面图像的 PDF，应用能够直接读取其中的记谱信息，从而将你在琴键上弹下的每个音与乐谱上的音符逐一精准对齐。从打谱软件或乐谱网站获取 MusicXML（.musicxml 或压缩格式 .mxl）后，先确认小节号与反复结构跟谱架上的乐谱一致，即可导入练习。
核心
- MusicXML 是结构化的记谱数据，PDF 是乐谱页面图像，MIDI 文件则是按键时间记录。
- 从打谱软件导出，或在乐谱网站下载时选择 MusicXML（.musicxml 或 .mxl）格式。
- 导入前先检查弱起小节、反复记号、延音线和装饰音是否记谱规范。
- 导入后先用 4–8 个简单小节试弹，确认判定的音符与小节线和谱面完全吻合。
MusicX
- MusicXML（.musicxml）：专为在不同打谱软件与练琴应用之间交换数字乐谱而制定的开放标准格式。它完整保留了音高、休止符、时值、小节线、调号与拍号、声部、力度与奏法记号等全部记谱信息。
- MXL（.mxl）：用 zip 方式压缩后的 MusicXML 文件。文件体积小得多，但里面包含的乐谱数据完全一致。
- PDF：将印刷版面保存为图像的文档格式。虽然人眼看起来一模一样，但里面并没有可供练琴应用读取的音符、时值或小节数据。
- MIDI 文件（.mid）：按时间轴记录何时按下、何时松开哪个琴键的演奏序列。它虽然有音高和速度，但通常缺失钢琴大谱表的左右手分谱、多声部划分、延音线与圆滑线的区别以及反复跳房子等关键记谱结构。
在交互式练琴反馈中，MusicXML 乐谱文件提供音乐坐标基准，而通过 MIDI 连接的电钢琴负责发送实时演奏信号。关于应用如何将两者对齐判定，可参阅MIDI 钢琴练习反馈的原理。
去哪里获取 MusicXML 乐谱文件
- 从打谱软件导出：在 MuseScore Studio、Dorico、Sibelius 或 Finale 等打谱软件的导出菜单中选择 MusicXML。完全免费的 MuseScore Studio 支持直接导出压缩（.mxl）或未压缩（.musicxml）格式。
- 从数字乐谱网站下载：下载乐谱时将格式选为 MusicXML。许多整理公有领域古典曲目的开源打谱项目也提供可自由使用的 MusicXML 文件。
- 手头只有纸质谱或 PDF 时：可以在打谱软件中把要练的段落打出来，或先用乐谱识别工具转换，校对修正识别错误后再导出为 MusicXML。
用
- 选用与谱架乐谱一致的版本如果你同时看着纸质乐谱弹，请确保数字文件与纸质谱是同一版本。如果小节划分、反复或删节不同，哪怕弹对了也会指到别的小节号上。
- 导入前先核对关键记谱细节在打谱软件里打开文件，检查小节号与弱起小节、反复记号与第一或第二结尾跳房子、尾声、延音线、装饰音、左右手声部分配，以及开头的速度标记是否准确。
- 将乐谱导入曲库在 Virtu 的「曲库」中点按「导入自备乐谱」并选择文件。在 iPhone、iPad 和 Android 上，也可以直接将下载好的文件通过系统分享或打开方式交由 Virtu 直接导入。
- 选择练习方式在导入的乐谱页面点按「添加卡包」，从「从头学起」「视奏」「分手练习」「双手」「技巧精炼」中选一个符合当前曲目进度的练习方式。
- 先用简单段落核对对齐情况挑 4–8 个节奏不复杂的小节，用从容的速度弹一遍，确认标出的音符和小节分界与谱面完全吻合。如果简单段落都对不上，先回打谱软件修好文件，再去练难点段落。
- 划定需要集中攻克的最小范围确认对位准确后，把要诊断的乐段不中断地完整弹一遍。对照标出的音符与小节分析，定下今天需要重点拆解的最小小节范围和当前速度。
常
因为弱起小节，后面的小节号全部错了一位
当曲子以不完整的弱起小节开头时，请在打谱软件中确认第一小节被设为了不计入常规小节号的弱起小节，而不是直接算作第 1 小节。
延音线连住的音被判成漏弹或错音
有些打谱不规范的文件把连接同音高的延音线误画成了表示乐句的圆滑线，导致应用以为第二个音需要重新按键。请检查延音线、声部归属与时值。
左右手的音看起来混在了一起
检查钢琴大谱表的高音谱表、低音谱表以及各声部是否已正确拆分为右手与左手，而不是把两只手的音全堆在同一行谱表里。
反复路线与预期不一致
Virtu 会严格按照乐谱中记写的反复记号、跳房子括号以及 D.C.、D.S. 跳转来展开演奏。如果文件里的反复记号与你的实际弹法不同，可以修改文件中的反复标记，或者直接在谱面上框选特定小节范围来练习。
弹装饰音时被判成多弹了音
先看文件是把装饰音记成了标准装饰音记号，还是直接写成了密集的普通小音符。凡是用标准记号记写的颤音、波音、回音和琶音和弦，无论你采用哪种常见的规范奏法，Virtu 都会判为正确。
直接导入未经校对的乐谱识别文件
用软件自动识别转换 PDF 往往会残留漏掉的临时记号、拍数算错的小节、多余的隐藏声部以及错位的小节号。练习前请先在打谱软件中打开清理一遍。
Virtu
在「曲库」中通过「导入自备乐谱」导入 MusicXML 文件（.musicxml、.mxl、.xml）后，Virtu 会直接根据记谱信息生成标准参考演奏。示范播放、单小节试听和练习判定全部基于同一份参考演奏，确保你耳朵听到的示范与评判标准完全一致。
- 在「添加卡包」中选好练习方式即可开始；若是四手联弹或室内乐等多声部总谱，可以先选择你要练的声部。
- 播放时会自动展开反复记号与结尾括号；练习时遇到延长记号会等待你的落键，在 rit. 渐慢段落则会跟随你放慢的步调。
- 可以用内置的画笔、橡皮擦、直尺和文本批注在导入的乐谱上标记指法或课堂笔记，也能直接在乐谱上框选任意段落开始练习。
常
应该下载 .mxl 还是 .musicxml 格式？
两种格式效果完全一样。.mxl 是将相同内容压缩后的标准格式，体积更小、传输更方便。就算手机浏览器在下载时把 .mxl 自动改存成了 .zip 后缀，Virtu 也能照常直接导入。
什么样的乐谱文件可以导入使用？
请使用你自己打谱制作的、合法购买的，或者处于公有领域及采用 CC0 等开放授权的乐谱文件。转换文件格式本身并不会改变作品或版本的版权归属。
如果手头只有 PDF 乐谱怎么办？
可以用免费的 MuseScore Studio 等打谱软件把需要重点练的段落打出来，或者用乐谱识别软件转成 MusicXML 后校对修正再导入。此外，也可以先在 Virtu 的「探索曲目」里搜一下，看看是否已经有现成可练的乐谱版本。