flet-video: add mpv_properties to VideoConfiguration

sdk/python/packages/flet-video/src/flet_video/types.py

@@ -4,7 +4,7 @@
 
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import Optional
+from typing import Optional, Union
 
 import flet as ft
 
@@ -90,6 +90,29 @@ class VideoConfiguration:
     Specifying this option will cause [`width`][(c).] & [`height`][(c).] to be ignored.
     """
 
+    mpv_properties: Optional[dict[str, Union[str, int, float, bool]]] = None
+    """
+    Extra mpv/libmpv properties to set on
+    native backends (Windows/macOS/Linux/iOS/Android).
+
+    The keys are mpv option/property names without the leading `--`. Values can be
+    `str`, `int`, `float` or `bool`. All values are converted to strings before being
+    passed to mpv; boolean values are converted to `"yes"` / `"no"`.
+
+    Full list of mpv options: https://mpv.io/manual/stable/#options
+
+    Example:
+        ```python
+        >>> VideoConfiguration(
+                mpv_properties={
+                    "profile": "low-latency",   # --profile=low-latency
+                    "untimed": True,            # --untimed
+                    "volume": 80,               # --volume=80
+                }
+            )
+        ```
+    """
+
 
 @dataclass
 class VideoSubtitleTrack:

sdk/python/packages/flet-video/src/flutter/flet_video/lib/src/video.dart

@@ -25,6 +25,27 @@ class _VideoControlState extends State<VideoControl> with FletStoreMixin {
   late VideoController _controller;
   bool _initialized = false;
 
+  Future<void> _applyMpvProperties(Control control) async {
+    final cfg = control.get("configuration");
+    if (cfg is! Map) return;
+
+    final mpvPropsRaw = cfg["mpv_properties"];
+    if (mpvPropsRaw is! Map) return;
+
+    final platform = _player.platform;
+    if (platform is! NativePlayer) return;
+    final native = platform as dynamic;
+
+    for (final entry in mpvPropsRaw.entries) {
+      final key = entry.key.toString();
+      final val = entry.value;
+      if (val == null) continue;
+      final valueStr = val is bool ? (val ? "yes" : "no") : val.toString();
+      await native.setProperty(key, valueStr);
+    }
+  }
+
+
   void _setup(Control control) {
     final playerConfig = PlayerConfiguration(
       title: control.getString("title", "flet-video")!,
@@ -64,8 +85,14 @@ class _VideoControlState extends State<VideoControl> with FletStoreMixin {
       });
     }
 
-    _player.open(Playlist(parseVideoMedias(control.get("playlist"), [])!),
-        play: control.getBool("autoplay", false)!);
+    final playlist =
+        Playlist(parseVideoMedias(control.get("playlist"), [])!);
+    final autoplay = control.getBool("autoplay", false)!;
+
+    () async {
+      await _applyMpvProperties(control);
+      await _player.open(playlist, play: autoplay);
+    }();
   }
 
   void _teardown(Control control) {
@@ -294,4 +321,4 @@ class _VideoControlState extends State<VideoControl> with FletStoreMixin {
 
     return ConstrainedControl(control: widget.control, child: video);
   }
-}
+}