Capacitor iOS构建应用音频播放权限报错问题求助

你遇到的RBSServiceErrorDomain Code=1错误，本质是系统尝试获取WebKit专属的后台运行断言权限失败——这两个权限（com.apple.runningboard.assertions.webkit和com.apple.multitasking.systemappassertions）是苹果留给系统应用（比如Safari）或WebKit内部使用的，第三方Capacitor应用根本无法获取。

虽然WAV音效能正常播放，但系统会因为音频会话配置不明确，默认尝试申请后台音频断言，从而抛出这个非致命错误。

1. 配置iOS原生音频会话 #

在iOS项目的AppDelegate.swift中添加音频会话初始化代码，明确设置音频类别为playback，让系统正确识别音频用途，避免不必要的断言请求：

import AVFoundation

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 配置音频会话
    do {
        try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default)
        try AVAudioSession.sharedInstance().setActive(true)
    } catch {
        print("音频会话配置失败: \(error)")
    }
    return true
}

2. 优化Web Audio上下文的激活逻辑 #

iOS要求音频上下文必须由用户交互触发激活，且可能因后台挂起，所以在播放时检查并恢复上下文状态：
修改你的playSound函数：

function playSound() {
    if (!soundBuffer || !audioContext) return;
    
    // 恢复挂起的音频上下文
    if (audioContext.state === 'suspended') {
        audioContext.resume();
    }
    
    const source = audioContext.createBufferSource();
    source.buffer = soundBuffer;
    source.connect(audioContext.destination);
    source.start(0);
}

3. 确认Info.plist的后台音频配置 #

确保Info.plist中已正确添加后台音频模式，避免系统误判音频用途：

<key>UIBackgroundModes</key>
<array>
    <string>audio</string>
    <!-- 保留你需要的其他后台模式 -->
</array>

完成以上配置后，系统会停止尝试获取不属于第三方应用的WebKit断言权限，错误会消失。如果只是前台播放音效，这个错误原本也不会影响核心功能，但配置后能消除调试器的干扰日志。

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