# setCinematicAudio (Cliente)

> Define los sonidos que la cinemática reproduce durante la reproducción. Reemplaza los sonidos anteriores.

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

## Sintaxis

```lua
bool setCinematicAudio(cinematic cinematic, table cues)
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `cinematic` | `cinematic` | La cinemática. |
| `cues` | `table` | Lista de sonidos, en orden de `time`. |

## Retorno

`true` si se aplicaron. `false` si la tabla no es válida, con un aviso que dice el motivo.

Cada sonido se reproduce como un elemento `sound` hijo de la cinemática y tiene:

- `time`: cuándo empieza, en ms de la cinemática (obligatorio).
- `sound`: ruta de un archivo de sonido en un recurso (obligatorio).
- `from`: ms dentro del sonido desde donde empezar. `length`: cuánto reproducir; `0` llega al final del sonido.
- `fadeIn` y `fadeOut`: ms de fundido.
- `volume`: desde 0, 1 por defecto.
- `duck`: fracción del volumen, de 0 a 1, mientras un actor habla. 1 por defecto.
- `speed`: de 0.1 a 10, 1 por defecto.
- `actor`: el actor que habla el sonido; su boca se mueve con él.
- `spatial`: con `actor`, `true` (por defecto) lo reproduce desde la cabeza del actor, `false` sin posición.
- `track`: un número de 0 a 255 guardado con el sonido.

## Ejemplo

```lua
local intro = createCinematic("cinematics/intro.cine")
setCinematicAudio(intro, {
    { time = 0, sound = "audio/theme.ogg", volume = 0.6, duck = 0.4, fadeOut = 2000 },
    { time = 3000, sound = "audio/hero_line1.ogg", actor = "hero" },
})
```

## Ver también

- [getCinematicAudio (Cliente)](https://wiki.mymp.gg/es/getCinematicAudio.md): Devuelve los sonidos de la cinemática.
- [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.
- [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.