media.playSound()

类型 函数
库 media.*
返回值 无
修订版 发行版 2024.3703
关键字 媒体、播放、声音、音频
另请参阅 media.getSoundVolume()
media.setsoundVolume()
media.pauseSound()
media.stopSound()

由于列举的各种限制，建议使用 音频 库回放音频。

概述

播放扩展音效(与 事件音效相对)或恢复播放已暂停的扩展音效。您一次只能打开这样一个音效文件。

您可以选择指定一个回调函数，每当完成播放时都要调用此函数。

疑难解答

语法

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

media.playSound( soundfile [, baseDir] [, loop] )
soundfile (必需)

字符串. 音效文件的名称。该文件的格式必须得到所用平台的支持。

baseDir (可选)

常量. 如果指定，此参数是音效文件所在目录（如果您为 sound 指定了文件名）。默认为 system.ResourceDirectory。其他选项包括

  • system.DocumentsDirectory
  • system.ApplicationSupportDirectory
  • system.TemporaryDirectory
  • system.CachesDirectory
onComplete (可选)

函数. 如果指定，此参数是完成侦听器（回调函数），每次播放音效结束后都会调用此函数。

loop (可选)

布尔值. 如果 为 true，音效会重复播放。默认为 false。

示例

media.playSound( "song.mp3" )

local function stopAfter10Seconds()
    media.stopSound()
end

timer.performWithDelay( 10000, stopAfter10Seconds )