后台连续播放 + MediaItem + 播放状态 + 实时进度 + 系统 seek + seek 后继续实时更新均已正常达成目标

lib/main.dart

@@ -52,6 +52,15 @@ void main() async {
   // ⭐ 创建 Handler（AudioService 稍后初始化）
   _audioHandler = AudioPlayerHandler();
 
+  // ⭐ 注册切歌回调：当歌曲切换时，立即更新通知
+  AudioService().setOnSongChanged((song) {
+    _audioHandler!.updateNotification(
+      id: song.id,
+      title: song.title,
+      artist: song.artist,
+    );
+  });
+
   runApp(
     MultiProvider(
       providers: [

lib/services/audio_player_handler.dart

@@ -4,42 +4,131 @@ import 'package:flutter/foundation.dart';
 import 'package:audio_service/audio_service.dart' as audio_service;
 import '../audio/player_controller.dart';
 import '../audio/playback_state_manager.dart';
-import '../services/audio_service.dart'; // 你自己的业务 AudioService
+import '../services/audio_service.dart';
 
 class AudioPlayerHandler extends audio_service.BaseAudioHandler {
   final PlayerController _player = PlayerController();
   final PlaybackStateManager _state = PlaybackStateManager();
 
+  String? _currentId;
+  String? _currentTitle;
+  String? _currentArtist;
+
+  // ⭐ 唯一的位置变量
+  Duration _currentPosition = Duration.zero;
+  DateTime _lastPublishTime = DateTime.now();
+  static const Duration _publishInterval = Duration(milliseconds: 500);
+
   AudioPlayerHandler() {
-    // ---- 监听播放状态变化，同步到通知栏 ----
     _player.playingStream.listen((playing) {
       _state.updatePlaying(playing);
       _publishState();
     });
 
+    // ⭐ 位置更新：直接赋值给 _currentPosition
     _player.positionStream.listen((position) {
+      _currentPosition = position;
       _state.updatePosition(position);
-      final current = playbackState.value;
-      playbackState.add(audio_service.PlaybackState(
-        controls: current.controls,
-        processingState: current.processingState,
-        playing: current.playing,
-        androidCompactActionIndices: current.androidCompactActionIndices,
-        updateTime: DateTime.now(),
-      ));
+
+      final now = DateTime.now();
+      if (now.difference(_lastPublishTime) >= _publishInterval) {
+        _lastPublishTime = now;
+        _updateMediaItemPosition(position);
+        _publishStateOnly();
+      }
     });
 
     _player.durationStream.listen((duration) {
       _state.updateDuration(duration);
+      if (_currentId != null && _currentTitle != null) {
+        _updateMediaItem(
+          id: _currentId!,
+          title: _currentTitle!,
+          artist: _currentArtist!,
+          duration: duration,
+        );
+      }
       _publishState();
     });
+  }
 
-    // ⭐ 已删除 completed 监听，交由 AudioService 统一处理
-    // _player.completedStream.listen((_) { ... });
+  void _updateMediaItemPosition(Duration position) {
+    final currentMediaItem = mediaItem.value;
+    if (currentMediaItem != null) {
+      mediaItem.add(audio_service.MediaItem(
+        id: currentMediaItem.id,
+        title: currentMediaItem.title,
+        artist: currentMediaItem.artist,
+        duration: currentMediaItem.duration,
+        extras: {
+          'position': position.inMilliseconds,
+          ...?currentMediaItem.extras,
+        },
+      ));
+    }
   }
 
   void _publishState() {
-    playbackState.add(_state.playbackState);
+    final state = _state.playbackState;
+    playbackState.add(audio_service.PlaybackState(
+      controls: state.controls,
+      processingState: state.processingState,
+      playing: state.playing,
+      androidCompactActionIndices: state.androidCompactActionIndices,
+      updateTime: DateTime.now(),
+    ));
+  }
+
+  void _publishStateOnly() {
+    final current = playbackState.value;
+
+    debugPrint(
+      '📡 [publishStateOnly] position=$_currentPosition, playing=${current.playing}',
+    );
+
+    playbackState.add(
+      audio_service.PlaybackState(
+        controls: current.controls.isNotEmpty
+            ? current.controls
+            : _state.playbackState.controls,
+        processingState: _state.playbackState.processingState,
+        playing: current.playing,
+        androidCompactActionIndices: current.androidCompactActionIndices,
+
+        // ⭐ 声明支持 seek
+        systemActions: const {
+          audio_service.MediaAction.seek,
+        },
+
+        updatePosition: _currentPosition,
+        updateTime: DateTime.now(),
+      ),
+    );
+  }
+
+  void _updateMediaItem({
+    required String id,
+    required String title,
+    required String artist,
+    Duration? duration,
+  }) {
+    _currentId = id;
+    _currentTitle = title;
+    _currentArtist = artist;
+    final position = _player.position;
+
+    debugPrint(
+        '📢 [handler] updateMediaItem: $title - $artist (position=${position.inSeconds}s)');
+
+    mediaItem.add(audio_service.MediaItem(
+      id: id,
+      title: title,
+      artist: artist,
+      duration: duration ?? _player.duration,
+      extras: {
+        'position': position.inMilliseconds,
+      },
+    ));
   }
 
   void updateNotification({
@@ -47,38 +136,38 @@ class AudioPlayerHandler extends audio_service.BaseAudioHandler {
     required String title,
     required String artist,
   }) {
-    debugPrint('📢 [handler] updateNotification: $title');
-    mediaItem.add(audio_service.MediaItem(
-      id: id,
-      title: title,
-      artist: artist,
-      duration: _player.duration,
-    ));
+    _updateMediaItem(id: id, title: title, artist: artist);
+    _publishState();
   }
 
-  // ---- 系统控制命令 ----
   @override
   Future<void> play() async {
     debugPrint('▶️ [handler] play() called');
     _player.play();
+    _publishState();
   }
 
   @override
   Future<void> pause() async {
     debugPrint('⏸️ [handler] pause() called');
     _player.pause();
+    _publishState();
   }
 
   @override
   Future<void> stop() async {
     debugPrint('⏹️ [handler] stop() called');
     _player.stop();
+    _publishState();
   }
 
   @override
   Future<void> seek(Duration position) async {
     debugPrint('⏩ [handler] seek() called: $position');
-    _player.seek(position);
+    await _player.seek(position);
+    _currentPosition = position;
+    _updateMediaItemPosition(position);
+    _publishStateOnly();
   }
 
   @override
@@ -113,7 +202,6 @@ class AudioPlayerHandler extends audio_service.BaseAudioHandler {
         }
         break;
       default:
-        // 其他按钮 fallback
         if (_player.isPlaying) {
           await pause();
         } else {

lib/services/audio_service.dart

@@ -51,6 +51,9 @@ class AudioService extends ChangeNotifier {
   // ⭐ 防重入标志
   bool _handlingCompletion = false;
 
+  // ⭐ 歌曲切换回调（用于通知 Handler 更新 MediaItem）
+  void Function(Song)? _onSongChanged;
+
   // ---- Getter（高频字段不走 ChangeNotifier） ----
   Song? get currentSong => _currentSong;
   bool get isPlaying => _isPlaying;
@@ -75,6 +78,11 @@ class AudioService extends ChangeNotifier {
     }
   }
 
+  // ---- 注册歌曲切换回调 ----
+  void setOnSongChanged(void Function(Song) callback) {
+    _onSongChanged = callback;
+  }
+
   // ---- 切换播放模式 ----
   void togglePlayMode() {
     switch (_playMode) {
@@ -138,6 +146,9 @@ class AudioService extends ChangeNotifier {
     final song = _queue[_currentIndex];
     _currentSong = song;
 
+    // ⭐ 切歌时触发回调（通知 Handler 更新 MediaItem）
+    _onSongChanged?.call(song);
+
     // ⭐ 重置进度（用 ValueNotifier）
     positionNotifier.value = Duration.zero;
     durationNotifier.value = Duration.zero;
@@ -266,7 +277,7 @@ class AudioService extends ChangeNotifier {
       }),
     );
 
-    // ⭐ 唯一监听 completed 的地方
+    // ⭐ 唯一监听 completed 的地方（带防重入）
     _subscriptions.add(
       player.stream.completed.listen((_) {
         _onPlaybackCompleted();
@@ -282,7 +293,7 @@ class AudioService extends ChangeNotifier {
     _subscriptions.clear();
   }
 
-  // ⭐ 防重入
+  // ⭐ 防重入的完成事件处理
   void _onPlaybackCompleted() {
     if (_handlingCompletion) {
       debugPrint('⚠️ [service] completed ignored: already handling');

pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 1.0.2+1
+version: 1.0.3+1
 
 environment:
   sdk: ^3.0.0
@@ -36,7 +36,7 @@ dependencies:
   provider: ^6.1.2
   dio: ^5.4.0         # HTTP 客户端
   xml: ^6.5.0
-  audio_service: ^0.18.13
+  audio_service: ^0.18.19
   audio_session: ^0.1.21
   permission_handler: ^11.3.1
   flutter_cache_manager: ^3.3.1