# playSound3D (Cliente)

> 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`.

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

## Sintaxis

```lua
sound|false playSound3D(string sound, float x, y, z [, 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. |
| `x, y, z` | `float` | Posición del sonido en el mundo, en tres números o un `vec3`. |
| `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.

El sonido sale de alcance (`onClientElementStreamOut`) cuando la cámara está a más de 40 m por encima de su distancia máxima o en otra dimensión, y vuelve (`onClientElementStreamIn`) a menos de 20 m de ella.

## Ejemplo

```lua
local pos = getElementPosition(localPlayer)
local radio = playSound3D("sounds/radio.ogg", pos, true)
setSoundMaxDistance(radio, 40)
```

### Si vienes de MTA

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

## Ver también

- [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.
- [setSoundMaxDistance (Compartido)](https://wiki.mymp.gg/es/setSoundMaxDistance.md): Define a partir de qué distancia un sonido 3D queda en silencio. Por defecto son 20 m. En el servidor, el cambio se envía a todos los clientes.
- [setSoundSpeaker (Cliente)](https://wiki.mymp.gg/es/setSoundSpeaker.md): Hace que un ped hable un sonido: su boca se mueve con el volumen del sonido y, si el sonido es 3D, sale de la cabeza del ped en cada fotograma.
- [playSound3D (Servidor)](https://wiki.mymp.gg/es/playSound3D-server.md): Crea un sonido en una posición del mundo que todos los clientes reproducen a la vez. Los cambios que se le hacen en el servidor llegan a todos.