WARNING! This function has been deprecated and you should use audio_play_sound instead.
This function can be used to start a piece of background music playing. You can only have one piece of background playing at a time when using this function, and starting a sound while a previous one is playing will end the previous one directly. You can also choose whether the sound should loop back to the beginning by setting the loop flag to true, or only to play once by setting it to false.
The following quote above is for the audio_play_music function. I originally complained like crazy that they had a duplicate set of functions and were reserving an audio channel, I am so glad they corrected this. I am going to remove all those music functions so that I can fix the new audio system to work properly. It is not an issue since the functions were short lived and the duplicates still exist, there was no need to distinguish the functions.
The full list of deprecated audio functions can be found here.http://enigma-dev.org/docs/Wiki/Obsolete_Functions#Audio
This is the commit where the fixes are applied and functions become deprecated.https://github.com/enigma-dev/enigma-dev/pull/574