# engineAddSound (Cliente)

> Registra um arquivo de áudio com um nome, que `playSound` e `playSound3D` passam a tocar por esse nome.

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

## Sintaxe

```lua
bool engineAddSound(string name, string path [, int priority = 0])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `name` | `string` | Nome do som, até 255 caracteres. Maiúsculas e minúsculas não importam. |
| `path` | `string` | Caminho do arquivo de áudio no recurso. |
| `priority` | `int` | Prioridade entre quem registra o mesmo nome. A maior vale; entre iguais, a mais recente. *(padrão: `0`)* |

## Retorno

`true` se o som foi registrado. Gera um erro se o nome é longo demais ou o arquivo não pode ser lido.

Os sons registrados por um recurso são removidos quando ele para.

## Exemplo

```lua
engineAddSound("horn_custom", "sounds/horn.ogg")
playSound("horn_custom")
```

## Veja também

- [engineRemoveSound (Cliente)](https://wiki.mymp.gg/pt/engineRemoveSound.md): Remove um som que este recurso registrou com engineAddSound. Se outro registro do mesmo nome existe, ele volta a valer.
- [engineGetSounds (Cliente)](https://wiki.mymp.gg/pt/engineGetSounds.md): Lista os sons com nome que valem agora, os do jogo, dos pacotes e dos recursos.
- [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.