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