更新日志

我们的 REST API 规范已迁移到 OpenAPI 3.1，OMR API 结束了测试阶段，Flat for Education 中的作业也不再局限于列出和创建。

• OMR API 已稳定。 端点、字段和行为现在都会在任何破坏性更改之前遵循我们常规的弃用流程。新的 FAQ 涵盖了点数与计费、限制与处理时间、识别质量与语言，以及商业用途与隐私。
• 在 Flat for Education 中读取、更新和删除作业。删除作业时，也会一并删除其提交内容和学生副本；如果你想保留这些内容，请改为将其归档。
• 点数台账。 新增调用可列出你的点数历史；余额仍保留在 OMR capabilities 调用中。
• 支持导入 Finale 文件（.musx），按 best-effort 方式处理；同时，乐谱创建中的扫描乐谱导入（PDF 和图像）现已写入文档。
• OpenAPI 3.1。 可空字段使用 3.1 语法；固定使用 OpenAPI 3.0 的工具需要更新。mimeType 字段已从 OMR 文件上传中移除。

选中一段乐谱后按 L，它就会一直重复，直到你让它停止；同时音符仍可编辑，因此你的每一次修改都会在下一轮循环中立即听到。循环模式在所有套餐中均可免费使用。

• 三种启动循环的方式：选中小节后按 L，在选择菜单中选择“循环”，或点击顶部栏中的循环按钮，对光标所在的小节进行循环。你还可以拖动手柄来扩大或缩小范围，即使在播放时也可以操作。
• 音符仍然可以编辑。 在播放时点击一个音符并修改它，就能在下一轮听到效果。循环也支持与同步的 YouTube、Vimeo、SoundCloud 或已上传录音配合使用。
• 播放会从光标位置开始，而不是从头开始。停止后会保留当前位置：按 Space 会从光标处播放，按 Shift + Space 会从音乐停止的确切位置继续播放（在移动设备上请长按 Play）。返回开头时，如果当前已停止，会移动光标；如果正在播放，则会重新开始播放。

现已在网页端的新编辑器和 Android 上的新移动工具栏中提供；iOS 随后推出。嵌入式乐谱也可通过 embed API 使用循环功能。

Flat for Education 中的编辑器现在使用与 Flat 相同的工具栏：左侧的垂直侧边栏可打开记谱、乐器、布局和详细信息面板，以及专为课堂设计的面板。

• 面向学生的作业面板：作曲、协作写作、演奏、练习单和自由录音现在都会在乐谱旁显示各自的面板，教师说明一键可达，面板还可分离为浮动窗口。
• 面向教师的评阅面板：在批改每位学生的作业时使用相同的布局，并且在创建作业时会显示与之对应的学生乐谱预览。
• 默认启用快速搜索：输入你要查找的内容，编辑器就会找到相应工具，搜索结果仅限于你的工具集允许使用的工具。

想了解新版侧边栏的更多信息，请查看博客文章。

我们自研模型的新版本现已用于所有 PDF 和照片导入，重点改进了对页面上连音组印刷方式的识别。

• 现已支持隐式连音。 制谱人员通常只会在一段乐句中第一组三连音或六连音上方标一个小小的“3”或“6”，后续同样的分组则不再重复标注——默认演奏者会延续这一模式。这些没有标记的分组就是隐式连音：实际要按连音演奏，但页面上没有明确写出来。它们在 19 世纪版本、练习曲和变奏曲中非常常见。现在，扫描会根据小节的节奏将它们还原出来，而不是为了让小节符合拍号而删掉音符。
• 凭空生成的连音更少了。 过去，即使普通的符杠分组上方没有印数字，模型也可能把它们识别成三连音，于是这些数字会出现在你的乐谱里。现在，只有页面上确实画出了连音标记的地方，才会写入连音。

• 数据保留由你控制。 OMR 任务现在会告知其文件会保留多久（默认 30 天），每个 MusicXML 任务都会附带其到期日期，并且你可以在取回任务文件和结果后立即将其删除。
• 登录前即可检测功能。 OMR capabilities 调用现在无需账户即可使用，并会列出支持的识别语言及其名称。
• 支持导出 ABC 记谱，适用于任意乐谱修订版本，与 MusicXML、MIDI 和其他格式并列提供。与 MIDI 一样，它不包含完整的排版信息。
• 在 Flat for Education 中，Free Record 作业现在可以通过 API 进行配置。
• 来自上游提供商的错误（例如 Google Classroom）现在会附带该提供商自己的本地化消息。

Flat for Education 编辑器现在已推出 Mac 和 Windows 桌面应用。对于学校许可证覆盖的所有账户——教师、学生和管理员——都是同一个账户、同一批乐谱。

• 可离线使用。 课堂上没有 Wi‑Fi？依然可以继续作曲和编辑：你的工作会保存在电脑上，下次联网打开应用时，更改会同步回你的账户。
• 完整乐谱库，保持同步。 登录后，你的所有乐谱、作业和班级都会同时出现在网页版和桌面版中。你可以在浏览器中开始一份乐谱，再到应用中继续，反过来也可以。
• 完整编辑器，独立窗口运行。 乐谱编辑、播放、MusicXML 和 MIDI 导入导出、PDF 导出，以及通过 USB 或蓝牙 MIDI 键盘输入音符。
• 可安装到所有电脑上。 机房电脑、教职员工笔记本、学生家中的电脑：安装数量没有按席位限制。

可前往 flat.io/edu/desktop 下载，或在网页版应用的账户菜单中获取：它会为你的电脑自动选择正确的下载项。

我们自研模型的新版本现已用于所有 PDF 和照片导入，在扫描乐谱基准测试中的错误率降低了 22% 到 51%。提升在较难的页面上最明显——例如较老的雕版印刷谱面和印刷不均匀的页面。

Flat 自研模型的改进版本现已用于所有 PDF 和照片导入，尤其包括：

• 现已支持带共享休止符和隐藏休止符的多声部段落。
• 小节线和反复结束括号（volta）现在可以在小节内正确放置。
• 连梁的识别现在更可靠。
• 现在可以识别像管弦乐总谱那样跨多个谱表绘制的拍号。
• 修复了部分和弦符号导出到 MusicXML 时使用非标准和弦类型的问题。

演奏作业现在不再需要附加乐谱。创建作业时，在乐谱这一步选择 Free Record，学生就可以根据作业要求录制自己的演奏：自己的曲目、即兴演奏、热身练习，或只存在于纸上的作品。

• 对于教师。 创建流程会隐藏那些只有在有乐谱时才有意义的选项（回放、节拍器、伴奏音轨、速度）。学生提交的内容会进入专为录音设计的批改界面，您可以像往常一样试听、评论并评分。
• 对于学生。 作业会打开到录制界面，旁边显示您的说明。学生可以录制、回听，并在准备好后提交。支持视频录制。

基于乐谱的演奏作业仍和以前完全一样。更多信息请阅读博客文章。

视奏生成器现在可以更精细地控制生成内容，也让学生能够自行使用它。

• 选择调号和拍号。 选择一个或多个调以及拍号后，生成的每条练习都会限制在这些设置内，并遵循你为乐器设定的音域。
• 为整个乐队生成分谱。 为乐队生成练习时，每个声部都会获得自己的分谱，使用相应的谱号和移调（固定音高、B flat、E flat、F、低音谱号），同时演奏同一条旋律线。
• 直接加入作业。 你可以在创建演奏作业的流程中直接打开生成器，并在不离开当前流程的情况下附加生成结果。
• 学生练习模式。 学生可以在自己的工具页面中找到该生成器，按自己的节奏生成视奏练习，在任何作业之外单独练习。不会提交，也不会评分。
• 在轨道视图中打开。 生成的练习会在水平轨道视图中打开，便于从左到右阅读，并且不会连续出现两个休止符。

更多信息请见博客。

在网页版应用中，从 PDF 或照片导入乐谱现已采用新的流程，基于 Flat 自研的识别引擎。它将为所有用户替代此前的 PDF 导入方式。

• 选择你需要的页面。 上传一个 PDF 或多张照片，然后只保留包含乐谱的页面。每保留一页都会消耗 1 个额度。
• 在识别进行时查看进度。 进度条会按页面显示扫描进行到哪一步，并且你可以在处理期间继续使用 Flat。
• 在生成乐谱前先复核。 当识别引擎无法确定某个乐器时，它会请你确认标题以及识别出的乐器，并在每个乐器旁显示该页面上印刷的声部名称。如果所有乐器都能被明确识别，则会跳过此步骤。

Flat 现已提供此功能；对于教师和管理员，也可在 Flat for Education 中使用。新流程将在未来几周内登陆 iOS 应用。

Flat 的 OMR 引擎现已可通过开发者 API以编程方式使用。您可以发送 PDF 或照片，跟踪识别进度，检查识别出的乐器，然后将结果作为可编辑的乐谱导入 Flat 资料库，或导出为 MusicXML 或 MIDI。这与编辑器中用于导入 PDF 和照片的内部模型相同，现在也可大规模用于您自己的应用和工作流程。

专用 OMR API（v2.24.0）建立在 v2.23.0 中添加到乐谱创建流程的后台 PDF 导入功能之上：导入文件时请求任务支持，并轮询该任务直到乐谱准备就绪。有关这两个版本的详细信息，请参阅 API 更新日志。

Flat for Education 现在有四种账户角色：Admin、Support Admin、Teacher 和 Student。新的 Support Admin 角色适用于在幕后运营学校的人员（IT 联系人、财务团队、主管）——他们需要管理账户，但不承担教学工作。

• 完整管理权限：Billing 和订阅、People（邀请和移除教师与学生）、学校设置、Integrations 以及 Usage Dashboard。
• 不含教学工具：没有班级，没有作业，也没有需要批改的学生作品。
• 不占用许可席位：学校需要多少位 Support Admin，就可以添加多少位。如果某人仅为了查看 Billing 而持有 Admin 角色，将其改为 Support Admin 即可在不增加额外费用的情况下释放一个教师席位。

Admin 和 Support Admin 可在 People 部分分配角色。请参阅角色与权限了解每种角色可以执行的操作，或阅读这篇博客文章。

我们改进了扫描时对页面版面的读取方式。现在导入 PDF 和照片时，生成的乐谱会更干净、更准确，尤其是在复杂版面中：

• 内容密集的页面现在能正确拆分。 对于上下堆叠了许多短行谱表的页面，不会再被合并到一起——每个系统都会被单独检测出来。
• 更适合管弦乐总谱和大型合奏总谱。 钢琴、管风琴等多谱表乐器，以及包含许多谱表的大型总谱，现在都能更可靠地识别。
• 宽版、横向和小册子版式。 横向页面的左边缘不再被裁切（否则可能会切掉谱号），多页扫描和小册子扫描现在也能被正确处理。
• 更少的误检。 页面页脚和边距附近的无关元素不再被误识别为音乐内容。

Flat for Education 中的调音器已围绕学生实际演奏的乐器重新设计。

• 乐器预设。 可选择吉他、贝斯、尤克里里、曼陀林等乐器，包括 7 弦和 8 弦吉他、次中音尤克里里、5 弦贝斯和曼陀拉，调音器会显示每根需要调音的琴弦。原来的自由音高模式现已更名为 Chromatic。
• 替代调弦。 Drop D、开放调弦以及其他常见替代调弦现已适用于所有有品弦乐器，不再仅限于吉他。
• 参考音。 播放某根弦的音高，按听觉进行调音。
• 校准与精确读数。 当合奏需要时，可将参考音高设置为不同于 A = 440 Hz 的值，并在检测到的频率旁查看以音分为单位的偏差。重新设计的指示表会固定目标位置、移动指针，同时还会显示最近演奏音符的历史记录。
• 在编辑器中。 也可以从编辑器工具栏打开调音器，并自动预选当前声部所用的乐器。

你可以在 Tools 中找到它，它位于节拍器和音调发生器旁边；也可以阅读练习工具指南。

现在，所有 PDF 和照片导入都会由 Flat 自研的内部模型处理。这个版本是一次重要的新版本更新，重点提升了转谱准确性：在所有测试集中，乐谱的音乐正确性（决定乐谱是否正确的音符、节奏、连结线和临时记号）都有所提升，其中提升最明显的是：

• 力度记号：+39%
• 延长记号、演奏法、连结线、临时记号：+30 to 37%
• 音符时值：+22%
• 连线、附点音符、休止符、谱表和声部分配：+14 to 20%

文本、力度记号和版面位置也更加精确：歌词、和弦名称和力度记号现在能更可靠地附着到正确的音符上，包括钢琴大谱表以及带有谱号变化的声部等复杂版面。

我们正在逐步上线 Flat 自研的 PDF 和照片导入 AI 模型。该模型由我们内部设计并训练，用来替代产品上线时使用的第三方引擎。拥有端到端的技术能力后，我们可以进一步提升准确率，扩展可识别的记谱内容，更快交付改进，并让识别结果更好地贴合 Flat 自身的乐谱格式，使导入内容能够更自然地融入产品的其余部分。仅首个版本，就已经能读出你乐谱中更多的内容：

更广的记谱覆盖范围。 新增可识别内容：

• 和弦符号，会按其音乐含义正确编码为可编辑的和弦，而不只是普通文本
• 小节反复记号和节奏斜线
• 速度标记和节拍器标记（含 BPM）

支持更多语言的歌词和文本。 现在默认可识别使用拉丁字母的语言中的歌词、排练记号及其他文本，同时也支持日语、韩语和中文。

更贴近原始版面。 现在导入结果会更紧密地遵循源乐谱的版面布局，包括每行的小节数、每页的系统数以及整体结构。这对于大型复杂乐谱（如管弦乐作品）以及钢琴这类多谱表乐器尤其有帮助。现在还支持更多页面格式，包括此前不支持的横向页面。

这是自 2024 年以来最大的一次规范更新，使 API 跟上过去两年的产品变化。

• 支持从 15+ 种格式导入。 Guitar Pro、MuseScore、ABC notation、PowerTab、Capella、MEI、Overture、TablEdit、Band-in-a-Box、Karaoke MIDI、MuseData、Score Writer、Bagpipe Music Writer 和 Encore 现已加入 MusicXML 和 MIDI 的支持范围，乐谱也可以导出为原生 .flat 文件。
• 虚拟集合。 All scores、collaborations 和 likes 取代了资料库中旧版的文件夹层级，与重新设计后的 Flat 资料库保持一致。
• Flat for Education。 支持带音频或视频录音的演奏作业，以及 backing track、metronome 和 speed 选项；用于协作写作的小组提交；富文本说明；学生子分组；可定时并单独指定对象的 Microsoft Teams 作业；资源库中的富描述和作业类型。
• 统一的 LTI 配置，适用于 LTI 1.1 和 1.3，并包含动态注册。此前的 LTI 1.1 凭据调用已弃用。
• 新增乐谱年度统计、个人资料中的公开乐谱数量，并移除了少量早已弃用的字段。