setSoundEffectParameter
Cliente
Muda um parâmetro de um efeito de áudio ligado num som ou na voz de um jogador.
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
local music = playSound("sounds/track.mp3", true)
setSoundEffectEnabled(music, "echo", true)
setSoundEffectParameter(music, "echo", "feedback", 30)
setSoundEffectParameter(music, "echo", "panDelay", true)AtençãoGera um erro se o efeito não está ligado, se o parâmetro não existe ou se o valor está fora da faixa.