# playSound (Cliente)

> Toca um som sem posição no mundo, só neste cliente. Dispara `onClientSoundStarted` com o motivo `play`.

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

## Sintaxe

```lua
sound|false playSound(string sound [, bool looped = false, bool throttled = true])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sound` | `string` | Um nome registrado com `engineAddSound`, o caminho de um arquivo do recurso (`@outro/arquivo.mp3` para outro recurso) ou os próprios bytes de um arquivo de áudio. |
| `looped` | `bool` | Repetir o som quando ele chega ao fim. *(padrão: `false`)* |
| `throttled` | `bool` | Aceito por compatibilidade com o MTA e ignorado. *(padrão: `true`)* |

## Retorno

O elemento `sound` criado, ou `false` se o som não pôde ser aberto.

Quando o som chega ao fim sem repetir, ele dispara `onClientSoundStopped` com `finished` e o elemento é destruído.

## Exemplo

```lua
local music = playSound("sounds/intro.ogg", true)
setSoundVolume(music, 0.5)
```

### Vindo do MTA

Endereços de internet (`http`, `ftp`) não são aceitos. Outro recurso é indicado com `@recurso/`, e não com `:recurso/`.

## Veja também

- [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.
- [stopSound (Cliente)](https://wiki.mymp.gg/pt/stopSound-client.md): Para um som criado por este cliente e destrói o elemento. Dispara onClientSoundStopped com o motivo destroyed.
- [playSound (Servidor)](https://wiki.mymp.gg/pt/playSound-server.md): Cria um som sem posição no mundo que todos os clientes tocam juntos. As mudanças feitas nele no servidor chegam a todos.
- [engineAddSound (Cliente)](https://wiki.mymp.gg/pt/engineAddSound.md): Registra um arquivo de áudio com um nome, que playSound e playSound3D passam a tocar por esse nome.