media.playSound()

Type Function
Library media.*
Return value none
Revision Release 2022.3683
Keywords media, play, sound, audio
See also media.getSoundVolume()
media.setsoundVolume()
media.pauseSound()
media.stopSound()

Because of various limitations outlined below, it is recommended that the audio library be used for playing back audio.

Overview

Plays an extended sound (as opposed to an event sound) 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.

Gotchas

Syntax

media.playSound( soundfile [, baseDir] [, onComplete] )

media.playSound( soundfile [, baseDir] [, loop] )
soundfile (required)

String. Name of the sound file. The file must be in a format that is supported by the platform.

baseDir (optional)

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:

  • system.DocumentsDirectory
  • system.ApplicationSupportDirectory
  • system.TemporaryDirectory
  • system.CachesDirectory
onComplete (optional)

Function. If specified, this argument is a completion listener (callback function) that will be called each time the sound finishes playing.

loop (optional)

Boolean. If true, the sound will be played repeatedly. The default is false.

Example

media.playSound( "song.mp3" )

local function stopAfter10Seconds()
    media.stopSound()
end

timer.performWithDelay( 10000, stopAfter10Seconds )