Flutter环境音播放：本地Assets中MP3文件播放问题求助

我最近刚好帮朋友踩过这个坑，用最新的audioplayers插件（注意是复数，现在官方维护的是这个版本）就能轻松搞定本地Assets音频播放，给你一步步捋清楚：

第一步：确认插件版本与Assets配置 #

别再用旧版的audioplayer（单数）了，现在官方主推的是v4.x+版本的audioplayers，先在pubspec.yaml里添加依赖：

dependencies:
  audioplayers: ^4.0.1 # 建议用最新稳定版

然后一定要把Assets路径配置对！比如你的MP3文件放在assets/sounds/click.mp3，那pubspec.yaml里要这么写：

flutter:
  assets:
    - assets/sounds/

注意路径末尾的斜杠，这样才能识别文件夹下的所有音频文件。

第二步：加载并播放Assets音频的正确代码 #

新版本的API和旧版完全不一样，不用再拼复杂的路径字符串，直接用AssetSource就能搞定。给你一个完整的工具类示例：

import 'package:audioplayers/audioplayers.dart';

class SoundPlayer {
  final AudioPlayer _audioPlayer = AudioPlayer();

  // 播放指定Assets路径的音频
  Future<void> playSelectedSound(String assetPath) async {
    try {
      // AssetSource会自动关联assets文件夹，所以路径填相对路径就行
      await _audioPlayer.play(AssetSource(assetPath));
    } catch (e) {
      print('播放出错：$e');
    }
  }

  // 页面销毁时记得释放资源
  void disposePlayer() {
    _audioPlayer.dispose();
  }
}

然后在你的UI里调用，比如做一个音效选择下拉框：

String? selectedSound;
final SoundPlayer _soundPlayer = SoundPlayer();

// ...省略其他代码

DropdownButton<String>(
  value: selectedSound,
  hint: const Text('选择音效'),
  items: ['click.mp3', 'alert.mp3', 'success.mp3']
      .map((sound) => DropdownMenuItem(
            value: sound,
            child: Text(sound),
          ))
      .toList(),
  onChanged: (value) {
    if (value != null) {
      setState(() {
        selectedSound = value;
      });
      // 调用播放方法，路径是相对于assets文件夹的
      _soundPlayer.playSelectedSound('sounds/$selectedSound');
    }
  },
)

第三步：常见问题排查 #

如果还是播放失败，检查这几个关键点：

• 确认Assets文件路径完全匹配，比如assets/sounds/click.mp3对应代码里的sounds/click.mp3（AssetSource会自动加上assets/前缀）
• 配置完pubspec.yaml后，一定要重启应用，热重载可能不会刷新Assets配置
• 文件名大小写要一致！Flutter对Assets路径的大小写是敏感的
• 安卓端如果有问题，检查android/app/src/main/AndroidManifest.xml是否有音频权限（v4.x版本一般默认配置了，不用额外加）

为什么旧帖子的方法没用？ #

那些1-2年前的帖子大多针对的是v0.x或v1.x的旧版插件，新版本不仅把插件名称从单数改成了复数audioplayers，API也做了大幅重构——比如用AssetSource替代了旧的AudioPlayer.asset()方法，按旧方法跑肯定会报错。

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