# getSoundMaxDistance (Compartilhado)

> Devolve a partir de que distância um som 3D fica mudo.

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

## Sintaxe

```lua
float|false getSoundMaxDistance(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 distância em metros, ou `false` se o som não foi encontrado.

## Exemplo

```lua
outputDebugString("Ouvido até " .. getSoundMaxDistance(siren) .. " m")
```

## Veja também

- [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.
- [getSoundMinDistance (Compartilhado)](https://wiki.mymp.gg/pt/getSoundMinDistance.md): Devolve até que distância um som 3D toca no volume cheio.