setSoundMaxDistance

Define a distância a partir da qual um som 3D deixa de ser ouvido.

Sintaxe

bool setSoundMaxDistance ( element oSom, number distancia )

Parâmetros

Nome	Tipo	Padrão	Descrição
oSom	element	—	Som 3D a ajustar.
distancia	number	—	Distância em unidades do jogo.

Retorno

true em caso de sucesso, false se algum argumento for inválido (inclusive uma distância NaN ou infinita). Num som 2D o valor é guardado, mas não tem efeito.

O valor inicial é 20. Ele também decide quando um som 3D é aberto — veja playSound3D.

Veja também

• playSound3D — Toca um arquivo de áudio do resource ou uma URL de streaming num ponto fixo do mundo.
• playSFX3D — Toca um som dos bancos de áudio do jogo num ponto fixo do mundo.
• setSoundMinDistance — Define o raio dentro do qual um som 3D toca no volume cheio.
• getSoundMinDistance — Devolve o raio de volume cheio de um som 3D.
• getSoundMaxDistance — Devolve a distância de corte de um som 3D.
• setSoundPanningEnabled — Liga ou desliga o posicionamento estéreo automático de um som 3D.
• isSoundPanningEnabled — Verifica se o posicionamento estéreo automático está ligado.