React Native Video 在 iOS 后台播放失效问题分析与解决方案

问题背景

React Native Video 是一个流行的视频播放组件库，在 6.0.0-beta.7 版本中，开发者发现 iOS 平台上设置 playInBackground 属性后，当应用进入后台时视频音频会意外停止播放。这个问题影响了需要后台音频播放功能的用户体验。

问题现象

当开发者按照官方文档配置了 playInBackground 属性和 ignoreSilentSwitch='ignore' 参数，并在 Xcode 中启用了后台音频权限后，发现以下异常行为：

1. 应用进入后台时视频音频立即停止
2. 应用返回前台后视频会自动恢复播放
3. 通过调试发现 applicationDidEnterBackground 方法正常执行，没有将播放器设为 nil
4. 音频会话类别显示为正确的 AVAudioSessionCategoryPlayback

技术分析

经过深入排查，发现问题根源在于 iOS 15+ 系统中 AVPlayer 的 audiovisualBackgroundPlaybackPolicy 属性默认设置为 .automatic。这个设置会导致系统在某些情况下自动暂停后台播放。

在 iOS 15 及以上版本中，苹果引入了更精细的后台播放控制策略。audiovisualBackgroundPlaybackPolicy 属性有三个可选值：

1. .automatic：系统根据上下文自动决定
2. .continuesIfPossible：尽可能继续播放
3. .pauses：总是暂停

解决方案

针对这个问题，开发者提出了有效的解决方案：

if #available(iOS 15.0, *) {
    _playerLayer?.player?.audiovisualBackgroundPlaybackPolicy = .continuesIfPossible
}

这个修改确保了在 iOS 15+ 设备上视频能够持续在后台播放。需要注意的是，这个方案仅适用于 iOS 15 及以上版本，对于旧版本系统需要保持原有逻辑。

进阶优化

在实际应用中，开发者还发现了需要进一步优化的场景：

1. 当其他应用开始播放音频时（如在 Safari 中播放 YouTube 视频），当前应用的音频应自动暂停
2. 需要兼容 iOS 14 及以下版本的设备

对于第一个问题，可以通过监听音频会话中断通知来实现：

NotificationCenter.default.addObserver(
    self,
    selector: #selector(handleAudioSessionInterruption),
    name: AVAudioSession.interruptionNotification,
    object: nil
)

版本兼容性考虑

根据统计数据，iOS 15+ 已覆盖绝大多数用户，因此主要针对这一版本进行优化是合理的。对于必须支持旧版本的特殊需求，可以考虑以下方案：

1. 对于 iOS 14 及以下设备，保持原有实现
2. 使用特性检测而非版本检测
3. 提供用户可配置的后台播放策略

最佳实践建议

1. 始终在 Xcode 项目中启用后台音频权限
2. 明确测试不同 iOS 版本的后台播放行为
3. 考虑用户场景是否需要与其他音频应用互斥
4. 在应用设置中提供后台播放的开关选项
5. 正确处理音频会话中断和恢复

结论

React Native Video 的后台播放功能在 iOS 平台上需要特别注意系统版本差异和音频会话管理。通过合理设置 audiovisualBackgroundPlaybackPolicy 属性和正确处理音频中断通知，可以实现稳定可靠的后台播放体验。开发者应根据目标用户群的设备分布和应用场景需求，选择最适合的实现方案。