Lua Script API: Sound and Music Functions - DevScyu/FNF-PsychEnginePlus GitHub Wiki
Start Sound/Music
playMusic(sound:String, volume:Float = 1, loop:Bool = false)
sound
- File name (Should be located inmods/music/
orassets/music/
)volume
- Optional value, volume percent goes from0
to1
. Default value:1
volume
- Optional value, if the music should loop indefinitely. Default value:false
playSound(sound:String, volume:Float = 1, ?tag:String)
sound
- File name (Should be located inmods/sounds/
orassets/sounds/
)volume
- Optional value, volume percent goes from0
to1
. Default value:1
- OPTIONAL:
tag
- Should only be used if you want to pause, resume, change the time, volume or fade in/out your sound, if you don't want to use it, don't include a third value.
Control Sound/Music
stopSound
This function will stop the sound AND remove it permanently!
tag
- Sound tag
pauseSound
tag
- Sound tag
resumeSound
tag
- Sound tag
Example: Using playSound('confirmMenu', 0.5)
will play the menu "Accept" sound with 50% volume
Fade in/out
soundFadeIn(tag:String, duration:Float, fromValue:Float = 0, toValue:Float = 1)
tag
- Sound tag, leave this field empty if you want to do a fade in on the Background music insteadduration
- The time it takes for the volume to go fromfromValue
totoValue
fromValue
- Starting value. Default value is0
toValue
- End value. Default value is1
soundFadeOut(tag:String, duration:Float, toValue:Float = 0)
tag
- Sound tag, leave this field empty if you want to do a fade out on the Background music insteadduration
- The time it takes for the volume to go from the starting volume totoValue
toValue
- End value. Default value is0
soundFadeCancel(tag:String)
tag
- Sound tag, leave this field empty if you want cancel the Background music's fade in/out instead
Getters/Setters
getSoundVolume(tag:String)
tag
- Sound tag, leave this field empty if you want get the Background music's volume instead
setSoundVolume(tag:String, value:Float)
tag
- Sound tag, leave this field empty if you want change the Background music's volume insteadvalue
- Goes from 0 to 1.
getSoundTime(tag:String)
Gets the current sound's position in miliseconds
tag
- Sound tag
setSoundTime(tag:String, value:Float)
Sets the current sound's position in miliseconds
tag
- Sound tagvalue
- New position
Note: Value 5000 = 5 seconds