media.playEventSound()

类型 函数
库 media.*
返回值 无
修订 版本 2024.3703
关键字 媒体、声音、事件声音、音频
参见 media.newEventSound()
media.playSound()

由于下文概述的各种限制，建议使用 audio 库来播放音频。

概述

播放事件声音(1-3 秒). 第一个参数可以是事件声音 ID 或事件声音的文件名。此函数建议用于播放短声音，尤其是避免性能抖动。

注意要点

语法

media.playEventSound( sound [, baseDir] [, completionListener] )
sound (必填)

UserData 或 String。第一个参数要么是一个事件声音 ID(来自 media.newEventSound())要么是事件声音的文件名。

baseDir (可选)

常量。如果指定此参数，则该参数是声音文件所在的目录，前提是您已为 sound 指定了一个文件名。默认值为 system.ResourceDirectory。其他选项包括

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

函数。如果指定此函数，则是一个侦听函数，将在每次播放事件声音时调用该函数。但是请注意，Android 不支持此功能。

示例

local soundID = media.newEventSound( "beep.caf" )

local playBeep = function()
    media.playEventSound( soundID )
end

timer.performWithDelay( 7500, playBeep, 0 )