Flutter中audioplayers插件后台无法播放音频问题咨询

audioplayers本身基础功能不直接支持后台音频播放，你遇到的前台正常、后台无声的情况，本质是移动平台的后台权限与音频会话配置限制导致的，并非插件播放API本身的问题。以下是针对Android和iOS的具体解决步骤：

Android 端配置 #

• 在AndroidManifest.xml中添加必要权限：

  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <uses-permission android:name="android.permission.WAKE_LOCK" />
  

• 在<application>标签内注册音频前台服务：

  <service android:name="xyz.luan.audioplayers.AudioService"
           android:foregroundServiceType="mediaPlayback" />
  

• 播放前需将音频服务设为前台状态，避免被系统回收。可通过插件的PlayerOptions配置或配合原生代码实现，确保后台播放时服务不被终止。

iOS 端配置 #

• 在Info.plist中添加后台音频模式：

  <key>UIBackgroundModes</key>
  <array>
      <string>audio</string>
  </array>
  

• 播放前配置音频会话为播放类别：

  import 'package:audioplayers/audioplayers.dart';
  
  Future<void> setupAudioSession() async {
    final audioSession = await AudioSession.instance;
    await audioSession.configure(const AudioSessionConfiguration(
      avAudioSessionCategory: AVAudioSessionCategory.playback,
      avAudioSessionCategoryOptions: AVAudioSessionCategoryOptions.mixWithOthers,
    ));
  }
  

  调用await player.play(AssetSource(audioFilePlath));前先执行await setupAudioSession()。

关键注意事项 #

• 确保player实例为全局对象，避免页面销毁时被回收，导致后台播放中断。
• 部分Android机型需手动在系统设置中开启应用的「后台运行」「后台弹出」权限。
• 优先使用真机测试，部分模拟器对后台音频支持存在兼容性问题。

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