Novo: melhor detecção de tonalidades maiores e menores

O feedback foi específico o suficiente para corrigir o problema

Um usuário gostou do analisador, mas apontou um problema real: duas músicas receberam a tonalidade errada. Esse tipo de comentário merece uma correção. Se a seção Harmônica erra a tonalidade, o restante dos conselhos musicais parte de uma base instável.

O método anterior era simplista demais. Ele tomava a classe de altura mais forte do chroma como tônica. Isso pode funcionar com material simples, mas ignora uma diferença musical evidente: dó maior e lá menor usam as mesmas classes de altura, sem soar como a mesma tonalidade.

O que mudou no analisador

O analisador harmônico ativo agora compara o resultado de chroma com perfis maiores e menores. Continua usando as evidências do áudio, mas faz uma pergunta melhor: qual tonalidade e modo explicam melhor o padrão completo de classes de altura?

• Os perfis maiores e menores recebem pontuações separadas.
• O apoio da tônica e da quinta ajuda a desempatar candidatos próximos.
• O resultado agora pode retornar tonalidades menores como Am.
• Os principais candidatos incluem tonalidade, modo, pontuação e confiança, em vez de uma lista simples de strings.

Isso não torna a detecção uma musicóloga infalível. Músicas podem modular, usar acordes emprestados, permanecer em um modo ou evitar uma tônica clara. A mudança torna a estimativa padrão menos simplista e mais fácil de investigar.

Como testamos antes de publicar

Adicionamos testes unitários específicos para o detector e a saída da análise harmônica. Também criamos um pequeno script de benchmark para arquivos de tonalidade conhecida, permitindo verificar ajustes futuros com uma pasta ou CSV, em vez de um envio manual por vez.

No primeiro teste básico, geramos progressões maiores e menores claras nas 12 tônicas. O detector interno retornou a tonalidade esperada em 24 de 24 casos controlados. Isso comprova a distinção básica entre maior e menor, mas não que toda música real está resolvida.

Por que não mudar tudo hoje para um motor externo pesado?

Examinamos ferramentas de detecção de código aberto. Essentia tem um bom extrator de tonalidade e está conectado como backend opcional para testes controlados. Ainda não faz parte das dependências web padrão porque licenciamento de produção, empacotamento e custos de execução exigem decisões cuidadosas.

O método padrão continua pequeno e inspecionável. É a escolha adequada para esta versão: corrigir o tipo de erro identificado, manter a saída investigável e comparar motores mais fortes com músicas reais antes de colocá-los em operação.

O que esperar do resultado

A seção Harmônica deve distinguir melhor tonalidades relativas maiores e menores. Se a música está claramente em lá menor, o analisador não precisa mais reduzi-la a dó só porque as classes de altura coincidem.

Quando um resultado ainda parece errado, o melhor relato inclui a música ou o relatório exatos e a tonalidade esperada. Assim podemos comparar a detecção, os principais candidatos, as evidências de chroma e casos musicais particulares, sem adivinhar de memória.

Perguntas frequentes

Isso garante a tonalidade correta de toda música?

Não. Melhora a estimativa padrão, sobretudo na ambiguidade entre maior e menor, mas músicas reais podem mudar de tonalidade ou evitar uma tônica estável.

Vocês verificaram as duas músicas relatadas?

Não. Os arquivos exatos não estavam disponíveis durante a correção. Verificamos o detector com áudio controlado de tonalidade conhecida e adicionamos um benchmark para músicas reais com tonalidades identificadas.

Mix Analyzer usará Essentia para detectar tonalidades?

Talvez. O backend opcional está pronto para testes, mas a versão padrão mantém o detector interno até que licenciamento, empacotamento e benchmarks com músicas reais justifiquem a mudança.