# getSoundBPM (Cliente)

> Detecta o andamento do som em batidas por minuto, arredondado para baixo.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Som
- **URL**: https://wiki.mymp.gg/pt/getSoundBPM

## Sintaxe

```lua
float|false getSoundBPM(sound sound)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sound` | `sound` | O elemento `sound`, ou um elemento `dui` para o som do navegador. |

## Retorno

As batidas por minuto, ou `false` se nenhum andamento foi detectado.

## Exemplo

```lua
local music = playSound("sounds/track.mp3", true)
local bpm = getSoundBPM(music)
if bpm then
    outputDebugString("BPM: " .. bpm)
end
```

### Atenção

A primeira chamada analisa o som inteiro na hora, o que pode travar um instante. O resultado fica guardado para as próximas.

## Veja também

- [getSoundFFTData (Cliente)](https://wiki.mymp.gg/pt/getSoundFFTData.md): Devolve o espectro de frequências do que o som está tocando agora, para fazer visualizadores.
- [getSoundLength (Compartilhado)](https://wiki.mymp.gg/pt/getSoundLength.md): Devolve a duração do som.