playSound3D
Cliente
Toca um som numa posição do mundo, só neste cliente. O volume cai com a distância entre setSoundMinDistance (5 m) e setSoundMaxDistance (20 m). Dispara onClientSoundStarted com play.
Também existe no servidor, com outra implementação: playSound3D
sound|false playSound3D(string sound, float x, y, z [, bool looped = false, bool throttled = true])
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
| sound | string | Um nome registrado com engineAddSound, o caminho de um arquivo do recurso (@outro/arquivo.mp3 para outro recurso) ou os próprios bytes de um arquivo de áudio. |
| x, y, z | float | Posição do som no mundo, em três números ou um vec3. |
| looped | bool | Repetir o som quando ele chega ao fim.padrão false |
| throttled | bool | Aceito por compatibilidade com o MTA e ignorado.padrão true |
Retorno
O elemento sound criado, ou false se o som não pôde ser aberto.
O som sai de alcance (onClientElementStreamOut) quando a câmera fica a mais de 40 m além da distância máxima ou quando está em outra dimensão, e volta (onClientElementStreamIn) a menos de 20 m dela.
Exemplo
local pos = getElementPosition(localPlayer)
local radio = playSound3D("sounds/radio.ogg", pos, true)
setSoundMaxDistance(radio, 40)Vindo do MTAEndereços de internet (
http, ftp) não são aceitos. Outro recurso é indicado com @recurso/, e não com :recurso/.