audio.fadeOut()

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

概述

此函数会在指定的时间内停止播放声音,并在停止过程中将音量淡化到最小值。音频将在时间结束时停止,并且通道将被释放。

此函数返回实际应用`audio.fadeOut()`的通道数。

注意事项

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

语法

audio.fadeOut( [ { [channel=c] [, time=t] } ] )

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

通道(可选)

数字 您要在其上执行淡出的通道号。`1` 到最大通道数都是有效通道。指定 `0` 可淡出所有通道。

时间(可选)

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

示例

audio.fadeOut( { channel=1, time=5000 } )