audio.getDuration()

类型 函数
audio.*
返回值 数字
修订版本 版本 2024.3703
关键词 audio, duration(时长)
另请参阅 audio.loadSound()
audio.loadStream()

概述

此函数返回音频资源的总时间(以毫秒为单位)。如果无法确定总长度,则返回 `-1`。

注意事项

假设实际可以确定时长,则返回的数字可能并非完全准确。特别是对于使用 audio.loadStream() 加载的声音,该信息可能是估计值,或者由于元数据不准确而略有偏差。您使用的文件类型和编码可能会影响此值的准确性。

语法

audio.getDuration( audioHandle )
audioHandle (必填)

audio.loadSound()audio.loadStream() 返回的音频对象。

示例

local backgroundMusic = audio.loadStream( "backgroundMusic.m4a" )
local totalTime = audio.getDuration( backgroundMusic )

print( totalTime )