audio.setMaxVolume()

类型 函数
audio.*
返回值 布尔值
修订 版本 2024.3703
关键词 音频, 音量, 最大音量, 设置最大值, 声音
另请参阅 audio.setMinVolume()
audio.getVolume()
audio.setVolume()
audio.getMaxVolume()
audio.setMinVolume()
audio.getMinVolume()

概述

将最大音量限制为设定值。任何超过该值的音量都将以最大音量级别播放。

此函数在成功时返回 true,否则返回 false

注意事项

主音量没有最大音量限制。

语法

audio.setMaxVolume( volume, options )
volume (必需)

数字. 您要应用的新最大音量级别。有效数字范围为 0.01.0,其中 1.0 为最大值。

options (必需)

. 支持单个键 channel 的表,该键是您要设置最大音量的通道号。有效通道为 1 到最大通道数(当前为 32)。指定 0 可将最大音量应用于所有通道。

示例

audio.setMaxVolume( 0.75, { channel=1 } )