# setSoundMaxDistance (Compartilhado)

> 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.

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

## Sintaxe

```lua
bool setSoundMaxDistance(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.

No cliente, um som 3D sai de alcance quando a câmera fica a mais de 40 m além dessa distância.

## Exemplo

```lua
local siren = playSound3D("sounds/siren.ogg", 1544.0, -1675.5, 13.6, true)
setSoundMaxDistance(siren, 120)
```

## Veja também

- [getSoundMaxDistance (Compartilhado)](https://wiki.mymp.gg/pt/getSoundMaxDistance.md): Devolve a partir de que distância um som 3D fica mudo.
- [setSoundMinDistance (Compartilhado)](https://wiki.mymp.gg/pt/setSoundMinDistance.md): 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.
- [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.