Calculadora de duração da música

Andamento não positivo ou contagem de compassos não positiva é rejeitado com invalid_input para que um script nunca trate um rascunho a BPM zero como uma faixa infinitamente longa. O caminho é matemática pura — sem rede, sem sementes aleatórias, sem dependência do relógio do sistema — então o executor gratuito no navegador e a API pré-paga retornam o mesmo JSON após o arredondamento decimal fixo cada vez que você chama.

Como BPM, fórmula de compasso e compassos viram minutos e segundos

A fórmula de compasso escreve dois números: o numerador, enviado como beats_per_bar, diz quantos desses pulsos preenchem um compasso, e o denominador, enviado como beat_unit, nomeia a figura escrita que recebe o pulso — quatro para a semínima, oito para a colcheia, dois para a mínima, e um, dezesseis ou trinta e dois para os demais valores legais.

Como chamar a API e o que volta

O array steps percorre do andamento bruto até os comprimentos por batida e por compasso para que testes unitários verifiquem valores intermediários. Envie um corpo JSON com quatro números finitos obrigatórios. O campo bpm é o andamento em batidas por minuto; os alias tempo, beats_per_minute e tempo_bpm são aceitos. O campo measures é a contagem de barras; os alias bars, measure_count, num_measures e n_measures apontam para o mesmo valor, e uma contagem fracionária é legal para uma anacruse ou um fade que não cai no tempo forte. O campo beats_per_bar é o numerador da fórmula de compasso (quatro em 4/4, três em 3/4, seis em 6/8). O campo beat_unit é um enum fechado de figuras escritas que podem ocupar a base do metro: um, dois, quatro, oito, dezesseis ou trinta e dois. Os valores absolutos devem permanecer dentro do limite publicado de um trilhão, e bpm e measures devem ser estritamente maiores que zero; campos ausentes, strings não numéricas, números não finitos e andamento ou contagem de barras não positiva retornam invalid_input e nunca são cobrados. Em caso de sucesso, a resposta reitera as entradas arredondadas, atribui time_signature à string canônica numerador-barra-denominador, informa seconds_per_beat, seconds_per_measure, beats_total, total_seconds e total_milliseconds, e parte o mesmo comprimento em hours, minutes e segundos restantes com um relógio duration como 1:04 ou 0:57.6. Formula reitera que total_seconds equivale a measures vezes beats_per_bar vezes sessenta sobre bpm. O preço é uma tarifa plana de US$ 0,002 por requisição bem-sucedida com unidade item.

Dicas práticas, limites e buscas relacionadas

Mantenha BPM e a contagem de compassos dentro da faixa absoluta publicada para que a duração recíproca da batida continue finita em precisão dupla IEEE tanto no Worker quanto no navegador. Ao ensinar, combine um caminho feliz positivo com um andamento deliberadamente zero ou negativo e uma contagem de barras zero para demonstrar a rota rígida de invalid_input. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém baratos os scripts exploratórios quando alunos testam casos-limite de propósito. As verificações de ida e volta são diretas: recalcule measures vezes beats_per_bar vezes sessenta dividido por bpm e confirme que coincide com total_seconds dentro do arredondamento a doze casas; depois confirme que minutes e os segundos restantes remontam o mesmo total e que a string duration coincide com o recorte do relógio.