getSoundBPM

Devolve as batidas por minuto de um som.

Sintaxe

number getSoundBPM ( element oSom )

Retorno

O BPM, ou false se não for possível estimar. Para um arquivo é sempre um número inteiro; para um stream é o valor medido enquanto ele toca, e false até que haja um. Sons tocados a partir de dados de áudio brutos ou de playSFX devolvem false.

Cuidado

Num arquivo, a primeira chamada analisa a faixa inteira e pode travar o jogo por um instante em arquivos longos. O resultado fica guardado, então as chamadas seguintes são imediatas.

Veja também

• getSoundFFTData — Devolve o espectro de frequências do som naquele instante.
• getSoundWaveData — Devolve uma janela da forma de onda do som naquele instante.
• getSoundLevelData — Devolve o nível atual de cada canal.
• getSoundMetaTags — Lê as tags de um arquivo ou de um stream.