React Native Video 在 iOS 上退出全屏时视频暂停的问题解析

在 React Native 生态系统中，React Native Video 是一个广泛使用的视频播放组件库。近期在 iOS 平台上发现了一个影响用户体验的问题：当用户通过原生控件退出全屏模式时，视频会自动暂停播放，而不是保持原有的播放状态。

问题现象

该问题表现为以下几个步骤：

1. 用户打开视频并开始播放
2. 进入全屏模式
3. 通过原生控件退出全屏
4. 视频会自动暂停，而不是继续播放

技术背景分析

在 iOS 平台上，AVPlayerViewController 负责处理视频播放的全屏展示。当用户退出全屏时，系统会触发一系列视图控制器的生命周期方法和播放状态变更。正常情况下，播放状态应该保持不变，但实际观察到的行为却是播放被中断。

问题根源

经过深入分析，发现问题的核心在于：

1. 退出全屏时，系统会临时改变播放器的控制状态
2. 组件内部的状态管理没有正确处理这种过渡情况
3. 播放器状态监听逻辑过于简单，没有区分用户主动暂停和系统自动暂停的情况

解决方案

社区贡献者提出了一种有效的修复方案，主要包含以下几个关键点：

1. 在 RCTVideoPlayerViewController 中添加首次出现的标记
2. 在视图即将出现时检测是否为首次出现
3. 非首次出现时触发全屏退出回调
4. 在 RCTVideo 中维护一个标记来记录全屏退出时的播放状态
5. 在播放状态变更时检查这个标记，并做出相应处理

实现细节

修复方案的核心逻辑是：

• 添加 _fullscreenExitedWhilePlaying 标志位来跟踪全屏退出时的播放状态
• 扩展 RCTVideoPlayerViewControllerDelegate 协议，增加全屏退出回调
• 在视图控制器中检测非首次出现的场景
• 在状态变更时根据标志位恢复播放

最佳实践建议

对于使用 React Native Video 的开发者，建议：

1. 及时更新到包含此修复的版本
2. 如果暂时无法升级，可以考虑应用类似的补丁
3. 在全屏相关逻辑中添加额外的状态检查
4. 测试时特别关注全屏和非全屏模式间的切换

总结

这个问题的修复展示了在跨平台开发中处理原生组件行为的重要性。通过深入理解 iOS 平台的特性和组件生命周期，开发者可以更好地控制视频播放体验，确保用户在不同视图模式间切换时获得一致的播放体验。