类型 函数 库 audio.* 返回值 数字 修订 版本 2024.3703 关键词 audio, fade 另请参阅 audio.fadeOut() audio.play() audio.setVolume()
此函数将播放中的声音在指定时间内淡入到指定音量。淡入完成后,音频将继续播放。
此函数返回实际应用淡入效果的通道数。
淡入音量时,您正在更改通道的音量。此值是永久性的,如果您想稍后再次使用该通道,您有责任重置通道上的音量(请参阅 audio.setVolume())。
audio.fade( [ { [channel=c] [, time=t] [, volume=v ] } ] )
此函数接受一个表作为参数,该表包含以下可选键:
数字。 您要在其上应用淡入效果的通道号。1
到最大通道数是有效的通道。指定 0
可将淡入应用于所有通道。
数字。 您希望音频淡入的时间量(以毫秒为单位)。省略此参数将调用默认淡入时间,当前为 1000 毫秒。
数字。 您想要更改(淡入)的目标音量。有效数字为 0.0
到 1.0
,其中 1.0
是最大音量。如果省略此参数,则默认值为 0.0
。
audio.fade( { channel=1, time=5000, volume=0.5 } )