Gere uma faixa de cliques de metrônomo por BPM e compassos

Informe o andamento em batidas por minuto, uma fórmula de compasso como 4/4 ou 6/8 e a duração desejada em compassos inteiros. O resultado lista cada clique desde o tempo zero, identifica seu compasso e sua batida e marca a primeira batida de cada compasso como acentuada. Use a saída estruturada para programar sons, controlar animações, preparar ferramentas de estudo ou testar software musical com dados temporais reproduzíveis.

Descreva a grade musical

Informe um valor BPM positivo, uma fórmula de compasso no formato numerador/denominador e um número inteiro positivo de compassos. BPM mede a unidade de batida indicada pelo denominador: 120 BPM em 4/4 significa semínimas a cada meio segundo, enquanto 120 BPM em 6/8 significa colcheias a cada meio segundo. O numerador determina quantos cliques pertencem a cada compasso. O gerador posiciona o primeiro clique no tempo zero porque sistemas de reprodução normalmente agendam o tempo forte inicial no começo da linha do tempo. Em seguida, avança exatamente sessenta dividido por BPM segundos a cada clique. Essa definição não inclui contagem de entrada oculta, swing, subdivisões nem latência de áudio. Caso uma sessão precise desses recursos, você pode transformar ou deslocar explicitamente a programação retornada. Como a entrada é compacta e musical, o resultado funciona em áudio para navegador, mecanismos nativos, linhas de vídeo, testes e aplicativos de notação, sem depender de uma taxa de amostragem ou arquivo de som específico.

Interprete tempos e acentos

Cada registro de clique contém índice global, número do compasso e número da batida iniciados em um, além do tempo em segundos e de um indicador de acento. A primeira batida de cada compasso define accented como true; todas as demais ficam como false. Assim, um renderizador pode escolher uma amostra mais forte para tempos principais e outra normal para os demais. Os tempos são arredondados para nove casas decimais, mantendo o JSON estável e preservando precisão inferior a microssegundos em andamentos comuns. O resumo também informa intervalo entre cliques, duração total, quantidade de cliques, batidas por compasso e unidade de batida. A duração total descreve todo o trecho solicitado até o fim do último intervalo, e não apenas o tempo do último clique. Por exemplo, um compasso 4/4 a 120 BPM contém cliques em 0, 0.5, 1 e 1.5 segundos, mas dura 2 segundos. Essa distinção evita cortar a batida final ao reservar uma linha do tempo de áudio ou animação.

Programe a especificação com segurança

Trate o resultado como uma especificação temporal, não como áudio renderizado. Um aplicativo Web Audio pode somar seu horário inicial a cada tempo e agendar um buffer acentuado ou comum conforme o indicador. Um script de estação de áudio digital pode converter segundos para suas unidades, e uma suíte de testes pode comparar eventos de transporte sem depender de alto-falantes ou codecs. A função é determinística: entradas iguais sempre produzem o mesmo JSON, sem usar rede, relógio atual ou valores aleatórios. Andamentos inválidos são rejeitados, incluindo zero, negativos, ausentes, infinitos e textos não numéricos. As fórmulas de compasso precisam ter numerador de 1 a 32 e denominador convencional que seja potência de dois entre 1 e 32. O número de compassos deve ser inteiro positivo, e a programação completa é limitada a 10,000 cliques. Como os tempos são relativos a zero, a latência do aplicativo e a compensação do dispositivo continuam sob responsabilidade de quem faz a chamada; acrescente esses deslocamentos quando o ambiente final de reprodução for conhecido.