flutter pub add volume_controller基于插件公开信息、社区数据与项目使用情况整理的选型参考。
volume_controller 包是一个跨平台的 Flutter 插件，可在 Android、iOS、macOS、Windows 和 Linux 上控制系统音量。它提供了一个简单的 API 来调整、静音和查询音量级别，非常适合媒体应用、音频工具或任何需要系统级音频控制的应用程序。该插件抽象了平台特定的实现，确保在各种设备上行为一致。它支持基于流的音量监控和直接音量操作。该插件设计时注重集成简便性，可无缝融入现有的 Flutter 项目。
以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。
Control and observe the system volume on Android, iOS, macOS, Windows, and Linux.
>=3.44.0^3.12.0The iOS plugin uses the scene lifecycle APIs introduced for Flutter plugins in Flutter 3.38.
| Platform | Supported |
|---|---|
| Android | ✅ |
| iOS | ✅ |
| macOS | ✅ |
| Windows | ✅ |
| Linux | ✅ |
showSystemUI is supported on Android and iOS only.0 on every platform:
STREAM_MUSIC mute (isStreamMute / ADJUST_MUTE).0 and unmute restores the previous volume saved by the plugin.isMuted() is volume == 0. setMute(true) sets volume to 0; setMute(false) restores the previous volume saved by the plugin. iOS 26 AVAudioSession.setOutputMuted is not used, because it mutes this app's audio session rather than the system volume.Show or hide the volume system UI. The default value is true. Supported on iOS and Android only.
VolumeController.instance.showSystemUI = true;
Get the current system volume.
double volume = await VolumeController.instance.getVolume();
Set the system volume. The input should be in the range 0.0 to 1.0.
await VolumeController.instance.setVolume(double volume);
Add a listener to monitor system volume changes.
fetchInitialVolume: Send the current volume immediately. Defaults to true.VolumeController.instance.addListener((volume) {
// Do something with the volume
}, fetchInitialVolume: true);
Remove the volume listener.
await VolumeController.instance.removeListener();
Check whether the system is muted.
bool isMuted = await VolumeController.instance.isMuted();
Mute or unmute the system volume.
await VolumeController.instance.setMute(bool mute);