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);