# setSoundEffectParameter (Cliente)

> Muda um parâmetro de um efeito de áudio ligado num som ou na voz de um jogador.

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

## Sintaxe

```lua
bool setSoundEffectParameter(sound|player target, string effect, string param, float|bool value)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `target` | `sound\|player` | Um `sound`, um `dui`, ou um jogador para mexer na voz dele no chat de voz. |
| `effect` | `string` | Nome do efeito: `chorus`, `compressor`, `distortion`, `echo`, `flanger`, `gargle`, `i3dl2reverb`, `parameq`, `reverb` ou `radio`. |
| `param` | `string` | Nome do parâmetro do efeito (veja a lista abaixo). |
| `value` | `float\|bool` | O novo valor, dentro da faixa do parâmetro. `panDelay` recebe um booleano; parâmetros inteiros são truncados. |

## Retorno

`true` se o valor foi aplicado, `false` se o alvo não foi encontrado.

### Parâmetros por efeito

| Efeito        | Parâmetros e faixas aceitas                                                                                                                                           |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `chorus`      | `wetDryMix` 0–100, `depth` 0–100, `feedback` -99–99, `frequency` 0–10, `waveform` 0–1, `delay` 0–20, `phase` 0–4                                                      |
| `compressor`  | `gain` -60–60, `attack` 0.01–500, `release` 50–3000, `threshold` -60–0, `ratio` 1–100, `predelay`                                                                     |
| `distortion`  | `gain` -60–0, `edge` 0–100, `postEQCenterFrequency` 100–8000, `postEQBandwidth` 100–8000, `preLowpassCutoff` 100–8000                                                 |
| `echo`        | `wetDryMix` 0–100, `feedback` 0–100, `leftDelay`, `rightDelay`, `panDelay` (bool)                                                                                     |
| `flanger`     | `wetDryMix` 0–100, `depth` 0–100, `feedback` -99–99, `frequency` 0–10, `waveform` 0–1, `delay` 0–4, `phase` 0–4                                                       |
| `gargle`      | `rateHz` 1–1000, `waveShape` 0–1                                                                                                                                      |
| `i3dl2reverb` | `room`, `roomHF`, `roomRolloffFactor`, `decayTime`, `decayHFRatio`, `reflections`, `reflectionsDelay`, `reverb`, `reverbDelay`, `diffusion`, `density`, `HFReference` |
| `parameq`     | `center` 80–16000, `bandwidth` 1–36, `gain` -15–15                                                                                                                    |
| `reverb`      | `inGain` -96–0, `reverbMix` -96–0, `reverbTime` 0.001–3000, `highFreqRTRatio` 0.001–0.999                                                                             |
| `radio`       | `freq_low`, `freq_hi`, `fudge` 0–20, `rm_mod_freq`, `rm_mix` 0–1, `o_freq_lo`, `o_freq_hi`                                                                            |

## Exemplo

```lua
local music = playSound("sounds/track.mp3", true)
setSoundEffectEnabled(music, "echo", true)
setSoundEffectParameter(music, "echo", "feedback", 30)
setSoundEffectParameter(music, "echo", "panDelay", true)
```

### Atenção

Gera um erro se o efeito não está ligado, se o parâmetro não existe ou se o valor está fora da faixa.

## Veja também

- [getSoundEffectParameters (Cliente)](https://wiki.mymp.gg/pt/getSoundEffectParameters.md): Devolve os parâmetros atuais de um efeito de áudio ligado num som ou na voz de um jogador.
- [setSoundEffectEnabled (Cliente)](https://wiki.mymp.gg/pt/setSoundEffectEnabled.md): Liga ou desliga um efeito de áudio num som ou na voz de um jogador. Ao ligar, o efeito começa com seus parâmetros padrão.