Flutter导航APP中flutter_tts的iOS音频闪避（Ducking）失效：背景音乐播放后无法恢复

我太懂你这种烦躁了——播个导航指令，背景里的Spotify直接停摆，说完也不自动续上，体验感拉满的差！问题出在咱们没给iOS的音频会话做正确配置，flutter_tts默认会抢占全部音频焦点，自然就把其他APP的音乐顶没了。咱们来一步步把这个问题解决掉：

核心问题：缺失iOS音频会话的混音/闪避配置 #

iOS对音频会话的管理特别严格，你的代码里_initAudioSession()只设置了TTS的基础参数（语言、语速这些），完全没碰音频会话的权限规则，导致系统默认让你的TTS抢占所有音频资源，直接停掉其他APP的音乐。

具体解决步骤 #

咱们要给iOS单独配置音频会话，允许和其他APP的音频混音，并且启用“闪避”模式（让背景音降低音量，而不是完全停止，TTS结束后自动恢复）。

1. 修改_initAudioSession()方法

在初始化TTS的时候，针对iOS添加音频会话的配置代码：

Future<void> _initAudioSession() async {
  await _flutterTts.setLanguage(isEnglish() ? "en-US" : "nl-NL");
  await _flutterTts.setSpeechRate(0.5);
  await _flutterTts.setVolume(1.0);
  await _flutterTts.setPitch(1.0);

  // 重点：iOS专属音频会话配置，启用混音+闪避
  if (Platform.isIOS) {
    try {
      await _flutterTts.setIosAudioCategory(
        IosTextToSpeechAudioCategory.playback,
        [
          IosTextToSpeechAudioCategoryOptions.mixWithOthers,
          IosTextToSpeechAudioCategoryOptions.duckOthers,
        ],
      );
      print('✅ iOS音频会话已配置为混音+闪避模式');
    } catch (e) {
      print('❌ 配置iOS音频会话失败: $e');
    }
  }
}

我给你解释下这几个参数的作用：

• playback：告诉系统你的APP是播放音频的场景，适配TTS导航指令的需求
• mixWithOthers：允许其他APP的音频继续播放，不会被直接切断
• duckOthers：触发“闪避”效果——TTS播放时，背景音自动降低音量，TTS结束后自动恢复原音量

2. 确保flutter_tts版本足够新

旧版本的flutter_tts可能不支持上面的枚举参数（比如IosTextToSpeechAudioCategory），如果你的项目里用的是老版本，要么升级到最新stable版（在pubspec.yaml里把flutter_tts的版本号改成^3.0.0以上，具体看pub.dev的最新版），要么用字符串参数兼容旧版：

// 旧版flutter_tts兼容写法
await _flutterTts.setIosAudioCategory(
  'playback',
  ['mixWithOthers', 'duckOthers'],
);

3. 验证初始化时机

确保_initAudioSession()在APP启动时就调用（比如在initState()里），而不是等到要播指令才初始化，这样音频会话的配置才能提前生效。

额外注意事项 #

• 你的iOS代码分支是直接调用_flutterTts.speak()，这个没问题，配置好音频会话后，直接用这个方法就能触发闪避效果
• 不需要额外写代码恢复背景音——配置了duckOthers后，iOS系统会自动在TTS结束后把背景音的音量拉回去
• 如果还是有问题，检查下你的APP有没有申请不必要的音频权限（比如麦克风权限），不过TTS播放不需要麦克风权限，一般不会有影响

按照上面的步骤改完，再拿iOS真机测试下——播放Spotify音乐，触发导航指令，应该就能看到背景音降低，指令说完后自动恢复的效果了！

内容来源于stack exchange