setSoundEffectParameter

Ajusta um parâmetro de um efeito já ligado.

Sintaxe

bool setSoundEffectParameter ( element oSom, string efeito, string parametro, any valor )

Parâmetros

Nome	Tipo	Padrão	Descrição
oSom	element	—	Som a ajustar, ou um jogador para ajustar um efeito da voz dele.
efeito	string	—	Um dos nomes de efeito, em maiúsculas ou minúsculas.
parametro	string	—	Um dos parâmetros do efeito, listados abaixo.
valor	number ou bool	—	Precisa ser do tipo que o parâmetro espera.

Retorno

true em caso de sucesso. Devolve false se o nome do efeito for desconhecido, se o efeito não estiver ligado, se o parâmetro não pertencer a esse efeito ou se o valor for de outro tipo. Um nome de efeito desconhecido, um efeito desligado e um valor recusado pelo motor de áudio também registram um aviso.

Exemplo

setSoundEffectEnabled(musica, "echo", true)
setSoundEffectParameter(musica, "echo", "wetDryMix", 40.0)
setSoundEffectParameter(musica, "echo", "leftDelay", 250.0)
setSoundEffectParameter(musica, "echo", "panDelay", true)

Veja também

• setSoundEffectEnabled — Liga ou desliga um efeito num som.
• getSoundEffects — Lista o estado de todos os efeitos de um som.
• getSoundEffectParameters — Devolve todos os parâmetros de um efeito ligado.