更新日誌

我們的 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，學生就可以按作業要求錄製自己的演奏：自己的曲目、即興演奏、熱身練習，或只存在於紙本上的作品。

• 對教師。 建立流程會隱藏那些只有在有樂譜時才有意義的選項（播放、節拍器、backing track、速度）。學生提交的內容會進入專為錄音而設的批改畫面，你可以像平常一樣聆聽、留言及評分。
• 對學生。 作業會開啟到錄製畫面，旁邊顯示你的指示。學生可以錄製、重聽，並在準備好後提交。支援影片錄製。

基於樂譜的演奏作業維持原有運作方式。更多內容請參閱網誌。

視奏產生器現在可更精細地控制產生內容，也讓學生可以自行使用。

• 選擇調號和拍號。 選擇一個或多個調及拍號後，每條練習都會限制在這些設定之內，並遵循你為樂器設定的音域。
• 為整個樂隊產生分譜。 為樂隊產生練習時，每個聲部都會獲得自己的分譜，使用相應的譜號和移調（實音音高、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 憑證呼叫已棄用。
• 新增樂譜年度統計、個人檔案中的公開樂譜數量，並移除少數已棄用很久的欄位。