feat: integrate volume_controller for system volume synchronization

Author: schembriaiden

lib/providers/settings/video_player_settings_provider.dart

@@ -1,9 +1,12 @@
+import 'dart:io';
+
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
-
 import 'package:collection/collection.dart';
+import 'package:flutter/foundation.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:screen_brightness/screen_brightness.dart';
+import 'package:volume_controller/volume_controller.dart';
 
 import 'package:fladder/models/settings/key_combinations.dart';
 import 'package:fladder/models/settings/video_player_settings.dart';
@@ -18,10 +21,38 @@ final videoPlayerSettingsProvider =
 final playbackRateProvider = StateProvider<double>((ref) => 1.0);
 
 class VideoPlayerSettingsProviderNotifier extends StateNotifier<VideoPlayerSettingsModel> {
-  VideoPlayerSettingsProviderNotifier(this.ref) : super(VideoPlayerSettingsModel());
+  VideoPlayerSettingsProviderNotifier(this.ref) : super(VideoPlayerSettingsModel()) {
+    _initVolumeSync();
+  }
 
   final Ref ref;
 
+  void _initVolumeSync() async {
+    // Initialize volume from system volume on mobile/supported platforms
+    if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
+      VolumeController.instance.showSystemUI = false;
+      final initialVolume = await VolumeController.instance.getVolume();
+      state = state.copyWith(internalVolume: initialVolume * 100);
+
+      VolumeController.instance.addListener((volume) {
+        // Update both the model and the player when system volume changes (hardware buttons)
+        final newVolume = volume * 100;
+        if ((state.internalVolume - newVolume).abs() > 0.1) {
+          state = state.copyWith(internalVolume: newVolume);
+          ref.read(videoPlayerProvider).setVolume(newVolume);
+        }
+      });
+    }
+  }
+
+  @override
+  void dispose() {
+    if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
+      VolumeController.instance.removeListener();
+    }
+    super.dispose();
+  }
+
   @override
   set state(VideoPlayerSettingsModel value) {
     final oldState = super.state;
@@ -63,12 +94,18 @@ class VideoPlayerSettingsProviderNotifier extends StateNotifier<VideoPlayerSetti
   void setVolume(double value) {
     state = state.copyWith(internalVolume: value);
     ref.read(videoPlayerProvider).setVolume(value);
+    if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
+      VolumeController.instance.setVolume(value / 100);
+    }
   }
 
   void steppedVolume(int i) {
     final value = (state.volume + i).clamp(0, 100).toDouble();
     state = state.copyWith(internalVolume: value);
     ref.read(videoPlayerProvider).setVolume(value);
+    if (!kIsWeb && (Platform.isAndroid || Platform.isIOS)) {
+      VolumeController.instance.setVolume(value / 100);
+    }
   }
 
   void steppedSpeed(double i) {

linux/flutter/generated_plugin_registrant.cc

@@ -15,6 +15,7 @@
 #include <screen_retriever_linux/screen_retriever_linux_plugin.h>
 #include <sqlite3_flutter_libs/sqlite3_flutter_libs_plugin.h>
 #include <url_launcher_linux/url_launcher_plugin.h>
+#include <volume_controller/volume_controller_plugin.h>
 #include <window_manager/window_manager_plugin.h>
 
 void fl_register_plugins(FlPluginRegistry* registry) {
@@ -45,6 +46,9 @@ void fl_register_plugins(FlPluginRegistry* registry) {
   g_autoptr(FlPluginRegistrar) url_launcher_linux_registrar =
       fl_plugin_registry_get_registrar_for_plugin(registry, "UrlLauncherPlugin");
   url_launcher_plugin_register_with_registrar(url_launcher_linux_registrar);
+  g_autoptr(FlPluginRegistrar) volume_controller_registrar =
+      fl_plugin_registry_get_registrar_for_plugin(registry, "VolumeControllerPlugin");
+  volume_controller_plugin_register_with_registrar(volume_controller_registrar);
   g_autoptr(FlPluginRegistrar) window_manager_registrar =
       fl_plugin_registry_get_registrar_for_plugin(registry, "WindowManagerPlugin");
   window_manager_plugin_register_with_registrar(window_manager_registrar);

linux/flutter/generated_plugins.cmake

@@ -12,6 +12,7 @@ list(APPEND FLUTTER_PLUGIN_LIST
   screen_retriever_linux
   sqlite3_flutter_libs
   url_launcher_linux
+  volume_controller
   window_manager
 )
 

macos/Flutter/GeneratedPluginRegistrant.swift

@@ -29,6 +29,7 @@ import sqflite_darwin
 import sqlite3_flutter_libs
 import url_launcher_macos
 import video_player_avfoundation
+import volume_controller
 import wakelock_plus
 import webview_flutter_wkwebview
 import window_manager
@@ -58,6 +59,7 @@ func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) {
   Sqlite3FlutterLibsPlugin.register(with: registry.registrar(forPlugin: "Sqlite3FlutterLibsPlugin"))
   UrlLauncherPlugin.register(with: registry.registrar(forPlugin: "UrlLauncherPlugin"))
   FVPVideoPlayerPlugin.register(with: registry.registrar(forPlugin: "FVPVideoPlayerPlugin"))
+  VolumeControllerPlugin.register(with: registry.registrar(forPlugin: "VolumeControllerPlugin"))
   WakelockPlusMacosPlugin.register(with: registry.registrar(forPlugin: "WakelockPlusMacosPlugin"))
   WebViewFlutterPlugin.register(with: registry.registrar(forPlugin: "WebViewFlutterPlugin"))
   WindowManagerPlugin.register(with: registry.registrar(forPlugin: "WindowManagerPlugin"))

pubspec.lock

@@ -2386,6 +2386,14 @@ packages:
       url: "https://pub.dev"
     source: hosted
     version: "15.0.2"
+  volume_controller:
+    dependency: "direct main"
+    description:
+      name: volume_controller
+      sha256: ce25d4e02dd6f0b6d5d02dc1daa8de11b2d42d0f5afab8b1eda6aa0ebab3937a
+      url: "https://pub.dev"
+    source: hosted
+    version: "3.4.4"
   wakelock_plus:
     dependency: "direct main"
     description:

pubspec.yaml

@@ -113,6 +113,7 @@ dependencies:
   package_info_plus: ^9.0.0
   wakelock_plus: ^1.3.2
   screen_brightness: ^2.1.7
+  volume_controller: ^3.4.4
   window_manager: ^0.5.1
   smtc_windows: ^1.1.0
   background_downloader: ^9.2.3

windows/flutter/generated_plugin_registrant.cc

@@ -20,6 +20,7 @@
 #include <share_plus/share_plus_windows_plugin_c_api.h>
 #include <sqlite3_flutter_libs/sqlite3_flutter_libs_plugin.h>
 #include <url_launcher_windows/url_launcher_windows.h>
+#include <volume_controller/volume_controller_plugin_c_api.h>
 #include <window_manager/window_manager_plugin.h>
 
 void RegisterPlugins(flutter::PluginRegistry* registry) {
@@ -51,6 +52,8 @@ void RegisterPlugins(flutter::PluginRegistry* registry) {
       registry->GetRegistrarForPlugin("Sqlite3FlutterLibsPlugin"));
   UrlLauncherWindowsRegisterWithRegistrar(
       registry->GetRegistrarForPlugin("UrlLauncherWindows"));
+  VolumeControllerPluginCApiRegisterWithRegistrar(
+      registry->GetRegistrarForPlugin("VolumeControllerPluginCApi"));
   WindowManagerPluginRegisterWithRegistrar(
       registry->GetRegistrarForPlugin("WindowManagerPlugin"));
 }

windows/flutter/generated_plugins.cmake

@@ -17,6 +17,7 @@ list(APPEND FLUTTER_PLUGIN_LIST
   share_plus
   sqlite3_flutter_libs
   url_launcher_windows
+  volume_controller
   window_manager
 )