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

Наша спецификация 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.

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

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

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

Редактор в Flat for Education теперь использует ту же панель инструментов, что и Flat: вертикальная боковая панель слева открывает панели нотации, инструментов, макета и свойств, а также панели, созданные для учебного процесса.

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

Подробнее о новой боковой панели в блоге.

Новая версия нашей собственной модели теперь используется при каждом импорте 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), теперь содержат собственное локализованное сообщение этого провайдера.

Редактор Flat for Education теперь доступен как настольное приложение для Mac и Windows. Та же учётная запись, те же партитуры — для всех пользователей, охваченных школьной лицензией: преподавателей, учеников и администраторов.

• Работает офлайн. В классе нет Wi‑Fi? Продолжайте сочинять и редактировать: ваша работа сохраняется на компьютере, а изменения синхронизируются с вашей учётной записью, когда вы в следующий раз откроете приложение онлайн.
• Вся ваша библиотека синхронизируется. Войдите в систему — и все партитуры, задания и классы будут доступны и в веб-версии, и в настольном приложении. Начните партитуру в браузере и продолжите в приложении, или наоборот.
• Полнофункциональный редактор в отдельном окне. Нотный набор, воспроизведение, импорт и экспорт MusicXML и MIDI, экспорт PDF и ввод нот с MIDI-клавиатуры USB или Bluetooth.
• Устанавливайте на любой компьютер. Компьютеры в классе, ноутбук сотрудников, домашний компьютер ученика: ограничений на количество установок по числу рабочих мест нет.

Скачайте на flat.io/edu/desktop или в меню вашей учётной записи в веб-приложении: сервис сам подберёт нужную загрузку для вашего компьютера.

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

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

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

Для заданий на исполнение больше не нужно прикреплять партитуру. При создании выберите Free Record на этапе выбора партитуры, и ученики смогут записать себя в том, что требуется по заданию: собственный репертуар, импровизация, распевка или произведение, существующее только на бумаге.

• Для преподавателей. В процессе создания скрываются параметры, которые имеют смысл только при наличии партитуры (воспроизведение, метроном, фонограмма, скорость). Работы поступают на экран проверки, созданный для записей, где вы, как обычно, слушаете, комментируете и оцениваете.
• Для учеников. Задание открывается на экране записи, рядом с которым показаны ваши инструкции. Они записываются, прослушивают результат и отправляют работу, когда будут готовы. Поддерживается запись видео.

Задания на исполнение на основе партитуры работают точно так же, как и раньше. Подробнее читайте в блоге.

В Генераторе чтения с листа появилось больше возможностей управлять тем, что он создаёт, а также способ для учеников использовать его самостоятельно.

• Выбор тональностей и размеров. Выберите одну или несколько тональностей и размеров, и все упражнения будут создаваться только в них, с учётом диапазона, заданного для инструмента.
• Партии для всего ансамбля. Создайте упражнение для ансамбля, и каждая группа получит свою партию — в своём ключе и транспозиции (концертный строй, B flat, E flat, F, басовый ключ), при этом все будут читать одну и ту же мелодическую линию.
• Сразу в задание. Откройте генератор прямо из процесса создания исполнительского задания и прикрепите результат, не выходя из него.
• Режим практики для учеников. Ученики найдут генератор на странице своих инструментов и смогут создавать упражнения для чтения в собственном темпе, вне любых заданий. Ничего не отправляется и не оценивается.
• Открытие в режиме дорожек. Сгенерированное упражнение открывается в горизонтальном режиме дорожек, готовое для чтения слева направо, и никогда не содержит две паузы подряд.

Подробнее в блоге.

В веб-приложении появился новый процесс импорта нот из 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.

В 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 для импорта 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 объявлены устаревшими.
• Годовая статистика по партитурам, число публичных партитур в профилях и удаление нескольких давно устаревших полей.