Histórico de alterações

Nossa especificação da REST API passa para OpenAPI 3.1, a API OMR encerra seu período beta, e as tarefas do Flat for Education passam a ir além de listagem e criação.

• A API OMR está estável. Endpoints, campos e comportamento agora seguem nosso processo usual de descontinuação antes de qualquer mudança incompatível. Um novo FAQ cobre créditos e cobrança, limites e tempos de processamento, qualidade de reconhecimento e idiomas, além de uso comercial e privacidade.
• Leia, atualize e exclua tarefas no Flat for Education. Excluir uma tarefa também remove seus envios e as cópias dos alunos; em vez disso, arquive-a para manter o trabalho.
• Extrato de créditos. Uma nova chamada lista seu histórico de créditos; o saldo continua na chamada de recursos do OMR.
• Arquivos Finale (.musx) podem ser importados, em regime de melhor esforço, e a importação de música digitalizada (PDF e imagens) está documentada na criação de partituras.
• OpenAPI 3.1. Campos nullable usam a sintaxe 3.1; ferramentas fixadas em OpenAPI 3.0 precisam de atualização. O campo mimeType foi removido dos uploads de arquivos OMR.

Selecione um trecho, pressione L e ele se repete até você mandar parar, enquanto as notas continuam editáveis, para que cada alteração apareça na próxima volta. O modo de loop é gratuito em todos os planos.

• Três maneiras de iniciar um loop: selecione compassos e pressione L, escolha Loop no menu de seleção ou pressione o botão de loop no cabeçalho para repetir o compasso em que o cursor está. Arraste as alças para ampliar ou reduzir o intervalo, até mesmo durante a reprodução.
• As notas continuam editáveis. Clique em uma nota enquanto ela toca, altere-a e ouça o resultado na próxima volta. Os loops também funcionam com YouTube, Vimeo, SoundCloud sincronizados ou com uma gravação enviada.
• A reprodução começa no cursor, não no início. Ao parar, a posição é mantida: Espaço reproduz a partir do cursor, Shift + Espaço retoma exatamente de onde a música parou (pressione e segure Reproduzir no celular). Voltar ao início move o cursor quando a reprodução está parada e reinicia a reprodução quando está tocando.

Disponível no novo editor na web e na nova barra de ferramentas móvel no Android; o iOS vem em seguida. Partituras incorporadas também podem usar loop pela embed API.

O editor do Flat for Education agora usa a mesma barra de ferramentas do Flat, com uma barra vertical à esquerda que abre painéis de notação, instrumentos, layout e detalhes, além de painéis feitos para a sala de aula.

• Painéis de atividades para alunos: composição, escrita compartilhada, performance, folhas de exercícios e gravação livre passam a ter cada um um painel ao lado da partitura, com as instruções do professor a um clique de distância e com opção de destacar em uma janela flutuante.
• Painéis de revisão para professores, com o mesmo layout ao avaliar o trabalho de cada aluno, e visualizações correspondentes das partituras dos alunos ao criar uma atividade.
• A busca rápida vem ativada por padrão: digite o que você está procurando e o editor encontra a ferramenta, limitado às ferramentas que o seu conjunto de ferramentas permite.

Leia mais sobre a nova barra lateral no blog.

Uma nova versão do nosso modelo interno agora está por trás de toda importação de PDF e foto, com foco em como as tercinas e outras quiálteras são impressas na página.

• Quiálteras implícitas agora são suportadas. Os gravadores musicais costumam imprimir o pequeno "3" ou "6" apenas sobre a primeira tercina ou sextina de uma passagem, e deixam os grupos seguintes sem marcação — espera-se que o músico continue o padrão. Esses grupos não marcados são quiálteras implícitas: são tocados como quiálteras, sem nada impresso para indicar isso. Elas são muito comuns em edições do século XIX, estudos e variações. O escaneamento agora as reconstrói a partir do ritmo do compasso, em vez de eliminar notas para fazer o compasso caber em sua fórmula de compasso.
• Menos quiálteras inventadas do nada. O modelo costumava marcar grupos normais com hastes unidas por barra como tercinas mesmo quando nenhum número era impresso sobre eles, e esses números apareciam na sua partitura. Agora ele só escreve uma quiáltera onde ela realmente está desenhada na página.

• Retenção de dados sob seu controle. Os trabalhos OMR agora informam por quanto tempo seus arquivos são mantidos (30 dias por padrão), cada trabalho MusicXML inclui sua data de expiração, e você pode apagar os arquivos e resultados de um trabalho assim que coletá-los.
• Detecção de recursos antes do login. A chamada de capacidades do OMR funciona sem uma conta e lista os idiomas de reconhecimento compatíveis com seus nomes.
• Exportação de notação ABC para qualquer revisão da partitura, junto com MusicXML, MIDI e os outros formatos. Assim como o MIDI, ela não inclui toda a gravação tipográfica.
• Tarefas Free Record podem ser configuradas pela API no Flat for Education.
• Erros vindos de um provedor upstream (como o Google Classroom, por exemplo) agora incluem a própria mensagem localizada do provedor.

O editor do Flat for Education agora também está disponível como aplicativo para computador para Mac e Windows. A mesma conta, as mesmas partituras, para todas as contas cobertas por uma licença escolar: professores, alunos e administradores.

• Funciona offline. Sem Wi‑Fi na aula? Continue compondo e editando: seu trabalho é salvo no computador, e suas alterações são sincronizadas com a sua conta na próxima vez que você abrir o aplicativo online.
• Sua biblioteca completa, sincronizada. Faça login e todas as partituras, tarefas e turmas estarão lá, na web e no aplicativo para computador. Comece uma partitura no navegador e continue no aplicativo, ou faça o contrário.
• O editor completo, em uma janela própria. Notação, reprodução, importação e exportação de MusicXML e MIDI, exportação em PDF e entrada de notas com um teclado MIDI USB ou Bluetooth.
• Instale em qualquer computador. Máquinas do laboratório, o notebook da equipe, o computador de casa de um aluno: não há limite de instalações por posto.

Baixe em flat.io/edu/desktop ou pelo menu da sua conta no aplicativo web: ele escolhe o download certo para o seu computador.

Uma nova versão do nosso modelo interno agora é usada em todas as importações de PDFs e fotos, com 22% a 51% menos erros em nossos testes de referência com partituras digitalizadas. Os ganhos são maiores nas páginas mais difíceis — impressões antigas e qualidade de impressão irregular.

Uma versão aprimorada do modelo interno do Flat agora é usada em todas as importações de PDF e fotos, em especial:

• Trechos com várias vozes, com pausas compartilhadas e pausas invisíveis, agora são compatíveis.
• Barras de compasso e finais de repetição (voltas) agora são posicionados corretamente dentro dos compassos.
• As ligaduras de colcheias são reconhecidas com mais confiabilidade.
• Fórmulas de compasso escritas em várias pautas, como em partituras orquestrais, agora são reconhecidas.
• Corrigidos alguns símbolos de acordes que eram exportados para MusicXML com um tipo de acorde fora do padrão.

As atividades de performance não precisam mais ter uma partitura anexada. Escolha Free Record na etapa da partitura ao criar uma atividade, e os alunos gravam a si mesmos no que a atividade pedir: seu próprio repertório, uma improvisação, um aquecimento ou uma peça que existe apenas no papel.

• Para professores. O fluxo de criação oculta as opções que só fazem sentido com uma partitura (reprodução, metrônomo, playback, velocidade). As entregas chegam a uma tela de revisão feita para gravações, onde você ouve, comenta e avalia como de costume.
• Para alunos. A atividade abre em uma tela de gravação com suas instruções ao lado. Eles gravam, escutam de volta e entregam quando estiverem prontos. Há suporte para gravações de vídeo.

As atividades de performance baseadas em partitura continuam funcionando exatamente como antes. Leia mais no blog.

O Sight Reading Generator ganha mais controle sobre o que escreve e uma forma de os alunos usarem a ferramenta por conta própria.

• Escolha as armaduras de clave e de compasso. Selecione uma ou várias tonalidades e fórmulas de compasso, e cada exercício fica dentro delas, junto com a tessitura definida para o instrumento.
• Partes para a banda inteira. Gere um exercício para uma banda e cada naipe recebe sua própria parte, na clave e transposição corretas (afinação de dó, si bemol, mi bemol, fá, clave de fá), todos lendo a mesma linha.
• Direto na atividade. Abra o gerador a partir do fluxo de criação da atividade de performance e anexe o resultado sem sair dele.
• Modo de prática para alunos. Os alunos encontram o gerador na própria página de ferramentas e geram exercícios para leitura no próprio ritmo, fora de qualquer atividade. Nada é enviado nem avaliado.
• Abre na visualização em trilhas. Um exercício gerado abre na visualização horizontal em trilhas, pronto para leitura da esquerda para a direita, e nunca coloca duas pausas seguidas.

Leia mais no blog.

A importação de partituras a partir de um PDF ou de uma foto ganhou um novo fluxo no aplicativo web, desenvolvido com o mecanismo de reconhecimento próprio da Flat. Ele substitui a importação anterior de PDF para todos.

• Escolha as páginas que você quer. Envie um PDF ou várias fotos e mantenha apenas as páginas que contêm a música. Cada página mantida usa um crédito.
• Acompanhe o reconhecimento enquanto ele acontece. Uma barra de progresso mostra em que etapa está a digitalização, página por página, e você pode continuar usando o Flat enquanto o processo é executado.
• Revise antes de a partitura ser criada. Quando o mecanismo não tem certeza sobre um instrumento, ele pede que você confirme o título e os instrumentos detectados, com os nomes das partes impressos na página exibidos ao lado de cada um. Quando todos os instrumentos são identificados com certeza, essa etapa é ignorada.

Disponível no Flat e, para professores e administradores, no Flat for Education. O novo fluxo chegará ao app para iOS nas próximas semanas.

O mecanismo de OMR do Flat agora está disponível programaticamente por meio da API para desenvolvedores. Envie PDFs ou fotos, acompanhe o progresso do reconhecimento, revise os instrumentos detectados e depois importe o resultado como uma partitura editável em uma biblioteca do Flat ou exporte em MusicXML ou MIDI. É o mesmo modelo interno que viabiliza a importação de PDFs e fotos no editor, agora disponível em escala para seus próprios apps e fluxos de trabalho.

A API dedicada de OMR (v2.24.0) se baseia na importação de PDFs em segundo plano adicionada à criação de partituras na v2.23.0: solicite suporte a tarefas ao importar um arquivo e faça polling da tarefa até que a partitura esteja pronta. Consulte o changelog da API para ver os detalhes de ambas as versões.

O Flat for Education agora tem quatro funções de conta: Admin, Support Admin, Teacher e Student. A nova função Support Admin é para as pessoas que mantêm a escola funcionando nos bastidores (contatos de TI, equipes financeiras, diretores) e precisam gerenciar a conta sem lecionar.

• Acesso total de gerenciamento: faturamento e assinatura, Pessoas (convidar e remover professores e alunos), configurações da escola, integrações e o Painel de uso.
• Sem ferramentas de ensino: sem turmas, sem atividades, sem trabalhos de alunos para revisar.
• Não ocupa uma licença: adicione quantos Support Admins a sua escola precisar. Se alguém tiver a função de Admin apenas para ver o faturamento, mudar para Support Admin libera uma licença de professor sem custo extra.

Admins e Support Admins atribuem funções na seção Pessoas. Veja funções e permissões para saber o que cada função pode fazer ou leia a postagem no blog.

Melhoramos a forma como a digitalização lê o layout de uma página. As importações de PDFs e fotos agora geram partituras mais limpas e precisas, especialmente em layouts complexos:

• Páginas densas agora são divididas corretamente. Páginas com muitos sistemas curtos empilhados uns sobre os outros não são mais mescladas — cada sistema é detectado separadamente.
• Melhor em partituras orquestrais e de grandes conjuntos. Instrumentos com múltiplos pentagramas, como piano e órgão, e partituras grandes com muitos pentagramas são reconhecidos com mais confiabilidade.
• Layouts amplos, em paisagem e em livreto. Páginas em formato paisagem não cortam mais a borda esquerda (o que podia cortar claves), e digitalizações de várias páginas e em livreto são tratadas corretamente.
• Menos detecções indevidas. Elementos espúrios perto dos rodapés e das margens da página não são mais identificados como música.

O afinador no Flat for Education foi reformulado com foco nos instrumentos que seus alunos tocam.

• Predefinições de instrumentos. Escolha guitarra, baixo, ukulele, bandolim e muito mais, incluindo guitarras de 7 e 8 cordas, ukulele barítono, baixo de 5 cordas e mandola, e o afinador mostra cada corda para afinar. O modo de afinação livre agora se chama Cromático.
• Afinações alternativas. Drop D, afinações abertas e outras alternativas comuns estão disponíveis para todos os instrumentos com trastes, não só para guitarra.
• Notas de referência. Toque a altura de uma corda e afine de ouvido.
• Calibração e leitura precisa. Defina a altura de referência para um valor diferente de A = 440 Hz quando um conjunto precisar disso e veja o desvio em cents ao lado da frequência detectada. O medidor redesenhado mantém o alvo fixo e move o indicador, e um histórico mostra as últimas notas tocadas.
• No editor. O afinador também pode ser aberto na barra de ferramentas do editor e pré-seleciona o instrumento da parte atual.

Encontre-o em Ferramentas, ao lado do metrônomo e do gerador de som, ou leia o guia das ferramentas de prática.

Toda importação de PDF e foto agora é processada pelo modelo próprio da Flat. Esta versão é uma grande atualização focada na precisão da transcrição: a correção musical (as notas, ritmos, ligaduras e acidentes que determinam se uma partitura está correta) melhora em todos os conjuntos de teste, com os maiores ganhos em:

• Dinâmicas: +39%
• Fermatas, articulações, ligaduras, acidentes: +30 a 37%
• Duração das notas: +22%
• Ligaduras de frase, notas pontuadas, pausas, atribuição de pauta e voz: +14 a 20%

O posicionamento de texto, dinâmicas e layout também está mais preciso: letras, cifras e dinâmicas são associadas com mais confiabilidade às notas corretas, inclusive em layouts complexos, como pautas duplas de piano e partes com mudanças de clave.

Estamos disponibilizando o modelo de IA da própria Flat para importação de PDFs e fotos, desenvolvido e treinado internamente para substituir o mecanismo de terceiros usado no lançamento. Ter essa tecnologia de ponta a ponta nos permite avançar ainda mais na precisão, ampliar o que reconhecemos, lançar melhorias muito mais rápido e alinhar os resultados ao próprio formato de notação da Flat, para que as importações se encaixem naturalmente no restante do produto. Esta primeira versão já consegue ler muito mais da sua música:

Cobertura de notação mais ampla. Itens recém-reconhecidos:

• Cifras de acordes, codificadas corretamente com seu significado musical como acordes editáveis, e não apenas como texto simples
• Repetições de compasso e barras rítmicas
• Marcações de andamento e metrônomo (com BPM)

Letras e texto em mais idiomas. Letras, marcas de ensaio e outros textos são reconhecidos por padrão em idiomas com escrita latina, além de japonês, coreano e chinês.

Mais fiel ao layout original. As importações agora seguem muito mais de perto o layout da partitura de origem, correspondendo ao número de compassos por linha, sistemas por página e à estrutura geral. Isso faz uma diferença real em partituras grandes e complexas, como obras orquestrais e instrumentos com múltiplos pentagramas, como piano. Também há suporte a mais formatos de página, incluindo páginas na orientação paisagem que antes não eram compatíveis.

A maior atualização da especificação desde 2024, colocando a API em dia com dois anos de mudanças no produto.

• Importação de mais de 15 formatos. Guitar Pro, MuseScore, notação ABC, PowerTab, Capella, MEI, Overture, TablEdit, Band-in-a-Box, Karaoke MIDI, MuseData, Score Writer, Bagpipe Music Writer e Encore se juntam a MusicXML e MIDI, e as partituras podem ser exportadas como arquivos .flat nativos.
• Coleções virtuais. Todas as partituras, colaborações e curtidas substituem a antiga hierarquia de pastas na biblioteca, acompanhando a biblioteca Flat redesenhada.
• Flat for Education. Atividades de performance com gravações de áudio ou vídeo e opções de backing track, metrônomo e velocidade; entregas em grupo para escrita compartilhada; instruções com rich text; subgrupos de alunos; tarefas do Microsoft Teams agendadas e direcionadas individualmente; descrições ricas e tipos de atividade na biblioteca de recursos.
• Configuração LTI unificada para LTI 1.1 e 1.3, incluindo registro dinâmico. As chamadas anteriores de credenciais do LTI 1.1 foram descontinuadas.
• Estatísticas anuais sobre partituras, contagens de partituras públicas nos perfis e remoção de alguns campos descontinuados há muito tempo.