# onClientSoundStarted (Cliente)

> Disparado quando um som começa a tocar neste cliente ou sai da pausa.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Evento Lua
- **Lado**: Cliente
- **Categoria**: Som
- **URL**: https://wiki.mymp.gg/pt/onClientSoundStarted

## Sintaxe

```lua
addEventHandler("onClientSoundStarted", root, function(string reason) ... end)
```

## Parâmetros do handler

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `reason` | `string` | `play` quando o som começa, `resumed` quando sai da pausa. |

## Source

O elemento `sound`.

`play` vem de `playSound` e `playSound3D` deste cliente e de um som do servidor quando ele começa aqui. `playSFX` e `playSFX3D` não disparam o evento.

## Exemplo

```lua
addEventHandler("onClientSoundStarted", root, function(reason)
    if reason == "play" then
        outputDebugString("som iniciado: " .. tostring(getSoundLength(source)) .. " s")
    end
end)
```

## Veja também

- [onClientSoundStopped (Cliente)](https://wiki.mymp.gg/pt/onClientSoundStopped.md): Disparado quando um som para de tocar neste cliente: pausado, parado ou terminado.
- [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.