类型 函数 库 audio.* 返回值 对象 (音频句柄) 修订 版本 2024.3703 关键词 audio, 加载, 流 另请参阅 audio.loadSound() audio.dispose() 音频使用/函数 (指南)
加载（打开）一个文件以作为流式音频读取。流式文件一次读取一小块，以最大限度地减少内存使用。这些文件适用于大型/长文件，如背景音乐和语音。与使用 audio.loadSound() 加载的文件不同，这些文件不能在多个通道之间同时共享。如果需要播放同一文件的多个同步实例，则必须加载该文件的多个实例。
此函数返回一个指向声音文件的句柄。
请注意，您有责任卸载（清理）使用此 API 加载的任何音频文件。使用 audio.dispose() API 清理完全不需要的音频句柄，并将其从内存中卸载以回收更多 RAM。
在许多使用情况下，您可能希望在整个程序中使用音频文件，在这种情况下，您无需担心释放资源。
另请注意，与使用 audio.loadSound() 加载的文件相比，流式文件的延迟成本可能略高。它们的播放运行时（CPU）成本也可能略高于使用 audio.loadSound() 加载的文件。
有关支持的音频格式和注意事项的详细信息，请参阅 音频使用/函数 指南。
audio.loadStream( audioFileName [, baseDir ] )
字符串. 要加载的音频文件的名称。支持的文件格式由您运行的平台决定。
常量. 默认情况下，声音文件应位于项目文件夹中 (system.ResourceDirectory)。如果声音文件位于应用程序文档目录中，请使用 system.DocumentsDirectory。
local backgroundMusic = audio.loadStream("backgroundMusic.m4a")
local narrationSpeech = audio.loadStream("narrationSpeech.wav")