Type Function Library media.* Return value none Revision Current Public Release (2017.3068) Keywords media, play, sound, audio See also media.getSoundVolume() media.setsoundVolume() media.pauseSound() media.stopSound()
Plays an extended sound (as opposed to an "event sound" which is typically 1-3 seconds in duration), or resumes play of a paused extended sound. You can only have one such sound file open at a time.
You can optionally specify a callback function to be called whenever playback has finished.
It is recommended that the newer audio library be used for playing back audio.
Only one sound can be playing using this sound API. Calling this API with a different sound file will stop the existing sound and play the new sound.
media.playSound( soundfile [, baseDir] [, onComplete] ) media.playSound( soundfile [, baseDir] [, loop] )
String. Name of the sound file. The file must be in a format that is supported by the platform.
Function. If specified, this argument is a completion listener (callback function) that will be called each time the sound finishes playing.
true, the sound will be played repeatedly. The default is
Constant. If specified, this argument is the directory where the sound file is located (if you specified a filename for
sound). The default is
system.ResourceDirectory. Other options include:
media.playSound( "song.mp3" ) local stopAfter10Seconds = function() media.stopSound() end timer.performWithDelay( 10000, stopAfter10Seconds )