iOS Safari扩展真机无法播放音频/语音（OSStatus错误2003329396）

问题核心 #

iOS Safari App Extension运行在Safari的进程沙箱内，原生音频相关API（包括AVSpeechSynthesizer、AVAudioPlayer）的访问权限被严格限制——模拟器沙箱限制更宽松所以能正常运行，真机则因权限拦截触发报错。

解决方案 #

1. 委托主应用处理音频播放/语音合成

这是最可靠的方案，利用主应用的完整权限执行音频操作：

• 步骤1：配置App Group
  在主应用和扩展的Xcode目标中，添加同一个App Group（在Signing & Capabilities面板添加App Groups，创建或选择已有组）。

• 步骤2：扩展中触发主应用执行朗读
  扩展通过共享UserDefaults传递文本，并唤醒主应用：

  // 扩展代码
  let sharedDefaults = UserDefaults(suiteName: "group.com.yourapp.yourappgroup")!
  sharedDefaults.set(self.text, forKey: "SpeechTextToRead")
  sharedDefaults.synchronize()
  
  // 唤醒主应用（后台状态也可触发）
  let url = URL(string: "yourappscheme://trigger-speech")!
  UIApplication.shared.open(url, options: [:], completionHandler: nil)
  

• 步骤3：主应用接收请求并执行朗读
  主应用先配置音频会话，再处理语音合成：

  // 主应用AppDelegate/SceneDelegate中处理唤醒逻辑
  func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
      if url.scheme == "yourappscheme" && url.host == "trigger-speech" {
          let sharedDefaults = UserDefaults(suiteName: "group.com.yourapp.yourappgroup")!
          guard let text = sharedDefaults.string(forKey: "SpeechTextToRead") else { return true }
          
          // 配置音频会话
          do {
              let session = AVAudioSession.sharedInstance()
              try session.setCategory(.playback, mode: .default, options: [.mixWithOthers])
              try session.setActive(true)
          } catch {
              print("音频会话配置失败: \(error)")
          }
          
          // 执行语音合成
          let synthesizer = AVSpeechSynthesizer()
          let utterance = AVSpeechUtterance(string: text)
          utterance.rate = 0.55
          synthesizer.speak(utterance)
          
          // 清空共享文本
          sharedDefaults.removeObject(forKey: "SpeechTextToRead")
          sharedDefaults.synchronize()
      }
      return true
  }
  

  同时确保主应用已启用Audio, AirPlay, and Picture in Picture后台模式，保证后台也能执行音频操作。

2. 改用Web Speech API（适用于JS内容脚本）

如果扩展包含JavaScript内容脚本，直接使用浏览器原生Web Speech API，无需依赖iOS原生API：

// 扩展内容脚本代码
const utterance = new SpeechSynthesisUtterance(yourText);
utterance.rate = 0.55;
window.speechSynthesis.speak(utterance);

该API由Safari提供，不受扩展沙箱的原生音频限制。

3. 错误码对应的限制说明

• 错误码2003329396对应kAudioSessionNotAllowedError：扩展进程不被允许设置音频会话，属于沙箱限制，无法直接解决，只能通过主应用代理绕过。
• 错误码-66671对应kAudioSessionNotRunningError：扩展进程无法启动音频队列，同样是沙箱权限拦截导致。

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