# stopSound (Cliente)

> Para um som criado por este cliente e destrói o elemento. Dispara `onClientSoundStopped` com o motivo `destroyed`.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Som
- **URL**: https://wiki.mymp.gg/pt/stopSound-client
- **Contraparte**: Também existe no servidor, com outra implementação: [stopSound (Servidor)](https://wiki.mymp.gg/pt/stopSound-server.md)

## Sintaxe

```lua
bool stopSound(sound sound)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sound` | `sound` | O elemento `sound`. |

## Retorno

`true` se o som foi parado, `false` se ele veio do servidor.

## Exemplo

```lua
local music = playSound("sounds/menu.ogg", true)

addCommandHandler("stopmusic", function()
    if isElement(music) then
        stopSound(music)
    end
end)
```

### Atenção

Um som criado pelo servidor só pode ser parado pelo servidor.

## Veja também

- [playSound (Cliente)](https://wiki.mymp.gg/pt/playSound-client.md): Toca um som sem posição no mundo, só neste cliente. Dispara onClientSoundStarted com o motivo play.
- [setSoundPaused (Compartilhado)](https://wiki.mymp.gg/pt/setSoundPaused.md): Pausa ou continua um som. No servidor, a mudança é enviada a todos os clientes.
- [stopSound (Servidor)](https://wiki.mymp.gg/pt/stopSound-server.md): Para um som criado pelo servidor e destrói o elemento em todos os clientes.
- [onClientSoundStopped (Cliente)](https://wiki.mymp.gg/pt/onClientSoundStopped.md): Disparado quando um som para de tocar neste cliente: pausado, parado ou terminado.
