setWorldSoundEnabled

Liga ou desliga um som do mundo, ou um grupo inteiro deles.

Sintaxe

bool setWorldSoundEnabled ( number grupo [, number indice ], bool ativado [, bool imediato = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
grupo	number	—	Grupo de sons. Precisa ser um número não negativo.
indice	number	—	Som específico dentro do grupo, de 0 a 255. Quando omitido, a chamada vale para o grupo inteiro.
ativado	bool	—	true libera o som, false silencia.
imediato	bool	false	Com true, corta na hora os sons daquele grupo que já estejam tocando.

O indice é reconhecido pelo tipo do argumento: se logo depois do grupo vier um booleano, ele é o ativado e a chamada vale para o grupo todo.

Retorno

true se a mudança foi aplicada. Argumentos no formato errado devolvem false e registram um aviso.

Exemplo

setWorldSoundEnabled(5, false)          -- silencia o grupo 5 inteiro
setWorldSoundEnabled(5, 12, false)      -- silencia so o som 12 do grupo 5
setWorldSoundEnabled(5, false, true)    -- silencia e corta o que ja toca

Veja também

• setAmbientSoundEnabled — Liga ou desliga um tipo de som ambiente.
• isAmbientSoundEnabled — Diz se um tipo de som ambiente está ligado.
• resetAmbientSounds — Religa todos os tipos de som ambiente.
• isWorldSoundEnabled — Diz se um som do mundo está liberado.
• resetWorldSounds — Libera de volta todos os sons do mundo que tinham sido silenciados.