基于just_audio的有声书APP全屏与迷你播放器无缝续播问题咨询

核心优化：用单例播放器替代双实例 #

不要为全屏和迷你播放器分别创建独立的播放器实例，改用全局单例模式维护同一个播放器对象——这样既避免了双实例同时播放的问题，也不用在关闭全屏时销毁播放器（也就不会丢失实时播放位置）。

实现单例播放器的示例代码：

class AudioPlayerManager {
  static final AudioPlayer _player = AudioPlayer();
  static AudioPlayer get instance => _player;

  // 私有构造函数，禁止外部实例化
  AudioPlayerManager._();
}

全屏和迷你播放器页面都直接使用AudioPlayerManager.instance来控制播放、获取状态。

避免不必要的播放器销毁 #

关闭全屏页面时，不要调用player.dispose()——因为dispose会彻底销毁播放器实例，导致所有状态丢失。如果全屏页面是通过Navigator.push打开的，执行Navigator.pop时只需隐藏全屏UI即可，播放器实例由单例管理器继续维护，迷你播放器直接复用这个实例的状态。

精准续播的实现 #

1. 实时状态同步：迷你播放器无需从shared_preferences读取位置，直接从单例播放器获取player.position（这是精确到毫秒的Duration类型），初始化时直接使用该位置即可无缝续播。
2. 持久化精准位置：只有在APP退出、切换书籍或播放器暂停时，才将player.position.inMilliseconds（毫秒级数值）存入shared_preferences，而不是截断的秒数。示例代码：

// 保存播放位置
Future<void> saveCurrentPosition(String bookId) async {
  final prefs = await SharedPreferences.getInstance();
  await prefs.setInt('${bookId}_position', AudioPlayerManager.instance.position.inMilliseconds);
}

// 恢复播放位置（仅在APP重启或切换回该书时调用）
Future<void> restorePosition(String bookId) async {
  final prefs = await SharedPreferences.getInstance();
  final positionMs = prefs.getInt('${bookId}_position');
  if (positionMs != null) {
    await AudioPlayerManager.instance.seek(Duration(milliseconds: positionMs));
  }
}

状态管理辅助 #

可以用Provider、Riverpod这类状态管理工具，将播放器的核心状态（当前播放书籍、播放状态、实时位置）封装成全局状态。全屏和迷你播放器页面监听状态变化，自动同步UI显示，避免手动传递状态的繁琐。

注意事项 #

• 仅在APP完全退出时（比如应用进入后台且长时间未活跃），才调用AudioPlayerManager.instance.dispose()销毁播放器，避免资源泄漏。
• 监听播放器的positionStream，实时更新迷你播放器的进度条显示，保证UI和播放状态一致。

内容的提问来源于stack exchange，提问作者Constantine1337