You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter项目播放音频触发AudioPlayerException问题求助

排查Flutter Web端AudioPlayers格式错误问题

针对你遇到的MEDIA_ELEMENT_ERROR: Format error (Code: 4)错误,按以下步骤逐一排查:

  • 检查音频文件本身
    先确认number_one_sound.mp3文件是否正常:用本地播放器(比如VLC、Windows Media Player)打开测试,看能否正常播放。如果文件损坏或采用了Web不兼容的编码(比如非标准比特率、采样率),会触发格式错误。可以重新导出符合Web标准的mp3文件(推荐比特率128-320kbps,采样率44.1kHz)。

  • 验证pubspec.yaml资源配置
    确保资源路径配置正确,yaml对缩进要求严格,示例如下:

    flutter:
      assets:
        - sounds/numbers/number_one_sound.mp3
    

    配置完成后执行flutter pub get,然后重启Flutter Web服务,避免资源未刷新。

  • 检查代码中的路径匹配
    Web端文件路径区分大小写,确认代码中AssetSource的路径和pubspec里的完全一致,包括大小写:

    AudioPlayer().play(AssetSource('sounds/numbers/number_one_sound.mp3'));
    
  • Web端环境清理与测试

    • 清空浏览器缓存,避免旧资源干扰;
    • 确保通过flutter run -d chrome启动服务,不要直接打开build/web下的HTML文件(Web音频需要服务器环境支持);
    • 测试其他已知正常的mp3文件,替换到相同路径下播放,排查是否是特定文件的问题。

内容的提问来源于stack exchange,提问作者Hazem Bakr

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.07 19:55:01