fix: seek throttle

Author: nokarin-dev

changes.md

@@ -10,6 +10,7 @@ This project loosely follows Keep a Changelog and uses Semantic Versioning.
 
 ### Fixed
 
+- Call backend only on drag end to prevent seek throttle
 - All button now should has pointer now
 - Discord button label overflow
 - Added helpers to prevent backend crash

lib/providers/player_provider.dart

@@ -192,6 +192,19 @@ class PlayerNotifier extends StateNotifier<PlayerState> {
     }
   }
 
+  void seekPreview(Duration position) {
+    state = state.copyWith(position: position);
+  }
+
+  Future<void> seekCommit(Duration position) async {
+    final sec = position.inMilliseconds / 1000.0;
+    await AudioService.seek(sec);
+    state = state.copyWith(position: position);
+    if (state.status == PlayerStatus.playing) {
+      DiscordService.updateAfterSeek(state, sec);
+    }
+  }
+
   Future<void> setVolume(double volume) async {
     final v = volume.clamp(0.0, 1.0);
     await AudioService.setVolume(v);

lib/widgets/custom_slider.dart

@@ -3,6 +3,7 @@ import 'package:flutter/material.dart';
 class CustomSlider extends StatefulWidget {
   final double value;
   final ValueChanged<double>? onChanged;
+  final ValueChanged<double>? onChangeEnd;
   final double trackHeight;
   final double thumbRadius;
   final bool showThumb;
@@ -14,6 +15,7 @@ class CustomSlider extends StatefulWidget {
     super.key,
     required this.value,
     this.onChanged,
+    this.onChangeEnd,
     this.trackHeight = 2,
     this.thumbRadius = 5,
     this.showThumb = true,
@@ -28,19 +30,32 @@ class CustomSlider extends StatefulWidget {
 
 class _CustomSliderState extends State<CustomSlider> {
   bool _dragging = false;
+  double _dragValue = 0.0;
 
   void _handleTapDown(TapDownDetails d, double width) {
     if (widget.onChanged == null) return;
     final v = (d.localPosition.dx / width).clamp(0.0, 1.0);
     widget.onChanged!(v);
+    widget.onChangeEnd?.call(v);
   }
 
-  void _handleDrag(DragUpdateDetails d, double width) {
+  void _handleDragStart(DragStartDetails d, double width) {
+    _dragValue = (d.localPosition.dx / width).clamp(0.0, 1.0);
+    setState(() => _dragging = true);
+  }
+
+  void _handleDragUpdate(DragUpdateDetails d, double width) {
     if (widget.onChanged == null) return;
     final v = (d.localPosition.dx / width).clamp(0.0, 1.0);
+    _dragValue = v;
     widget.onChanged!(v);
   }
 
+  void _handleDragEnd(DragEndDetails _) {
+    setState(() => _dragging = false);
+    widget.onChangeEnd?.call(_dragValue);
+  }
+
   @override
   Widget build(BuildContext context) {
     final cs = Theme.of(context).colorScheme;
@@ -55,9 +70,9 @@ class _CustomSliderState extends State<CustomSlider> {
         return GestureDetector(
           behavior: HitTestBehavior.opaque,
           onTapDown: (d) => _handleTapDown(d, w),
-          onHorizontalDragStart: (_) => setState(() => _dragging = true),
-          onHorizontalDragUpdate: (d) => _handleDrag(d, w),
-          onHorizontalDragEnd: (_) => setState(() => _dragging = false),
+          onHorizontalDragStart: (d) => _handleDragStart(d, w),
+          onHorizontalDragUpdate: (d) => _handleDragUpdate(d, w),
+          onHorizontalDragEnd: _handleDragEnd,
           child: SizedBox(
             height: widget.thumbRadius * 2 + 8,
             child: CustomPaint(
@@ -99,7 +114,6 @@ class _SliderPainter extends CustomPainter {
   @override
   void paint(Canvas canvas, Size size) {
     final cy = size.height / 2;
-    final trackY = cy;
     final left = thumbRadius;
     final right = size.width - thumbRadius;
     final trackW = right - left;
@@ -117,17 +131,13 @@ class _SliderPainter extends CustomPainter {
       ..strokeWidth = trackHeight
       ..style = PaintingStyle.stroke;
 
-    // inactive track
-    canvas.drawLine(Offset(left, trackY), Offset(right, trackY), trackPaint);
-    // active track
+    canvas.drawLine(Offset(left, cy), Offset(right, cy), trackPaint);
     if (fillX > left) {
-      canvas.drawLine(Offset(left, trackY), Offset(fillX, trackY), fillPaint);
+      canvas.drawLine(Offset(left, cy), Offset(fillX, cy), fillPaint);
     }
-
-    // thumb
     if (showThumb) {
       canvas.drawCircle(
-        Offset(fillX, trackY),
+        Offset(fillX, cy),
         thumbRadius,
         Paint()..color = thumbColor,
       );

lib/widgets/mini_player_bar.dart

@@ -240,7 +240,12 @@ class _DesktopBar extends ConsumerWidget {
                           inactiveColor: cs.onSurface.withValues(alpha: 0.08),
                           onChanged: (v) {
                             if (duration.inMilliseconds > 0) {
-                              notifier.seek(duration * v);
+                              notifier.seekPreview(duration * v);
+                            }
+                          },
+                          onChangeEnd: (v) {
+                            if (duration.inMilliseconds > 0) {
+                              notifier.seekCommit(duration * v);
                             }
                           },
                         ),
@@ -432,7 +437,12 @@ class _DesktopBar extends ConsumerWidget {
                           inactiveColor: cs.onSurface.withValues(alpha: 0.08),
                           onChanged: (v) {
                             if (duration.inMilliseconds > 0) {
-                              notifier.seek(duration * v);
+                              notifier.seekPreview(duration * v);
+                            }
+                          },
+                          onChangeEnd: (v) {
+                            if (duration.inMilliseconds > 0) {
+                              notifier.seekCommit(duration * v);
                             }
                           },
                         ),
@@ -536,7 +546,12 @@ class _MobileBar extends ConsumerWidget {
               activeColor: cs.onSurface.withValues(alpha: 0.36),
               inactiveColor: cs.onSurface.withValues(alpha: 0.08),
               onChanged: (v) {
-                if (duration.inMilliseconds > 0) notifier.seek(duration * v);
+                if (duration.inMilliseconds > 0)
+                  notifier.seekPreview(duration * v);
+              },
+              onChangeEnd: (v) {
+                if (duration.inMilliseconds > 0)
+                  notifier.seekCommit(duration * v);
               },
             ),
             Padding(

lib/widgets/player_controls.dart

@@ -39,7 +39,14 @@ class PlayerControls extends ConsumerWidget {
               ? null
               : (v) {
                   if (duration.inMilliseconds > 0) {
-                    notifier.seek(duration * v.clamp(0.0, 1.0));
+                    notifier.seekPreview(duration * v.clamp(0.0, 1.0));
+                  }
+                },
+          onChangeEnd: player.currentTrack == null
+              ? null
+              : (v) {
+                  if (duration.inMilliseconds > 0) {
+                    notifier.seekCommit(duration * v.clamp(0.0, 1.0));
                   }
                 },
         ),

linux/xyz.nokarin.aqloss.metainfo.xml

@@ -53,8 +53,9 @@
         <release version="0.2.2" date="2026-05-17">
             <url type="details">https://github.com/nokarin-dev/aqloss/releases/tag/v0.2.2</url>
             <description>
-                <p>Added helpers, fix discord button label overflow, cursor pointer.</p>
+                <p>Added helpers, fix discord button label overflow, cursor pointer, seek throttle, and more.</p>
                 <ul>
+                    <li>Call backend only on drag end to prevent seek throttle</li>
                     <li>All button now should has pointer now</li>
                     <li>Discord button label overflow</li>
                     <li>Added helpers to prevent backend crash</li>