类型 函数 库 audio.* 返回值 表 修订版本 版本 2024.3703 关键词 音频, 加载声音, 加载 另请参阅 audio.loadStream() audio.play() 音频使用/函数 (指南)
将整个文件完全加载到内存中，并返回对音频数据的引用。完全加载到内存中的文件可以在多个通道上同时重复使用/播放/共享，因此您只需要加载文件的一个实例。您应该使用此方法加载所有短声音，尤其是您可能经常播放的声音。为了获得最佳效果，请在应用程序启动或新关卡/场景开始时加载所有声音。
此函数返回声音文件的句柄。
请注意，您有责任卸载（清理）使用此 API 加载的任何音频文件。使用 audio.dispose() API 清理您完全不需要的音频句柄，并将其从内存中卸载以获得更多 RAM。
在许多使用情况下，您可能希望在整个程序中使用音频文件，在这种情况下，您无需担心释放资源。
支持的音频格式由您运行的平台决定。但请注意，audio.loadSound() 和 audio.loadStream() 支持相同的格式。
有关支持的音频格式和注释的详细信息，请参阅 音频使用/函数 指南。
audio.loadSound( audiofileName [, baseDir ] )
字符串。 要加载的音频文件的名称。支持的文件格式由您运行的平台决定。
常量。 默认情况下，声音文件应位于项目文件夹中 (system.ResourceDirectory)。如果声音文件位于应用程序文档目录中，请使用 system.DocumentsDirectory。
local laserSound = audio.loadSound( "laserBlast.wav" ) local explosionSound = audio.loadSound( "explosion.mp3" )