# setSoundMinDistance (Compartilhado)

> Define até que distância um som 3D toca no volume cheio. O padrão é 5 m. No servidor, a mudança é enviada a todos os clientes.

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

## Sintaxe

```lua
bool setSoundMinDistance(sound sound, float distance)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sound` | `sound` | O elemento `sound`. No cliente também aceita um elemento `dui`, para o som do navegador. |
| `distance` | `float` | Distância em metros. |

## Retorno

`true` se o som foi encontrado, `false` caso contrário.

Entre a distância mínima e a máxima, o volume cai aos poucos; além da máxima, o som fica mudo.

## Exemplo

```lua
local radio = playSound3D("sounds/radio.ogg", 2495.1, -1687.4, 13.5, true)
setSoundMinDistance(radio, 10)
setSoundMaxDistance(radio, 50)
```

## Veja também

- [getSoundMinDistance (Compartilhado)](https://wiki.mymp.gg/pt/getSoundMinDistance.md): Devolve até que distância um som 3D toca no volume cheio.
- [setSoundMaxDistance (Compartilhado)](https://wiki.mymp.gg/pt/setSoundMaxDistance.md): Define a partir de que distância um som 3D fica mudo. O padrão é 20 m. No servidor, a mudança é enviada a todos os clientes.
- [playSound3D (Cliente)](https://wiki.mymp.gg/pt/playSound3D-client.md): Toca um som numa posição do mundo, só neste cliente. O volume cai com a distância entre setSoundMinDistance (5 m) e setSoundMaxDistance (20 m). Dispara onClientSoundStarted com play.
