You need to enable JavaScript to run this app. Flutter应用在Chrome端运行无法播放音频,出现NotSupportedError如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Flutter应用在Chrome端运行无法播放音频,出现NotSupportedError如何解决

问题原因
  • 资源配置错误:未在pubspec.yaml中正确声明音频资源路径,导致应用无法找到对应的音频文件
  • 代码写法不兼容:旧版AudioCache类对Flutter Web的支持存在缺陷,且直接传入字符串路径的写法不符合新版audioplayers的资源加载规范
  • 音频格式兼容问题:当前使用的wav文件编码不被Chrome支持,也会触发该报错
  • 路径规则不匹配:Flutter Web端的资源加载路径和移动端存在差异,错误的路径写法会导致资源404
可行解决方案
  • 第一步:配置pubspec.yaml资源声明
    找到项目根目录下的pubspec.yaml文件,在flutter配置块下添加音频资源的路径声明,注意缩进严格匹配,示例如下:
flutter:
  uses-material-design: true
  # 新增assets配置,路径和你实际存放音频的路径完全一致
  assets:
    - assets/assets_note1.wav

如果你的音频是放在子文件夹比如assets/audio/下,就改成- assets/audio/assets_note1.wav即可。

  • 第二步:修正音频播放代码
    新版audioplayers已经废弃了AudioCache类,统一使用AudioPlayer配合资源类型类加载音频,同时建议不要每次点击都新建播放器实例,优化性能。修正后的完整代码如下:
import 'package:flutter/material.dart';
import 'package:audioplayers/audioplayers.dart';

// 全局初始化播放器实例
final AudioPlayer audioPlayer = AudioPlayer();

void main() {
  runApp(
    MaterialApp(
      home: Scaffold(
        body: SafeArea(
          child: Center(
            child: TextButton(
              onPressed: () async {
                // 使用AssetSource加载assets资源,路径为assets文件夹下的相对路径
                // 比如你音频实际路径是assets/assets_note1.wav,这里就传'assets_note1.wav'
                await audioPlayer.play(AssetSource('assets_note1.wav'));
              },
              child: const Text('Click Me'),
            ),
          ),
        ),
      ),
    ),
  );
}
  • 第三步:排查音频兼容问题
    如果修改完上面两步还是报错,先确认你的assets_note1.wav文件没有损坏,也可以转成mp3格式再尝试,mp3在Chrome端的兼容性更好。

  • 第四步:清理缓存重新运行
    执行以下命令清理项目缓存,再重新启动Chrome端运行:

flutter clean
flutter pub get
flutter run -d chrome

内容的提问来源于stack exchange,提问作者Nishani Kasineshan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 03:12:05