Flutter AudioPlayer重复播放同一资源音效问题求助

当你设置ReleaseMode.stop后，连续点击播放同一音效仍需等待前一个结束，本质是因为播放器在播放同一资源时，不会自动重置状态并重新触发播放。要实现每次点击都立即终止当前播放并启动新的播放，核心是每次播放前强制停止当前播放，再重新触发播放操作，不管当前播放的是不是同一资源。

针对audioplayers包的解决方案 #

如果你用的是常用的audioplayers库，直接在播放函数中先调用stop()，再执行播放即可：

import 'package:audioplayers/audioplayers.dart';

// 全局或类内初始化播放器实例
final AudioPlayer _audioPlayer = AudioPlayer();

// 播放音效的函数
Future<void> playClickSound() async {
  // 先停止当前所有播放
  await _audioPlayer.stop();
  // 重新播放目标音效（这里以本地资源为例）
  await _audioPlayer.play(AssetSource('assets/sounds/click.mp3'));
}

// 按钮调用示例
ElevatedButton(
  onPressed: playClickSound,
  child: const Text('点击播放'),
)

针对just_audio包的解决方案 #

如果使用的是just_audio库，逻辑类似，需要先停止播放，再重新设置音频源（或seek到开头）后播放：

import 'package:just_audio/just_audio.dart';

final AudioPlayer _audioPlayer = AudioPlayer();

// 初始化时设置ReleaseMode（可选，确保播放结束后释放资源）
void initAudioPlayer() {
  _audioPlayer.setReleaseMode(ReleaseMode.stop);
}

Future<void> playClickSound() async {
  await _audioPlayer.stop();
  // 重新设置音频源（同一资源也需要重新设置以重置状态）
  await _audioPlayer.setAsset('assets/sounds/click.mp3');
  await _audioPlayer.play();
}

为什么原来的方式无效？ #

当播放同一音频资源时，播放器会认为资源已加载且可能处于播放/暂停状态，直接调用play()不会触发重新播放。通过先调用stop()，可以强制终止当前播放并重置播放器状态，之后再执行播放操作就能确保每次点击都能立即响应。

额外注意事项 #

• 可以添加try-catch块捕获播放错误，避免单次播放失败导致后续点击无响应；
• 若频繁播放短音效，复用同一个播放器实例即可，无需每次创建新实例，避免性能开销。

内容的提问来源于stack exchange，提问作者Anxo Gómez