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

问题现象

在使用 React Native Video 库的 iOS 版本时，开发者报告了一个常见问题：当用户通过原生控件退出全屏模式时，视频会自动暂停播放，而不是保持原有的播放状态。这与用户的预期行为不符，通常用户会期望视频在退出全屏后继续播放。

问题根源分析

这个问题主要出现在 iOS 平台的 AVPlayerViewController 实现中。当视图控制器退出全屏模式时，系统会触发一系列状态变更，导致播放器暂停。具体来说：

1. 当用户点击退出全屏按钮时，系统会先暂停播放器
2. 然后执行退出全屏的动画过渡
3. 但系统没有自动恢复播放状态

解决方案实现

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

1. 在 RCTVideo 类中新增了一个 _fullscreenExitedWhilePlaying 标志位，用于跟踪退出全屏时的播放状态

2. 扩展了 RCTVideoPlayerViewControllerDelegate 协议，新增了 videoPlayerViewControllerFullScreenExited 回调方法

3. 在视图控制器即将显示时（viewWillAppear）检测是否为首次出现，如果不是则触发全屏退出回调

4. 在播放状态观察器中加入了特殊处理逻辑：

   • 如果是在退出全屏后检测到暂停状态，则自动恢复播放
   • 如果视频已经在播放，则重置标志位

技术实现细节

这个修复方案巧妙地利用了视图控制器的生命周期方法和播放状态观察机制。关键点包括：

1. 使用 _firstAppearance 标志位区分视图控制器的初始加载和后续显示，避免误触发

2. 在播放状态变化时，通过检查 _fullscreenExitedWhilePlaying 标志位来判断是否需要干预系统行为

3. 保持原有播放速率（rate）的设置，确保恢复播放时速度一致

兼容性考虑

该解决方案考虑了多种边界情况：

1. 处理了播放器处于暂停或播放状态的情况
2. 保留了原有的播放状态变更回调机制
3. 不影响其他功能如播放速率控制、搜索等操作

总结

这个修复方案展示了如何通过合理利用系统回调和状态管理来解决 iOS 视频播放中的常见问题。它不仅解决了特定的全屏退出暂停问题，还保持了代码的整洁性和可维护性。对于 React Native 开发者来说，理解这种平台特定的行为差异和解决方案，有助于开发更稳定、用户体验更好的视频播放功能。