Flutter中just_audio音频无法运行问题求助

你的代码存在几个关键问题，直接导致无法播放音频，修正方案如下：

核心问题分析 #

• 参数类型错误：setAudioSource需要传入AudioSource类型对象（比如AssetSource），不能直接传字符串路径
• 异步调用顺序错误：setAudioSource是异步方法，必须等待执行完成后才能调用play，且play方法不需要传入setAudioSource的返回值
• 资源管理问题：每次点击都创建新的AudioPlayer实例，容易造成资源泄漏

修正后的代码示例 #

基础修复（单次播放场景） #

onTap: () async {
  final player = AudioPlayer();
  try {
    // 用AssetSource包装资源路径，等待音频源初始化完成
    await player.setAudioSource(AssetSource('sound.wav'));
    // 初始化完成后调用play
    player.play();
    // 可选：播放完成后自动释放播放器资源
    player.playerStateStream.listen((state) {
      if (state.processingState == ProcessingState.completed) {
        player.dispose();
      }
    });
  } catch (e) {
    // 捕获加载或播放失败的异常
    print('音频播放失败：$e');
  }
}

优化方案（多次播放场景） #

如果需要重复播放，建议提前初始化播放器，避免重复创建资源：

// 在State类中定义全局播放器实例
late AudioPlayer _player;

@override
void initState() {
  super.initState();
  _player = AudioPlayer();
  // 提前加载音频源（可选，提升首次播放速度）
  _player.setAudioSource(AssetSource('sound.wav'));
}

@override
void dispose() {
  // 页面销毁时必须释放播放器资源
  _player.dispose();
  super.dispose();
}

// 点击事件处理
onTap: () async {
  try {
    // 如果音频已播放完成，需要先回到开头再播放
    if (_player.playerState.value.processingState == ProcessingState.completed) {
      await _player.seek(Duration.zero);
    }
    _player.play();
  } catch (e) {
    print('播放失败：$e');
  }
}

额外检查项 #

• 确认pubspec.yaml中资源配置格式正确（注意缩进）：

  flutter:
    assets:
      - assets/sound.wav
  

• 确保音频文件的路径、文件名和代码中完全匹配（区分大小写）
• 检查设备是否处于静音状态，或应用是否拥有音频播放权限

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