Skip to content

A Flutter plugin to control system volume and listen for volume changes on different platforms.

License

Notifications You must be signed in to change notification settings

yosemiteyss/flutter_volume_controller

Folders and files

NameName
Last commit message
Last commit date
Jun 25, 2023
May 10, 2023
Jul 4, 2023
Jul 4, 2023
May 10, 2023
Dec 10, 2022
Dec 10, 2022
May 10, 2023
Dec 10, 2022
Feb 13, 2023
Nov 13, 2022
Jul 4, 2023
Sep 17, 2022
May 30, 2023
Sep 19, 2022
Jul 4, 2023

Repository files navigation

Flutter Volume Controller

A Flutter plugin to control system volume and listen for volume changes on different platforms.

pub package

Features

  • Control system and media volumes.
  • Listen for volume changes.

Platform Support

  • ✅ Android
  • ✅ iOS
  • ✅ macOS
  • ✅ Windows
  • ✅ Linux

Example

Usage

Control System UI Visibility

  • Set to true to display system volume slider when changing volume.
  • This settings only works on Android and iOS.
FlutterVolumeController.showSystemUI = true;

Get Volume

final volume = await FlutterVolumeController.getVolume();

Set Volume

await FlutterVolumeController.setVolume(0.5);

Increase Volume

  • On Android and Windows, when step is set to null, it will uses the default system stepping value.
  • On iOS, macOS, Linux, if step is undefined, the default stepping value is set to 0.15.
await FlutterVolumeController.raiseVolume(0.2);
await FlutterVolumeController.raiseVolume(null);

Decrease Volume

  • On Android and Windows, when step is set to null, it will uses the default system stepping value.
  • On iOS, macOS, Linux, if step is undefined, the default stepping value is set to 0.15.
await FlutterVolumeController.lowerVolume(0.2);
await FlutterVolumeController.lowerVolume(null);

Check Mute

  • On Android and iOS, we check if the current volume level is already dropped to zero.
  • On macOS, Windows, Linux, we check if the mute switch is turned on.
final isMuted = await FlutterVolumeController.getMute();

Set Mute

  • On Android and iOS, we either set the volume to zero or revert to the previous level.
  • On macOS, Windows, Linux, we control the mute switch. Volume will be restored once it's unmuted.
await FlutterVolumeController.setMute(true);
await FlutterVolumeController.setMute(false);

Toggle Mute

await FlutterVolumeController.toggleMute();

Set Audio Stream on Android

  • Adjusts to the audio stream whose volume should be changed by the hardware volume controls.
  • Supported streams: AudioStream.voiceCall, AudioStream.system, AudioStream.ring , AudioStream.music, AudioStream.alarm.
  • For more details, visit AudioManager
await FlutterVolumeController.setAndroidAudioStream(stream: AudioStream.system);

Get Audio Stream on Android

  • Get the current audio stream on Android.
final stream = await FlutterVolumeController.getAndroidAudioStream();

Set Audio Session Category on iOS

  • Adjusts to a different set of audio behaviors.
  • Supported categories: AudioSessionCategory.ambient, AudioSessionCategory.multiRoute , AudioSessionCategory.playAndRecord, AudioSessionCategory.playback , AudioSessionCategory.record, AudioSessionCategory.soleAmbient
  • For more details, visit AVAudioSession.Category
await FlutterVolumeController.setIOSAudioSessionCategory(category: AudioSessionCategory.playback);

Get Audio Session Category on iOS

  • Get the current audio session category on iOS.
final category = await FlutterVolumeController.getIOSAudioSessionCategory();

Listen for Volume Changes

  • Use emitOnStart to control whether volume level should be emitted immediately right after the listener is attached.
@override
void initState() {
  super.initState();
  FlutterVolumeController.addListener(
    (volume) {
      debugPrint('Volume changed: $volume');
    },
  );
}

@override
void dispose() {
  FlutterVolumeController.removeListener();
  super.dispose();
}

Notes

Fine-grained volume control

  • Due to platform and device difference, it's normal that volume level could not be controlled precisely. For example, Android supports only 15 volume steps by default, the volume after being set would be a rounded off value.

Audio devices without volume control

  • On desktop platforms like Windows and Linux, you may encounter PlatformExceptions if the default audio device doesn't support volume control, like an external monitor.

Having Bugs?

  • This package is under active development. If you find any bug, please create an issue on Github.

Support

"Buy Me A Coffee"