# engineAddSound (Cliente)

> Registra un archivo de audio con un nombre, que `playSound` y `playSound3D` pasan a reproducir por ese nombre.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Sonido
- **URL**: https://wiki.mymp.gg/es/engineAddSound

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `name` | `string` | Nombre del sonido, hasta 255 caracteres. Mayúsculas y minúsculas dan igual. |
| `path` | `string` | Ruta del archivo de audio en el recurso. |
| `priority` | `int` | Prioridad entre quienes registran el mismo nombre. Gana la mayor; entre iguales, la más reciente. *(por defecto: `0`)* |

## Retorno

`true` si el sonido se registró. Da error si el nombre es demasiado largo o el archivo no se puede leer.

Los sonidos que registró un recurso se quitan cuando se detiene.

## Ejemplo

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

## Ver también

- [engineRemoveSound (Cliente)](https://wiki.mymp.gg/es/engineRemoveSound.md): Quita un sonido que este recurso registró con engineAddSound. Si hay otro registro con el mismo nombre, vuelve a valer.
- [engineGetSounds (Cliente)](https://wiki.mymp.gg/es/engineGetSounds.md): Lista los sonidos con nombre que valen ahora: los del juego, los de los paquetes y los de los recursos.
- [playSound (Cliente)](https://wiki.mymp.gg/es/playSound-client.md): Reproduce un sonido sin posición en el mundo, solo en este cliente. Dispara onClientSoundStarted con el motivo play.