Flutter AssetsAudioPlayer切换曲目时多音频同时播放问题修复

API 探路者

2026-6-13

问题解决方案：AssetsAudioPlayer切换曲目时多音频同时播放

核心问题在于每次切换曲目时未终止当前运行的音频播放器实例，导致多个AssetsAudioPlayer实例同时播放音频。以下是具体修复方案：

1. 使用全局单例播放器实例

不要每次播放都新建AssetsAudioPlayer对象，在你的音频管理类中声明全局唯一实例：

// 在类内部声明全局播放器实例
final AssetsAudioPlayer _audioPlayer = AssetsAudioPlayer();

2. 修改`openPlayer`方法逻辑

在打开新音频前，先停止当前正在播放的音频：

Future<void> openPlayer(String audioPath) async {
  // 先停止当前播放的音频（如果有的话）
  await _audioPlayer.stop();
  
  // 打开新音频资源
  await _audioPlayer.open(
    Audio(audioPath),
    autoStart: true, // 根据需求设置是否自动播放
    showNotification: true, // 可选：开启通知栏控制
  );
}

3. 进阶：使用播放列表管理曲目

如果是多曲目场景，推荐直接使用Playlist管理，切换时无需重复创建实例：

// 初始化播放列表
await _audioPlayer.open(
  Playlist(audios: [
    Audio('assets/audio1.mp3'),
    Audio('assets/audio2.mp3'),
  ]),
  autoStart: false,
);

// 切换到指定曲目（比如第二首）
await _audioPlayer.playlistPlayAtIndex(1);

// 切换上/下一首
await _audioPlayer.next();
await _audioPlayer.previous();