История изменений

Панель разработчика перестроена вокруг возможностей вашей интеграции. Для каждой возможности (Embed, OMR, REST API, Import API, LTI) теперь есть карточка с областью действия, ценами и документацией, а те, которые ваше приложение уже использует, показываются первыми.

• Новый раздел OMR на уровне аккаунта: ваши задания, ваши кредиты и их история собраны в одном месте, поскольку кредиты OMR общие для всех ваших приложений.
• Попробуйте OMR до того, как писать код. Playground принимает PDF или фотографии, показывает число страниц, стоимость за страницу и остаток баланса после выполнения, а затем запускает задание после вашего подтверждения. Результат доступен для скачивания в MusicXML, в вашу библиотеку ничего не добавляется.
• Более понятные страницы приложений. Персональные токены, учетные данные OAuth2 и доступ к OMR сгруппированы по приложениям, а учетные данные с областью OMR выделены отдельно.

Откройте ее на странице flat.io/developers.

Наша спецификация REST API переходит на OpenAPI 3.1, API OMR завершает бета-период, а задания в Flat for Education теперь поддерживают не только просмотр списка и создание.

• API OMR стал стабильным. Эндпоинты, поля и поведение теперь следуют нашему обычному процессу устаревания перед любым ломающим изменением. В новом FAQ описаны кредиты и биллинг, лимиты и время обработки, качество распознавания и языки, а также коммерческое использование и конфиденциальность.
• Чтение, обновление и удаление заданий в Flat for Education. При удалении задания также удаляются его работы и копии у учеников; если нужно сохранить их, вместо этого архивируйте задание.
• Журнал кредитов. Новый вызов выводит историю ваших кредитов; баланс по-прежнему доступен через вызов возможностей OMR.
• Файлы Finale (.musx) теперь можно импортировать на условиях best-effort, а импорт сканированной музыки (PDF и изображения) документирован при создании партитуры.
• OpenAPI 3.1. Поля с nullable используют синтаксис 3.1; инструментам, привязанным к OpenAPI 3.0, требуется обновление. Поле mimeType было удалено из загрузки файлов OMR.

У Flat теперь есть настольное приложение для macOS и Windows: полноценный редактор в отдельном окне, бесплатный для загрузки, с библиотекой, синхронизированной между настольной версией, веб-версией и мобильными устройствами.

• Работает офлайн. Пишите, редактируйте и воспроизводите партитуры без подключения; ваши изменения синхронизируются, когда вы снова будете онлайн.
• Ваши партитуры на всех устройствах. С Flat Power библиотека, которую вы видите на компьютере, будет той же, что вы открываете в веб-версии, на iPhone, iPad и Android.
• MIDI-ввод через USB и Bluetooth. Подключите клавиатуру и вводите ноты, играя их.
• Открывает ваши файлы. Дважды щёлкните по партитуре в Finder или Explorer, и она откроется в приложении, а не во вкладке браузера.
• Вход через Apple на macOS наряду с уже доступными вам способами входа.
• Само обновляется. Новые версии устанавливаются автоматически.

Загрузка бесплатна; учётная запись Flat нужна только для синхронизации. Скачайте на flat.io/desktop.

Выделите фрагмент, нажмите L — и он будет повторяться, пока вы его не остановите. При этом ноты остаются доступными для редактирования, поэтому любое изменение будет слышно на следующем повторе. Режим цикла доступен бесплатно на всех тарифах.

• Три способа запустить цикл: выделите такты и нажмите L, выберите «Цикл» в меню выделения или нажмите кнопку цикла в верхней панели, чтобы зациклить такт, в котором находится курсор. Перетаскивайте маркеры, чтобы расширять или сужать диапазон, даже во время воспроизведения.
• Ноты остаются редактируемыми. Щёлкните по ноте во время воспроизведения, измените её и услышите результат на следующем повторе. Циклы также работают с синхронизированными YouTube, Vimeo, SoundCloud или загруженными записями.
• Воспроизведение начинается от курсора, а не с начала. После остановки позиция сохраняется: Space запускает воспроизведение от курсора, Shift + Space продолжает точно с места остановки музыки (на мобильных устройствах нажмите и удерживайте Play). Возврат к началу перемещает курсор при остановленном воспроизведении и перезапускает воспроизведение, если музыка уже играет.

Доступно в новом редакторе в веб-версии и на новой мобильной панели инструментов на Android; версия для iOS появится позже. Встраиваемые партитуры тоже поддерживают цикл через embed API.

Новая версия нашей собственной модели теперь используется при каждом импорте PDF и фотографий и уделяет особое внимание тому, как tuplets напечатаны на странице.

• Теперь поддерживаются неявные tuplets. Гравёры обычно печатают маленькую «3» или «6» над первой триолью или секстолью в пассаже, а следующие группы оставляют без обозначения — предполагается, что исполнитель сам продолжит этот ритмический рисунок. Такие неотмеченные группы — это неявные tuplets: они исполняются как tuplets, хотя на нотной странице это никак не указано. Они очень часто встречаются в изданиях XIX века, этюдах и вариациях. Теперь при сканировании они восстанавливаются по ритму такта, вместо того чтобы удалять ноты ради соответствия размеру.
• Меньше tuplets, придуманных на пустом месте. Раньше модель могла отмечать обычные группы под общим ребром как триоли, даже если над ними не было напечатано никакой цифры, и эти цифры появлялись в вашей партитуре. Теперь tuplet записывается только там, где он действительно указан на странице.

• Управляемое вами хранение данных. Задания OMR теперь сообщают, как долго хранятся их файлы (по умолчанию 30 дней), каждое задание MusicXML содержит дату истечения срока хранения, а файлы и результаты задания можно удалить сразу после того, как вы их получите.
• Определение возможностей до входа в систему. Вызов возможностей OMR теперь работает без учётной записи и возвращает список поддерживаемых языков распознавания с их названиями.
• Экспорт нотации ABC для любой редакции партитуры наряду с MusicXML, MIDI и другими форматами. Как и MIDI, он не сохраняет всё оформление нотной записи.
• Задания Free Record в Flat for Education теперь можно настраивать через API.
• Ошибки, приходящие от внешнего провайдера (например, Google Classroom), теперь содержат собственное локализованное сообщение этого провайдера.

Новая версия нашей собственной модели теперь используется для каждого импорта PDF и фотографий и показывает на 22%–51% меньше ошибок в наших тестах распознавания сканированных нот. Наибольший прирост заметен на более сложных страницах — старых гравированных изданиях и при неравномерной печати.

Улучшенная версия собственной модели Flat теперь используется для импорта всех PDF-файлов и фотографий, в частности:

• Теперь поддерживаются многоголосные фрагменты с общими паузами и невидимыми паузами.
• Тактовые черты и окончания повторов (вольты) теперь правильно размещаются внутри тактов.
• Группировка нот рёбрами теперь распознаётся надёжнее.
• Обозначения размера, записанные через несколько нотоносцев, как в оркестровых партитурах, теперь распознаются.
• Исправлены некоторые буквенно-цифровые обозначения аккордов, которые экспортировались в MusicXML с нестандартным типом аккорда.

В веб-приложении появился новый процесс импорта нот из PDF или фотографии, основанный на собственном движке распознавания Flat. Теперь он заменяет прежний импорт PDF для всех пользователей.

• Выберите нужные страницы. Загрузите PDF или несколько фотографий, затем оставьте только те страницы, на которых есть ноты. Каждая сохранённая страница расходует один кредит.
• Следите за распознаванием по мере его выполнения. Индикатор прогресса показывает, на каком этапе находится сканирование, страница за страницей, и вы можете продолжать пользоваться Flat, пока оно выполняется.
• Проверьте перед созданием партитуры. Если движок не уверен в инструменте, он попросит вас подтвердить название и обнаруженные инструменты; рядом с каждым будут показаны названия партий, напечатанные на странице. Если все инструменты распознаны уверенно, этот шаг пропускается.

Доступно в Flat и, для преподавателей и администраторов, в Flat for Education. Новый процесс появится в приложении iOS в ближайшие недели.

Модуль OMR от Flat теперь доступен программно через API для разработчиков. Отправляйте PDF-файлы или фотографии, отслеживайте ход распознавания, проверяйте обнаруженные инструменты, а затем импортируйте результат как редактируемую партитуру в библиотеку Flat или экспортируйте в MusicXML или MIDI. Это та же внутренняя модель, которая лежит в основе импорта PDF и фотографий в редакторе, а теперь она доступна в масштабе для ваших собственных приложений и рабочих процессов.

Специализированный OMR API (v2.24.0) основан на фоновом импорте PDF, добавленном при создании партитуры в v2.23.0: запрашивайте поддержку задач при импорте файла и опрашивайте задачу, пока партитура не будет готова. Подробности по обоим выпускам смотрите в журнале изменений API.

Мы улучшили распознавание макета страницы при сканировании. Импорт PDF-файлов и фотографий теперь даёт более чистые и точные партитуры, особенно при сложной компоновке:

• Плотные страницы теперь разделяются правильно. Страницы с большим количеством коротких систем, расположенных друг над другом, больше не объединяются — каждая система распознаётся отдельно.
• Лучше для оркестровых партитур и больших ансамблей. Инструменты с несколькими нотоносцами, такие как фортепиано и орган, а также большие партитуры с множеством нотоносцев распознаются надёжнее.
• Широкие, альбомные страницы и буклеты. У альбомных страниц больше не обрезается левый край (из-за чего могли пропадать ключи), а многостраничные сканы и сканы буклетов теперь обрабатываются корректно.
• Меньше случайных распознаваний. Посторонние элементы рядом с нижними колонтитулами и полями страницы больше не принимаются за нотный текст.

Теперь каждый импорт PDF и фотографий обрабатывается собственной внутренней моделью Flat. В этом выпуске представлена крупная новая версия, сосредоточенная на точности распознавания: музыкальная корректность (ноты, ритмы, лиги, знаки альтерации — всё, что определяет правильность партитуры) улучшена на всех тестовых наборах, а наибольший прирост достигнут в следующих областях:

• Динамика: +39%
• Ферматы, артикуляция, лиги, знаки альтерации: +30 to 37%
• Длительности нот: +22%
• Лиги фразировки, ноты с точкой, паузы, назначение нотоносца и голоса: +14 to 20%

Текст, динамика и размещение элементов в нотной записи также стали точнее: слова, буквенно-цифровые обозначения аккордов и динамические обозначения теперь надёжнее привязываются к правильным нотам, в том числе в сложной записи, например на фортепианных системах из двух нотоносцев и в партиях со сменой ключа.

Мы начинаем внедрять собственную модель ИИ Flat для импорта PDF и фотографий, разработанную и обученную внутри компании, чтобы заменить сторонний движок, использенный при запуске. Полный контроль над технологией позволяет нам ещё больше повышать точность, расширять набор распознаваемых элементов, выпускать улучшения значительно быстрее и лучше согласовывать результаты с собственным форматом нотации 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 объявлены устаревшими.
• Годовая статистика по партитурам, число публичных партитур в профилях и удаление нескольких давно устаревших полей.