feat(playback): 网络切换后自动重连当前歌曲

mpv 的 HTTP 长连接不会跟随网络迁移:换 Wi-Fi / Wi-Fi<->移动数据
会换掉出口 IP,旧连接失效但不一定报错,表现为进度停住、一直缓冲。

- 新增 NetworkWatcher:每 10s 枚举 IPv4 接口,签名变化即视为网络切换
  (不依赖插件和额外权限,也能覆盖"同类型网络换 AP"的情况)
- AudioService 收到变化后 3s 去抖,然后强制重连当前歌曲并 seek 回原位置
  (force 参数跳过 2 分钟节流,因为这是明确的外部事件)

真机验证(公网链路 + 移动数据):
  21:43:23.123  检测到网络变化
  21:43:26.124  主动重连(3s 去抖)
  21:43:26.289  自动恢复完成(165ms)
  随后 position 35.5s -> 41.7s 正常推进
This commit is contained in:
2026-10-23 21:44:55 +08:00
parent 937bcdd63d
commit b517c75cdd
2 changed files with 102 additions and 8 deletions
+34 -8
View File
@@ -7,6 +7,7 @@ import 'package:flutter/material.dart';
import 'package:media_kit/media_kit.dart' as media_kit;
import 'package:path_provider/path_provider.dart';
import 'playback_service.dart';
import 'network_watcher.dart';
import '../metadata/metadata_service.dart';
import '../database/song_database.dart';
import '../utils/artwork_helper.dart';
@@ -91,6 +92,9 @@ class AudioService extends ChangeNotifier {
/// 最近一次进入 buffering 的时间(用于卡死判定,不能用计时器重置)
DateTime? _lastBufferingAt;
/// 网络切换去抖
Timer? _networkDebounce;
/// 进度看门狗:某些卡死不会触发 buffering 事件(例如 CDN 半开连接),
/// 用「播放中进度长时间不动」兜底。
Timer? _progressTimer;
@@ -436,10 +440,10 @@ class AudioService extends ChangeNotifier {
}
}
/// 缓冲卡死自愈:重开当前歌曲并 seek 回原位置。 ///
/// 触发条件:mpv 的 buffering 持续为 true 超过 [_stallThreshold]。
/// 两次自动恢复之间至少间隔 2 分钟,避免源站长时间不可用时反复重连。
Future<void> _recoverFromStall() async {
/// 卡死/网络切换自愈:重开当前歌曲并 seek 回原位置。
///
/// [force] 为 true 时跳过节流(用于网络切换这种明确的外部事件)。
Future<void> _recoverFromStall({bool force = false}) async {
if (_isChangingTrack) return;
final song = _currentSong;
@@ -448,7 +452,8 @@ class AudioService extends ChangeNotifier {
if (url == null || url.isEmpty) return;
final now = DateTime.now();
if (_lastStallRecoveryAt != null &&
if (!force &&
_lastStallRecoveryAt != null &&
now.difference(_lastStallRecoveryAt!) < const Duration(minutes: 2)) {
debugPrint('🩺 [AudioService] 仍在缓冲,但 2 分钟内已恢复过,交给用户手动切歌');
return;
@@ -456,8 +461,7 @@ class AudioService extends ChangeNotifier {
_lastStallRecoveryAt = now;
final resumeAt = positionNotifier.value;
debugPrint(
'🩺 [AudioService] 缓冲超过 ${_stallThreshold.inSeconds}s,尝试重连:${song.title}');
debugPrint('🩺 [AudioService] 尝试重连:${song.title}(从 ${resumeAt.inSeconds}s 继续)');
try {
await _playWithHeaders(url);
if (resumeAt > Duration.zero) {
@@ -472,7 +476,22 @@ class AudioService extends ChangeNotifier {
}
}
Future<void> _waitForPlaybackStarted() async { final player = PlaybackService().player;
/// 网络切换(Wi-Fi 换 AP、Wi-Fi <-> 移动数据)后的主动重连。
///
/// 长连接会随出口 IP 变化失效,mpv 不保证会自己重连。
/// 这里做 3s 去抖:切换瞬间往往会连续触发多次网络接口变化。
void _onNetworkChanged() {
_networkDebounce?.cancel();
_networkDebounce = Timer(const Duration(seconds: 3), () {
if (_currentSong == null) return;
if (_isChangingTrack) return;
debugPrint('🌐 [AudioService] 网络已切换,主动重连当前歌曲');
_recoverFromStall(force: true);
});
}
Future<void> _waitForPlaybackStarted() async {
final player = PlaybackService().player;
if (player.state.playing) {
_hasStartedCurrentPlayback = true;
@@ -847,6 +866,10 @@ class AudioService extends ChangeNotifier {
(_) => _checkPlaybackProgress(),
);
// 网络变化监听:换 Wi-Fi / 切移动数据后长连接会失效,主动重连
NetworkWatcher().onChanged = _onNetworkChanged;
NetworkWatcher().start();
// ⭐ 完整生命周期校验的 completed 监听
_subscriptions.add(
player.stream.completed.listen((_) {
@@ -1070,6 +1093,9 @@ class AudioService extends ChangeNotifier {
// 先保存再清理
_progressTimer?.cancel();
_progressTimer = null;
_networkDebounce?.cancel();
_networkDebounce = null;
NetworkWatcher().stop();
savePlaybackState();
_stopListening();
positionNotifier.dispose();