# playSound (Cliente)

> Reproduce un sonido sin posición en el mundo, solo en este cliente. Dispara `onClientSoundStarted` con el motivo `play`.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Sonido
- **URL**: https://wiki.mymp.gg/es/playSound-client
- **Contraparte**: También existe en el servidor, con otra implementación: [playSound (Servidor)](https://wiki.mymp.gg/es/playSound-server.md)

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `sound` | `string` | Un nombre registrado con `engineAddSound`, la ruta de un archivo del recurso (`@otro/archivo.mp3` para otro recurso) o los propios bytes de un archivo de audio. |
| `looped` | `bool` | Repetir el sonido cuando llega al final. *(por defecto: `false`)* |
| `throttled` | `bool` | Se acepta por compatibilidad con MTA y se ignora. *(por defecto: `true`)* |

## Retorno

El elemento `sound` creado, o `false` si no se pudo abrir el sonido.

Cuando un sonido que no se repite llega al final, dispara `onClientSoundStopped` con `finished` y el elemento se destruye.

## Ejemplo

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

### Si vienes de MTA

No se aceptan direcciones de internet (`http`, `ftp`). Otro recurso se indica con `@recurso/`, no con `:recurso/`.

## Ver también

- [playSound3D (Cliente)](https://wiki.mymp.gg/es/playSound3D-client.md): Reproduce un sonido en una posición del mundo, solo en este cliente. El volumen baja con la distancia entre setSoundMinDistance (5 m) y setSoundMaxDistance (20 m). Dispara onClientSoundStarted con play.
- [stopSound (Cliente)](https://wiki.mymp.gg/es/stopSound-client.md): Detiene un sonido creado por este cliente y destruye el elemento. Dispara onClientSoundStopped con el motivo destroyed.
- [playSound (Servidor)](https://wiki.mymp.gg/es/playSound-server.md): Crea un sonido sin posición en el mundo que todos los clientes reproducen a la vez. Los cambios que se le hacen en el servidor llegan a todos.
- [engineAddSound (Cliente)](https://wiki.mymp.gg/es/engineAddSound.md): Registra un archivo de audio con un nombre, que playSound y playSound3D pasan a reproducir por ese nombre.