Flutter audio_service与just_audio在iOS17锁屏后播放失败问题咨询

iOS17相关核心变更 #

• 后台音频会话管控升级：iOS17对音频会话的激活时机、权限校验逻辑做了更严格的限制，锁屏状态下系统会优先回收未正确持有会话的应用资源，表现类似Android后台应用被杀死，但触发逻辑和会话绑定状态强相关。
• 低电量模式限制增强：低电量模式下，系统对后台音频的暂停阈值更低，即使应用持有音频会话，也可能被强制暂停，且会话恢复逻辑存在兼容性异常。
• 本地文件后台访问权限微调：若音频文件存储在非默认沙箱路径（如App Group），锁屏后可能出现临时权限丢失，导致播放器无法读取文件触发异常。

具体解决步骤 #

1. 修复PlatformException类型转换异常 #

该异常是just_audio在iOS17下的适配漏洞，原生层抛出的异常未被正确映射为Dart的PlayerException，可通过两种方式处理：

• 兼容异常捕获：在调用play()时同时捕获两种异常类型，统一处理逻辑：

try {
  await audioPlayer.play();
} on PlayerException catch (e) {
  // 原有PlayerException处理逻辑
} on PlatformException catch (e) {
  // 将PlatformException转为PlayerException统一处理
  final playerException = PlayerException(
    message: e.message,
    code: e.code,
    cause: e.details,
  );
  // 执行播放失败后的恢复或提示逻辑
}

• 升级依赖版本：优先升级just_audio到最新稳定版，官方后续版本已针对iOS17修复了异常映射问题。

2. 优化音频会话生命周期管理（核心修复） #

iOS17对音频会话的持有要求更严格，需确保锁屏前后会话状态稳定：

• 提前激活会话：在应用启动或音频服务初始化时就激活会话，不要等到锁屏后触发：

// 在audio_service的onStart回调中执行
await AudioSession.instance.configure(AudioSessionConfiguration.background());
await AudioSession.instance.setActive(true);

• 监听会话中断并主动恢复：添加中断监听，在锁屏导致的暂停后重新激活会话并恢复播放：

AudioSession.instance.interruptionEventStream.listen((event) {
  if (event.type == AudioInterruptionType.pause) {
    // 记录当前播放位置
    currentPosition = await audioPlayer.position;
  }
  if (event.type == AudioInterruptionType.resume) {
    // 重新激活会话并恢复播放
    await AudioSession.instance.setActive(true);
    await audioPlayer.seek(currentPosition);
    await audioPlayer.play();
  }
});

• 配置正确的会话类别：使用playback类别，并确保会话优先级：

final config = AudioSessionConfiguration(
  avAudioSessionCategory: AVAudioSessionCategory.playback,
  avAudioSessionCategoryOptions: AVAudioSessionCategoryOptions.mixWithOthers,
);
await AudioSession.instance.configure(config);

3. 处理低电量模式限制 #

除了提示用户关闭低电量模式，还可通过以下方式降低系统回收概率：

• 确认后台权限配置：在Info.plist中确保添加了音频后台模式：

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

• 精简后台操作：锁屏后暂停无关的网络请求、文件IO等操作，减少系统资源占用。

4. 本地文件访问兼容性优化 #

确保锁屏后音频文件可正常读取：

• 将音频文件存储在App默认沙箱目录（如getApplicationDocumentsDirectory()），避免使用需要额外权限的路径。
• 读取文件时使用绝对路径，避免依赖临时URL或相对路径。

验证建议 #

• 必须在iPhone14/15 Pro的iOS17真机上测试，模拟器的后台行为和真机差异极大。
• 通过Xcode Console工具过滤AVAudioSession相关日志，查看是否有会话被系统强制终止的记录，辅助定位问题。

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