# getSoundPosition (Compartilhado)

> Devolve em que ponto da faixa o som está tocando.

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

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sound` | `sound` | O elemento `sound`. No cliente também aceita um elemento `dui`, para o som do navegador. |

## Retorno

A posição em segundos, ou `false` se o som não foi encontrado.

No servidor, a posição é calculada pelo tempo que passou e volta ao início quando o som repete.

## Exemplo

```lua
local music = playSound("sounds/track.mp3")

addEventHandler("onClientRender", root, function()
    local now = getSoundPosition(music) or 0
    local total = getSoundLength(music) or 1
    dxDrawRectangle(20, 20, 200 * now / total, 6, tocolor(255, 255, 255))
end)
```

### Atenção

Esta é a posição de reprodução, não a posição no mundo. Para essa, use `getElementPosition`.

## Veja também

- [setSoundPosition (Compartilhado)](https://wiki.mymp.gg/pt/setSoundPosition.md): Pula para um ponto da faixa. O valor fica entre 0 e a duração do som. No servidor, a mudança é enviada a todos os clientes.
- [getSoundLength (Compartilhado)](https://wiki.mymp.gg/pt/getSoundLength.md): Devolve a duração do som.
- [isSoundPaused (Compartilhado)](https://wiki.mymp.gg/pt/isSoundPaused.md): Diz se um som está pausado.