變更記錄

我們的 REST API 規格升級到 OpenAPI 3.1，OMR API 結束 beta 階段，Flat for Education 的作業功能也不再只限於列出與建立。

• OMR API 已穩定。 端點、欄位與行為在任何破壞性變更前，現在都會遵循我們一貫的淘汰程序。新的 FAQ 說明了點數與計費、限制與處理時間、辨識品質與語言，以及商業用途與隱私。
• 在 Flat for Education 中可讀取、更新與刪除作業。刪除作業也會一併移除其提交內容與學生的副本；若要保留作業內容，請改為封存。
• 點數分類帳。 新增呼叫可列出你的點數歷史；餘額仍保留在 OMR capabilities 呼叫中。
• 支援匯入 Finale 檔案（.musx），以 best-effort 為原則，且建立樂譜時也已記錄掃描樂譜匯入（PDF 與圖片）的相關說明。
• OpenAPI 3.1。 可為 null 的欄位現在使用 3.1 語法；工具若固定使用 OpenAPI 3.0，則需要更新。OMR 檔案上傳中的 mimeType 欄位已移除。

選取一段樂句後，按下 L，它就會重複播放，直到你叫它停止；同時音符仍可編輯，因此每次修改都會在下一輪播放時立即呈現。循環模式在所有方案中皆可免費使用。

• 三種開始循環的方式：選取小節後按 L、從選取選單中選擇「Loop」，或按下頁首中的循環按鈕，循環播放游標所在的小節。你也可以拖曳控制把手來擴大或縮小範圍，甚至在播放時也可以調整。
• 音符仍可編輯。 在播放時點擊音符並加以修改，下一輪就能聽到結果。循環也可搭配已同步的 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 assignments 現在可透過 API 進行設定。
• 來自上游提供者（例如 Google Classroom）的錯誤，現在會附帶該提供者自己的本地化訊息。

Flat for Education 編輯器現在推出 Mac 與 Windows 桌面應用程式。相同的帳號、相同的樂譜，適用於所有包含在學校授權中的帳號：教師、學生和管理員。

• 可離線使用。 課堂上沒有 Wi-Fi？你仍可繼續作曲與編輯：你的作品會儲存在電腦上，等到下次連線開啟應用程式時，變更就會同步回你的帳號。
• 完整資料庫，保持同步。 登入後，你的所有樂譜、作業和班級都會出現在網頁版與桌面版中。你可以先在瀏覽器開始編寫樂譜，再到應用程式接續，或反過來也可以。
• 完整編輯器，獨立視窗執行。 包含記譜、播放、MusicXML 與 MIDI 匯入和匯出、PDF 匯出，以及透過 USB 或 Bluetooth MIDI 鍵盤輸入音符。
• 可安裝在每一台電腦上。 電腦教室的電腦、教職員筆電、學生家中的電腦：安裝數量不受席次限制。

可前往 flat.io/edu/desktop 下載，或從網頁應用程式中的帳號選單取得：系統會為你的電腦提供正確的下載版本。

我們自研模型的新版本現已用於所有 PDF 與照片匯入，在掃描樂譜基準測試中，錯誤率降低了 22% 到 51%。提升在較困難的頁面上最為明顯，例如較舊的雕版印刷與印刷不均的樂譜。

改良版的 Flat 自研模型現已用於所有 PDF 和照片匯入，尤其包括：

• 現已支援帶有共用休止符與隱形休止符的多聲部段落。
• 小節線與反覆結尾（voltas）現在會正確放置在小節內。
• 連桿的辨識現在更可靠。
• 現已可辨識跨越多個譜表繪製的拍號，例如管弦樂總譜中的拍號。
• 修正了部分和弦符號匯出為 MusicXML 時使用非標準和弦類型的問題。

演奏作業現在不再需要附上樂譜。建立作業時，在樂譜步驟選擇 Free Record，學生就能依照作業要求錄下自己的演奏：自己的曲目、即興演奏、暖身練習，或是只存在紙本上的作品。

• 給教師。 建立流程會隱藏只有搭配樂譜才有意義的選項（播放、節拍器、伴奏音軌、速度）。學生提交後，內容會進入專為錄音設計的批改畫面，你可以像平常一樣聆聽、留言並評分。
• 給學生。 作業會直接開啟錄製畫面，旁邊顯示你的說明。他們可以錄製、回放確認，準備好後再提交。也支援錄影提交。

以樂譜為基礎的演奏作業維持原有運作方式。請到部落格閱讀更多內容。

視奏產生器現在可更精細地控制產生內容，也提供學生自行使用的方式。

• 選擇調號與拍號。 可選擇一個或多個調性與拍子，產生的每個練習都會限制在這些設定內，並遵循你為樂器設定的音域。
• 整個樂團的分部譜。 為樂團產生練習時，每個聲部都會取得自己的分部譜，使用對應的譜號與移調（實音、B flat、E flat、F、低音譜號），但都演奏同一條旋律線。
• 直接加入作業。 可從演奏作業的建立流程中直接開啟產生器，並在不離開流程的情況下附加結果。
• 學生練習模式。 學生可在自己的工具頁面中找到產生器，並依自己的步調在任何作業之外產生視奏練習。不會提交任何內容，也不會評分。
• 以音軌檢視開啟。 產生的練習會以水平音軌檢視開啟，方便由左至右閱讀，且不會連續出現兩個休止符。

到部落格閱讀更多。

在網頁版 App 中，從 PDF 或照片匯入樂譜現在採用全新流程，並使用 Flat 自家的辨識引擎。這個新流程已全面取代先前的 PDF 匯入功能。

• 選擇你要的頁面。 上傳 PDF 或多張照片後，只保留包含樂譜的頁面。你保留的每一頁都會使用 1 個點數。
• 在辨識進行時追蹤進度。 進度列會逐頁顯示掃描進度，而在處理期間你也可以繼續使用 Flat。
• 在建立樂譜前先檢查。 當辨識引擎無法確定某個樂器時，它會請你確認標題與偵測到的樂器，並在每個項目旁顯示頁面上印出的聲部名稱。若所有樂器都能確定，這個步驟會自動略過。

Flat 已提供這項功能；對教師與管理員而言，Flat for Education 也同樣提供。iOS App 將在接下來幾週內加入這個新流程。

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 聯絡人、財務團隊、主管），讓他們無須授課也能管理帳戶。

• 完整管理權限：帳單與訂閱、People（邀請和移除教師與學生）、學校設定、整合，以及 Usage Dashboard。
• 無教學工具：沒有班級、沒有作業，也沒有需要審閱的學生作業。
• 不占用授權席位：可依學校需求新增任意數量的 Support Admin。如果某人目前僅為了查看帳單而擔任 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 自家的 AI 模型，用於 PDF 和照片匯入。這個模型由我們內部設計與訓練，將取代產品推出時使用的第三方引擎。從頭到尾掌握這項技術，讓我們能進一步提升辨識準確度、擴大可辨識的內容、更快推出改進，並讓結果更貼合 Flat 自有的記譜格式，使匯入內容能更自然地融入產品的其他功能。這個第一版已經能讀取你更多的樂譜內容：

更廣的記譜涵蓋範圍。 新增可辨識項目：

• 和弦記號，會依其音樂意義正確編碼為可編輯的和弦，而不只是一般文字
• 小節反覆記號與節奏斜線
• 速度與節拍器標記（含 BPM）

更多語言的歌詞與文字。 預設可辨識以拉丁字母書寫的語言中的歌詞、排練記號及其他文字，另外也支援日文、韓文與中文。

更忠於原始版面。 現在匯入結果會更貼近來源樂譜的版面配置，包括每行的小節數、每頁的樂系數，以及整體結構。這對大型、複雜的樂譜，例如管弦樂作品，以及像鋼琴這類多譜表樂器的樂譜，會帶來明顯差異。現在也支援更多頁面格式，包括先前不支援的橫向頁面。

自 2024 年以來最大的一次規格更新，讓 API 跟上過去兩年的產品變更。

• 支援從 15+ 種格式匯入。 Guitar Pro、MuseScore、ABC 記譜、PowerTab、Capella、MEI、Overture、TablEdit、Band-in-a-Box、Karaoke MIDI、MuseData、Score Writer、Bagpipe Music Writer 和 Encore 現已加入 MusicXML 與 MIDI 的行列，樂譜也可匯出為原生 .flat 檔案。
• 虛擬收藏。 所有樂譜、協作內容與按讚項目將取代資料庫中舊有的資料夾階層，與重新設計的 Flat 資料庫保持一致。
• Flat for Education。 支援含音訊或視訊錄製的演奏作業，以及伴奏音軌、節拍器與速度選項；支援共同創作的小組繳交；支援富文字說明；學生子群組；可排程並指定給個別對象的 Microsoft Teams 作業；以及資源庫中的豐富描述與作業類型。
• 統一的 LTI 設定，適用於 LTI 1.1 與 1.3，包含動態註冊。先前的 LTI 1.1 憑證呼叫已棄用。
• 新增樂譜年度統計、個人檔案上的公開樂譜數量，並移除少數已長期棄用的欄位。