Lua Script API: Sound and Music Functions - Lokitot/FNF-SoulEngine GitHub Wiki
Start Sound/Music
playMusic(sound:String, volume:Float = 1, loop:Bool = false)
sound- File name (Should be located in mods/music/ or assets/music/)volume- Optional value, volume percent goes from 0 to 1. Default value: 1loop- 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 in mods/sounds/ or assets/sounds/)volume- Optional value, volume percent goes from 0 to 1. 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 from fromValue to toValuefromValue- Starting value. Default value is 0toValue- End value. Default value is 1
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 to toValuetoValue- End value. Default value is 0
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 instead
value - 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 tag
value- New position
Note: Value 5000 = 5 seconds