Geliştirici değişiklik günlüğü

Flat artık https://mcp.flat.io/mcp adresinde uzak bir Model Context Protocol sunucusu sunuyor. Böylece herhangi bir MCP istemcisi, kullanıcının Flat hesabındaki partisyonlarla çalışabiliyor.

• İlk aşamada dört araç: search, score_get, score_export (MusicXML, sıkıştırılmış MusicXML, MIDI) ve score_create (MusicXML, MIDI, ABC, MuseScore, Guitar Pro). Mevcut partisyonlar hiçbir zaman düzenlenmez, silinmez veya herkese açık hâle getirilmez.
• PKCE ile OAuth 2.1, tek bir mcp yetki kapsamı ve Client ID Metadata Documents veya Dynamic Client Registration üzerinden istemci kaydı. API anahtarı gerekmez: kullanıcı her istemciyi Flat'in izin ekranında onaylar.
• Claude Code, Codex, Gemini CLI, Cursor ve VS Code ile çalışır; tek bir komut veya yapılandırma girdisi yeterlidir.

Bağlanan hesapta etkin bir Flat Power aboneliği gereklidir. Bu ilk sürüm, partisyon okuma ve oluşturmayı kapsar; developers@flat.io adresine göndereceğiniz geri bildirimlere göre yeni araçlar ekleyeceğiz.

Ayrıntılı kılavuz: Flat MCP sunucusu.

Geliştirici paneli, entegrasyonunuzun neler yapabildiğini temel alacak şekilde yeniden oluşturuldu. Her yetenek (Embed, OMR, REST API, Import API, LTI) artık kapsamı, fiyatlandırması ve belgeleriyle birlikte bir kartta gösteriliyor; uygulamanızın zaten kullandıkları ise en üstte yer alıyor.

• Hesap düzeyinde yeni bir OMR bölümü, çünkü OMR kredileri tüm uygulamalarınız arasında paylaşıldığından işleriniz, kredileriniz ve bunların geçmişi tek bir yerde toplanıyor.
• Kod yazmadan önce OMR’yi deneyin. Playground bir PDF veya fotoğrafları alır, sayfa sayısını, sayfa başı maliyeti ve geriye kalacak bakiyeyi gösterir; ardından siz onaylayınca işi çalıştırır. Çıktı MusicXML indirmeleri olarak sunulur, kitaplığınıza hiçbir şey eklenmez.
• Daha anlaşılır uygulama sayfaları. Kişisel token’lar, OAuth2 kimlik bilgileri ve OMR erişimi uygulama bazında gruplanır; OMR kapsamını taşıyan kimlik bilgileri ayrıca belirtilir.

Bunu flat.io/developers üzerinden açın.

REST API spesifikasyonumuz OpenAPI 3.1'e geçiyor, OMR API beta dönemini kapatıyor ve Flat for Education ödevleri listeleme ve oluşturmanın ötesine açılıyor.

• OMR API artık kararlı. Uç noktalar, alanlar ve davranışlar artık herhangi bir breaking change öncesinde olağan kullanımdan kaldırma sürecimizi izliyor. Yeni bir SSS; krediler ve faturalandırma, limitler ve işleme süreleri, tanıma kalitesi ve diller ile ticari kullanım ve gizliliği kapsıyor.
• Flat for Education içinde ödevleri okuyun, güncelleyin ve silin. Bir ödevi silmek, teslimlerini ve öğrencilerin kopyalarını da kaldırır; çalışmaları korumak için bunun yerine arşivleyin.
• Kredi dökümü. Yeni bir çağrı kredi geçmişinizi listeler; bakiye OMR yetenekleri çağrısında kalır.
• Finale dosyaları (.musx) içe aktarılabilir, best-effort temelinde, ayrıca taranmış müzik içe aktarma (PDF ve görseller) nota oluşturma belgelerinde açıklanmıştır.
• OpenAPI 3.1. Nullable alanlar 3.1 sözdizimini kullanır; OpenAPI 3.0'a sabitlenmiş araçların güncellenmesi gerekir. mimeType alanı OMR dosya yüklemelerinden kaldırıldı.

• Veri saklama süresi sizin kontrolünüzde. OMR işleri artık dosyalarının ne kadar süre saklandığını bildiriyor (varsayılan olarak 30 gün), her MusicXML işi son kullanma tarihini içeriyor ve bir işin dosyalarını ve sonuçlarını topladıktan hemen sonra silebiliyorsunuz.
• Oturum açmadan önce özellik algılama. OMR yetenekleri çağrısı artık hesap olmadan çalışıyor ve desteklenen tanıma dillerini adlarıyla birlikte listeliyor.
• ABC notasyonu dışa aktarma artık MusicXML, MIDI ve diğer biçimlerin yanında herhangi bir partisyon revizyonu için kullanılabilir. MIDI gibi, tam notasyon yerleşimini içermez.
• Free Record ödevleri Flat for Education içinde API üzerinden yapılandırılabilir.
• Bir üst sağlayıcıdan gelen hatalar (örneğin Google Classroom) artık sağlayıcının kendi yerelleştirilmiş mesajını da içeriyor.

Flat’in OMR altyapısı artık geliştirici API’si üzerinden programatik olarak kullanılabiliyor. PDF’ler veya fotoğraflar gönderin, tanıma ilerlemesini takip edin, algılanan çalgıları inceleyin, ardından sonucu Flat kitaplığında düzenlenebilir bir partisyon olarak içe aktarın ya da MusicXML veya MIDI olarak dışa aktarın. Bu, editörde PDF ve fotoğraf içe aktarmayı sağlayan aynı şirket içi modeldir; artık kendi uygulamalarınız ve iş akışlarınız için ölçekli şekilde kullanılabilir.

Özel OMR API’si (v2.24.0), v2.23.0’da partisyon oluşturma sürecine eklenen arka plan PDF içe aktarma özelliğini temel alır: bir dosya içe aktarırken görev desteği isteyin ve partisyon hazır olana kadar görevi sorgulayın. Her iki sürümün ayrıntıları için API değişiklik günlüğüne bakın.

2024'ten bu yana en büyük spesifikasyon güncellemesi; API'yi iki yıllık ürün değişiklikleriyle uyumlu hale getiriyor.

• 15+ biçimden içe aktarma. Guitar Pro, MuseScore, ABC notation, PowerTab, Capella, MEI, Overture, TablEdit, Band-in-a-Box, Karaoke MIDI, MuseData, Score Writer, Bagpipe Music Writer ve Encore, MusicXML ve MIDI'ye katılıyor; partisyonlar yerel .flat dosyaları olarak dışa aktarılabiliyor.
• Sanal koleksiyonlar. All scores, collaborations ve likes, kütüphanedeki eski klasör hiyerarşisinin yerini alıyor ve yeniden tasarlanan Flat kütüphanesiyle eşleşiyor.
• Flat for Education. Ses veya video kayıtlı performans ödevleri ve backing track, metronome ve speed seçenekleri; ortak yazım için grup teslimleri; zengin metinli yönergeler; öğrenci alt grupları; zamanlanmış ve kişiye özel hedeflenen Microsoft Teams ödevleri; kaynak kitaplığında zengin açıklamalar ve ödev türleri.
• Birleşik LTI yapılandırması: LTI 1.1 ve 1.3 için, dinamik kayıt dahil. Önceki LTI 1.1 kimlik bilgisi çağrıları kullanımdan kaldırıldı.
• Partisyonlar için yıllık istatistikler, profillerde herkese açık partisyon sayıları ve uzun süredir kullanım dışı olan birkaç alanın kaldırılması.

• Ses dışa aktarma için getMP3 ve getWAV yöntemleri eklendi
• Uzun süren bir dışa aktarma sırasında ilerleme gösterilebilmesi için exportProgress olayı eklendi

• Kullanıcı eser listeleri artık herkese açık profillerdir. Bir kullanıcının eserlerini listelediğinizde artık yalnızca herkese açık eserleri döndürülür; 2020'de duyurulan değişiklik kapsamında yeni sayfalama ve sıralama seçenekleri eklendi.
• Eser ayrıntıları artık düzenleme URL'sini, çalgı adlarını ve varsa planlanan silinme tarihini gösterir; koleksiyonlar eser sayılarını bildirir; herkese açık profiller beğeni ve oynatma sayılarını gösterir.
• Flat for Education. Kaynak kitaplığını ödev türüne, derse ve sınıf düzeyine göre filtreleyin; kaynaklar paylaşım açıklaması ve gizlilik özellikleri içerir; ödevler nota çalmayı ve ses parçalarını kısıtlayabilir; gönderimler LTI 1.1 ve 1.3 not servislerini destekler.

• Kullanıcı profillerindeki beğeniler artık sayfalandırılıyor ve bir kullanıcının hesap ayrıntılarında hangi ürünü kullandığı gösteriliyor.
• Kaynak izinleri artık isteği yapanın sahibi, kullanıcı işbirlikçisi veya grup işbirlikçisi olup olmadığını ve her işbirlikçinin ne zaman eklendiğini belirtiyor. Partisyon ayrıntılarına ana donanım, öne çıkarılma tarihi ve kuruluş bilgisi eklendi.
• Flat for Education. Davetler birden çok kez yeniden kullanılabilir; gönderimler notlandırılmış bir durumun yanı sıra çalma ve LTI ayrıntıları kazanır; bir ödev, yalnızca zaten orada değilse kaynak kitaplığına kopyalanabilir; kuruluşlar, kuruluş genelinde bir gizlilik düzeyine sahip kendi kaynak kitaplıklarını alır.

Yüklenen notanın yapısını kendi kodunuzdan okuyun.

• Partiler ve sesler: getNbParts, getPartsUuids, getMeasureVoicesUuids
• Notalar: getMeasureNbNotes, getNoteData, playbackPositionToNoteIdx
• Yeni URL parametresi noAudio, ses çalmayı devre dışı bırakır
• setMasterVolume için yanlış temel yöntemin çağrılmasına neden olan sorun düzeltildi

• Constructor içinde jQuery desteği kaldırıldı — bunun yerine bir DOM öğesi veya onun id'sini iletin
• Yayımlanan npm modülü TypeScript tipleriyle birlikte gelir
• Ayrı ES ve UMD derlemeleri

• LTI bağlantıları oluşturun ve bunları Flat for Education kaynak kitaplığı ögelerinden doğrudan bir LMS dersine yerleştirin.
• Bir ödevdeki en yüksek not 100 puandan 10,000 puana çıktı.
• Partisyon metaverileri (alt başlık, besteci, söz yazarı, aranjör, açıklama, lisans vb.) artık API üzerinden yalnızca ayarlanmakla kalmayıp temizlenebiliyor da.

• Resource Library API (beta). Tam erişim ve salt okunur erişim için iki yeni OAuth2 kapsamıyla Flat for Education kaynak kitaplıklarına göz atın ve bunları yönetin. Ödevler kaynak kitaplığına kopyalanabilir.
• Test öğrencileri. Bir sınıfta test öğrenci hesapları oluşturarak ödevleri bir öğrencinin göreceği şekilde deneyin.
• Ödevler, onlarla neler yapabileceğinizi (düzenleme, yayımlama, arşivleme…), eklerinin ayrılmış kopyalar olup olmadığını ve karşılaşılan sorunları bildirir. Teslim geçmişi, bir değişiklik Google Classroom, Microsoft Teams veya bir LMS’den geldiğinde bunun kaynağını kaydeder.
• Bir teslimi sıfırlamak artık onu silmek yerine yerinde tutar; sınıf meta verileri (seviye, beceriler, boyut) ve hesaplardaki Microsoft oturum açma ayrıntıları gösterilir.
• Nota revizyonları başlangıç ve bitiş tarihlerini döndürür; nota oluşturucular çeyrek tonları etkinleştirebilir; kopyalar özgün başlığı koruyabilir.

• Ölçüler: getNbMeasures, getMeasuresUuids
• Gezinme: goLeft, goRight, scrollToCursor
• Metronom: getMetronomeMode, setMetronomeMode
• Çalma hızı: getPlaybackSpeed, setPlaybackSpeed

• Oturum açma bağlantıları ve devredilmiş erişim belirteçleri. Flat for Education yöneticileri, kuruluşlarındaki herhangi bir kullanıcı için bir oturum açma bağlantısı veya o kullanıcı adına işlem yapan bir erişim belirteci oluşturabilir: bu, özel portalların ve tek oturum açma entegrasyonlarının temelini oluşturur.
• Hiragana ile Japonca (ja-HIRA) desteklenen yerel ayarlar arasına katıldı; herkese açık yorumlar artık moderasyon durumlarını gösteriyor.
• Ses dışa aktarmalarında, mevcutsa MP3 seti varsayılan parça olarak döndürülür. Yalnızca önbelleğe alınmış dışa aktarmaları isteme seçeneği kaldırıldı; çünkü ses dışa aktarmaları artık her zaman önbellekten sunuluyor.

• Partisyon oluşturucu. Bir MusicXML dosyası içe aktarmadan boş bir partisyon oluşturun: bir enstrüman listesi ve isteğe bağlı olarak ölçü işareti, donanım, tablatür, akor diyagramları ve sayfa düzeni belirtin.
• Flat for Education. Kuruluş kullanıcıları bir rolle oluşturulabilir; çalışma kâğıtları alıştırmalarını karıştırabilir; öğrenci gönderimleri, içerdikleri alıştırmaları listeler.

• Oynatma parçaları. Flat'in otomatik olarak oluşturup senkronize ettiği parçaları listeleyin (MP3 olarak oynatma), en son oynatma dosyasının senkronizasyon noktalarını alın ve bir dışa aktarımın CDN URL'sini yanıt gövdesinde edinin.
• Flat for Education. Öğretmenler bir öğrencinin teslimini sıfırlayabilir; sınıflar, senkronizasyon sırasında eklenemeyen hesapları bildirir; ödevler ve teslimler Microsoft Teams durumlarını ve bağlantılarını gösterir; ödev kopyaları zamanlanabilir; performans teslimleri kaydedilmiş ses parçalarını içerir.
• Profillere bir kapak resmi eklendi ve mevcut kullanıcının id'si artık ayrı olarak alınabiliyor.

• loadFlatScore, sharingKey kabul eder; böylece özel olarak paylaşılmış bir partisyon yüklenebilir
• Ses parçasını dinamik olarak ayarlamak için setTrack, useTrack ve seekTrackTo eklendi

• Not dışa aktarma. Bir ödevin notlarını CSV veya Excel dosyası olarak indirin.
• Ödevler türlerini ve bir kapak görselini taşır; bir ödevi kopyalamak, mevcut bir taslağın üzerine başka bir ödevin içeriğini yazabilir.
• İş ortaklarında davetin hâlâ beklemede olup olmadığı gösterilir.

• API üzerinden not verme. Taslak ve nihai notları ayarlayın, bir gönderimi öğrenciye geri gönderin ve hesaplanan yorum sayaçlarını okuyun; maksimum puan notla birlikte saklanır.
• Gönderim yorumları. Bir gönderim üzerindeki yorumları oluşturun, listeleyin, güncelleyin ve silin.
• Ödev seçenekleri. Araç setleri, oynatma sınırı, maksimum puan, Google Classroom konuları, belirli öğrencileri atama, kilitli şablonlar ve LTI, Canvas ile MusicFirst ödevlerinin ayrıntıları.
• Yöneticiler, yönetilen bir hesabın kullanıcı adını, adını ve e-posta adresini düzenleyebilir; kullanıcı listeleri etkin lisansa göre filtrelenebilir.
• Eski studentComment ve returnFeedback gönderim parametreleri, yeni not verme çağrıları lehine kaldırıldı.

• Ödevleri arşivleyin ve arşivden çıkarın; ayrıca bir ödevin ana türünü okuyun (yeni partisyon, şablon veya paylaşılan yazım).
• Kuruluş kullanıcıları. Ad ve soyad ile hesap oluşturun, kullanıcı listelerini sıralayın ve filtreleyin, bir filtreyle eşleşen kullanıcıları sayın ve grup üyelerini senkronizasyon kaynaklarına göre filtreleyin (Google Classroom, Microsoft Teams, Clever).
• Partisyon ayrıntıları artık çalma için kullanılan ses örneklerini listeliyor; ayrıca örneklere artık bağlı olmayan, normalize edilmiş bir çalgı listesi sunuyor.

Miksi kendi kodunuzdan kontrol edin ve imlecin altındaki öğeleri okuyun.

• Ses seviyesi ve sessize alma: getMasterVolume, setMasterVolume, getPartVolume, setPartVolume, mutePart, unmutePart
• Solo ve yankı: setPartSoloMode, unsetPartSoloMode, getPartSoloMode, getPartReverb, setPartReverb
• İnceleme: getMeasureDetails, getNoteDetails
• Eklenen olaylar: noteDetails, measureDetails, cursorContext

• Belirtim OpenAPI 3.0'a geçiyor. Önceki sürümler OpenAPI 2 (Swagger) ile tanımlanıyordu.
• Partisyonlar artık aranjörü ve çalma istatistiklerini gösteriyor; bir silme işlemi çöp kutusunda beklemek yerine kısa süre içinde gerçekleşecek şekilde zamanlanabiliyor.
• Flat for Education. Ödev ekleri Google Drive dosyaları olabilir, sınıflar Microsoft Teams bilgilerini taşır ve eğitim hesaplarında ad ve soyad gösterilir.

• Meta veri düzenlemeleri düzenleyiciye anında ulaşır. API üzerinden bir partisyonun başlığını, alt başlığını, bestecisini, söz yazarını veya lisans metnini güncellediğinizde, değişiklikler açık düzenleyicilere gerçek zamanlı olarak iletilir ve yeni bir sürüm kaydedilir. Açıklamalar artık iki kat daha uzun olabilir (2,000 characters).
• Flat for Education gönderimleri artık durumlarını gösterir (oluşturuldu, teslim edildi, iade edildi); revizyon meta verileri son değişiklik olayını döndürür.
• Desteklenen diller arasına Türkçe eklendi; herkese açık profiller bir hesabın Flat ekibine ait olup olmadığını belirtir.

• getMIDI eklendi
• getMusicXML artık üst düzeyde bir Uint8Array döndürüyor — yanıt artık bir .data özelliği içermiyor
• İmlecin voiceIdx değeri artık voiceIdxInStaff

Embed sürümü için güncellendi.

• SDK artık varsayılan olarak flat-embed.com üzerinden yükleniyor
• Kullanımdan kaldırılmış edit eylemi ve edit olayı kaldırıldı
• setNoteColor kaldırıldı

• Daha fazla içe aktarma biçimi. Guitar Pro (GP3, GP4, GP5, GPX, GP), PowerTab, TuxGuitar ve MuseScore dosyaları içe aktarılabilir; ayrıca içe aktarma işlemleri bir dosya adını kabul eder.
• Koleksiyonlar bir üst koleksiyon altında listelenebilir ve oluşturulma tarihlerini bildirir; partisyonlar ait oldukları koleksiyonları listeler.
• Bağlamsal yorumlar bir porte'ye indeks yerine tanımlayıcıyla bağlanır ve kaynak izinleri, çağıranın bir işbirlikçi olup olmadığını belirtir.

• Collections API. Koleksiyonları oluşturun, listeleyin, güncelleyin, silin ve geri yükleyin; koleksiyonlardaki partisyonları listeleyin ve partisyon ekleyip kaldırın. Ayrıca salt okunur, yalnızca ekleme ve tam erişim için üç yeni OAuth2 scope eklendi.
• Partisyonlar çöp kutusundan geri yüklenebilir; yönetici hakları olmadan bir partisyon silindiğinde, bunun yerine hesabınızla paylaşımı kaldırılır; bir kopya belirli bir koleksiyonu hedefleyebilir.
• Yorumlar türe göre filtrelenebilir (belge veya satır içi).
• Part export işlemleri artık indeksler yerine parti tanımlayıcılarını kullanıyor ve Eylül 2019'dan itibaren bir kullanıcının partisyon listesi yalnızca herkese açık partisyonları döndürüyor.

• Kuruluş hesabı yönetimi. Yöneticiler yönetilen hesapları güncelleyebilir, silebilir veya bireysel hesaplara dönüştürebilir; kullanıcı ve davet listelerinde imleç tabanlı sayfalama kullanılır.
• Sınıflara yeniden etkinleştirilebilen bir etkin olmayan durumu eklenir ve Canvas LMS alan adları ile Clever bölümlerini bildirir; ödevlere taslak durumu ve alıştırma eki türü eklenir.
• Profiller artık bir temayı ve çalınan enstrümanları gösterir.

• Gömülü içeriğe klavye odağı vermek için focusScore yöntemi eklendi
• Düzenleyici yapılandırmasına yeni defaultMode özelliği eklendi

• İlk eğitim API’leri artık herkese açık. Sınıfları, ödevleri ve gönderimleri, kuruluş hesaplarını ve davetleri, LTI kimlik bilgilerini ve bir kuruluşun grupları ile kullanıcılarını yönetin: bir okul entegrasyonunun ihtiyaç duyduğu her şey.
• Kapsamlı erişim denetimi. Yeni OAuth2 kapsamları sınıfları, ödevleri ve kuruluş yönetimini kapsar; her biri için salt okunur bir seçenek de vardır. Böylece bir entegrasyon yalnızca ihtiyaç duyduğu erişimi ister.

Kodunuz artık gömmenin nasıl yapılandırıldığını inceleyebilir ve onu bir düzenleyiciye dönüştürebilir.

• Eklenen yöntemler: getEmbedConfig, setEditorConfig, edit
• Eklenen olay: edit

SDK artık partisyonları MusicXML'den yükleyebiliyor ve okuyucunun ne yaptığını bildirebiliyor.

• Eklenen yöntemler: getAutoZoom, setAutoZoom, loadMusicXML, getMusicXML
• Eklenen olaylar: scoreLoaded, cursorPosition, rangeSelection, pause, stop, fullscreen, print
• Entegrasyon testleri eklendi

Flat'in REST API'sinin ilk herkese açık sürümü. Kendi uygulamalarınız ve betiklerinizden hesabınızı, partisyonlarınızı, kullanıcıları ve grupları okuyup yönetin; diğer Flat kullanıcıları adına işlem yapmak için OAuth2'yi kullanın.

O tarihten bu yana yapılan her değişiklik API değişiklik günlüğünde kayıtlıdır; geliştirici belgeleri ise kimlik doğrulama, referans ve kılavuzları kapsar.