React Native Video 在 iOS 上的 Fabric 架构兼容性问题解析

问题背景

在 React Native 生态系统中，视频播放是一个常见需求，而 react-native-video 是最受欢迎的视频播放组件之一。随着 React Native 新架构（Fabric）的推出，许多现有组件需要适配新架构才能正常工作。本文探讨了一个特定场景下 react-native-video 在 iOS 平台上的异常行为。

问题现象

当应用启用 Fabric（新架构）但通过配置忽略 react-native-video 组件使其运行在旧架构下时，会出现以下异常现象：

1. 使用自定义播放按钮时，点击按钮会触发视频音频开始播放
2. 随后点击原生视频控件播放视频时，会出现两个相同的音频轨道同时播放
3. 暂停可见的视频播放器后，另一个"隐藏"的音频轨道仍在后台继续播放

技术分析

这个问题源于 React Native 新旧架构的混合使用场景。Fabric 是 React Native 的新渲染架构，它带来了性能改进和更紧密的原生集成。然而，并非所有第三方组件都已适配新架构。

通过 react-native-config.js 配置忽略视频组件，实际上是让该组件继续使用旧架构的桥接方式工作。这种混合模式在某些情况下可能导致状态管理不一致，特别是在媒体播放这种需要精确控制生命周期的场景。

解决方案验证

经过测试，这个问题在 react-native-video 的 6.0.0-beta.4 版本中已得到解决。升级到该版本后：

1. iOS 平台上的播放行为恢复正常
2. 自定义播放按钮和原生控件的交互不再产生冲突
3. 音频轨道管理变得可靠

需要注意的是，虽然 iOS 问题得到解决，但相同版本在 Android 平台上会导致应用崩溃，这表明跨平台兼容性仍需进一步优化。

最佳实践建议

对于面临类似问题的开发者，建议：

1. 优先考虑升级到支持新架构的 react-native-video 版本
2. 如果必须使用旧架构兼容模式，应仔细测试所有媒体控制场景
3. 避免在同一应用中混合使用新旧架构组件，除非经过充分测试
4. 对于关键业务功能，考虑实现自定义的播放状态监控机制

总结

React Native 架构演进过程中，第三方组件的兼容性问题不可避免。react-native-video 在 iOS 平台上的这个特定问题展示了新旧架构混合使用的潜在风险。随着生态系统的成熟，这些问题将逐步得到解决，但开发者需要保持组件更新并充分测试各种使用场景。