求助：iOS端Ionic Capacitor应用播放音频不中断其他应用的方案

问题根源 #

iOS默认采用独占式音频会话策略，当你的Ionic Capacitor应用启动音频播放时，会抢占音频焦点，导致后台运行的Spotify等应用停止播放。要解决这个问题，必须显式配置iOS音频会话为混合模式。

具体实现方案 #

方案一：使用Capacitor社区音频会话插件（推荐） #

通过专门的插件快速配置音频会话，无需手动修改原生代码：

1. 安装插件（终端执行）：

npm install @capacitor-community/audio-session
npx cap sync

2. 在应用初始化阶段配置会话（比如app.component.ts中）：

import { AudioSession } from '@capacitor-community/audio-session';

async initAudioSession() {
  try {
    await AudioSession.initialize();
    // 设置播放类别并开启混合选项
    await AudioSession.setCategory({
      category: 'playback',
      mode: 'default',
      options: ['mixWithOthers']
    });
  } catch (err) {
    console.error('音频会话配置失败:', err);
  }
}

// 在应用启动时调用
async initializeApp() {
  await this.initAudioSession();
  // 其他初始化逻辑
}

方案二：手动修改iOS原生代码 #

若不想依赖第三方插件，可直接修改iOS项目的AppDelegate.swift：

import AVFoundation

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let audioSession = AVAudioSession.sharedInstance()
    do {
        // 设置播放类别并允许与其他音频混合
        try audioSession.setCategory(.playback, mode: .default, options: [.mixWithOthers])
        try audioSession.setActive(true)
    } catch {
        print("音频会话设置失败: \(error)")
    }
    return true
}

修改完成后，重新编译iOS项目即可生效。

关键注意事项 #

• 无论使用HTMLAudioElement还是capacitor-community/native-audio，都要确保音频会话在播放前完成配置
• 测试时确认iOS设备已开启"后台应用刷新"和音频后台播放权限
• 若使用native-audio插件，无需额外修改插件配置，会自动遵循已设置的音频会话策略

验证步骤 #

1. 启动Spotify并开始后台播放音乐
2. 打开你的Ionic答题应用，触发音频播放
3. 确认Spotify音乐持续播放，同时应用音频正常输出

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