audio.fade()

类型 函数
audio.*
返回值 数字
修订 版本 2024.3703
关键词 audio, fade
另请参阅 audio.fadeOut()
audio.play()
audio.setVolume()

概述

此函数将播放中的声音在指定时间内淡入到指定音量。淡入完成后,音频将继续播放。

此函数返回实际应用淡入效果的通道数。

注意事项

淡入音量时,您正在更改通道的音量。此值是永久性的,如果您想稍后再次使用该通道,您有责任重置通道上的音量(请参阅 audio.setVolume())。

语法

audio.fade( [ { [channel=c] [, time=t] [, volume=v ] } ] )

此函数接受一个表作为参数,该表包含以下可选键:

channel (可选)

数字 您要在其上应用淡入效果的通道号。1 到最大通道数是有效的通道。指定 0 可将淡入应用于所有通道。

time (可选)

数字 您希望音频淡入的时间量(以毫秒为单位)。省略此参数将调用默认淡入时间,当前为 1000 毫秒。

volume (可选)

数字 您想要更改(淡入)的目标音量。有效数字为 0.01.0,其中 1.0 是最大音量。如果省略此参数,则默认值为 0.0

示例

audio.fade( { channel=1, time=5000, volume=0.5 } )