类型 函数 库 audio.* 返回值 布尔值 修订 版本 2024.3703 关键词 audio, 音量, 设置音量 另请参阅 audio.getVolume() audio.play()
设置特定通道的音量或设置主音量。
此函数在成功时返回 true，失败时返回 false。
请注意，主音量并不一定是设备的铃声音量。但是，所有音量都与铃声音量成比例缩放。
设置音量后，新的音量级别将一直保持，直到您再次设置它为止。尤其是在通道方面，您应该始终牢记这一点。如果您更改了音量，例如在通道 1 上，即使该通道上的声音播放完毕并且您开始在该通道上播放新声音，通道 1 仍将继续保持在该级别。
如果您正在使用自动分配的通道播放音频，请理解如果您之前更改了自动分配给您的通道的音量，则新声音将以该级别播放。为了进行防御性编程，您可以考虑对要更改音量的通道使用手动通道分配，并使用 audio.reserveChannels() API 来防止这些通道被自动分配。
audio.setVolume( volume [, options ] )
数字. 您要应用的新音量级别。有效数字范围为 0.0 到 1.0，其中 1.0 是最大值。
表. 支持单个键 channel 的表，它是您要设置音量的通道号。有效通道为 1 到最大通道数（当前为 32）。指定 0 可将音量应用于所有通道。完全省略此参数将设置主音量，这与通道音量不同。所有通道音量都按主音量进行缩放。
audio.setVolume( 0.5 ) -- set the master volume
audio.setVolume( 0.75, { channel=1 } ) -- set the volume on channel 1