# setCinematicAudio (Cliente)

> Define os sons que a cinemática toca durante a reprodução. Substitui os sons anteriores.

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

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `cinematic` | `cinematic` | A cinemática. |
| `cues` | `table` | Lista de sons, em ordem de `time`. |

## Retorno

`true` se aplicou. `false` se a tabela é inválida, com um aviso dizendo o motivo.

Cada som é tocado como um elemento `sound` filho da cinemática e tem:

- `time`: quando começa, em ms da cinemática (obrigatório).
- `sound`: caminho de um arquivo de som num recurso (obrigatório).
- `from`: ms dentro do som de onde começar. `length`: quanto tocar; `0` vai até o fim do som.
- `fadeIn` e `fadeOut`: ms de fade.
- `volume`: de 0 para cima, 1 por padrão.
- `duck`: fração do volume, de 0 a 1, enquanto um ator fala. 1 por padrão.
- `speed`: de 0.1 a 10, 1 por padrão.
- `actor`: o ator que fala o som; a boca dele se move com ele.
- `spatial`: com `actor`, `true` (padrão) toca a partir da cabeça do ator, `false` toca sem posição.
- `track`: um número de 0 a 255 guardado com o som.

## Exemplo

```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" },
})
```

## Veja também

- [getCinematicAudio (Cliente)](https://wiki.mymp.gg/pt/getCinematicAudio.md): Devolve os sons da cinemática.
- [setSoundSpeaker (Cliente)](https://wiki.mymp.gg/pt/setSoundSpeaker.md): Faz um ped falar um som: a boca dele se mexe com o volume do som e, se o som é 3D, ele sai da cabeça do ped a cada quadro.
- [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.