playSound3D
Cliente
Reproduce un sonido en una posición del mundo, solo en este cliente. El volumen baja con la distancia entre setSoundMinDistance (5 m) y setSoundMaxDistance (20 m). Dispara onClientSoundStarted con play.
También existe en el servidor, con otra implementación: playSound3D
sound|false playSound3D(string sound, float x, y, z [, bool looped = false, bool throttled = true])
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
| sound | string | Un nombre registrado con engineAddSound, la ruta de un archivo del recurso (@otro/archivo.mp3 para otro recurso) o los propios bytes de un archivo de audio. |
| x, y, z | float | Posición del sonido en el mundo, en tres números o un vec3. |
| looped | bool | Repetir el sonido cuando llega al final.por defecto false |
| throttled | bool | Se acepta por compatibilidad con MTA y se ignora.por defecto true |
Retorno
El elemento sound creado, o false si no se pudo abrir el sonido.
El sonido sale de alcance (onClientElementStreamOut) cuando la cámara está a más de 40 m por encima de su distancia máxima o en otra dimensión, y vuelve (onClientElementStreamIn) a menos de 20 m de ella.
Ejemplo
local pos = getElementPosition(localPlayer)
local radio = playSound3D("sounds/radio.ogg", pos, true)
setSoundMaxDistance(radio, 40)Si vienes de MTANo se aceptan direcciones de internet (
http, ftp). Otro recurso se indica con @recurso/, no con :recurso/.