React Native Video 字幕加载问题分析与解决方案

问题现象

在 React Native Video 6.6.1 版本中，当尝试加载外部字幕文件时，Android 平台会抛出以下错误：

java.lang.IllegalStateException: Legacy decoding is disabled, can't handle application/x-subrip samples (expected application/x-media3-cues)

这个错误会导致视频播放器无法正常显示字幕，严重时甚至会影响整个应用的视频播放功能。

问题根源

经过深入分析，这个问题源于 Android 媒体框架 Media3 的 API 变更。在较新版本的 Media3 中，Google 移除了对传统字幕解码方式的支持，强制要求使用新的字幕处理机制。具体来说：

1. 旧版本支持直接处理 SRT、VTT 等格式的字幕文件
2. 新版本要求所有字幕必须预先转换为 Media3 特定的格式（application/x-media3-cues）
3. React Native Video 库尚未完全适配这一变更

影响范围

该问题影响所有使用以下配置的情况：

• React Native Video 6.6.1 版本
• Android 平台
• 通过 textTracks 属性加载外部字幕文件
• 包括 SRT 和 VTT 格式的字幕

临时解决方案

对于急需解决问题的开发者，可以采用以下临时方案：

1. 降级到 6.5.0 版本
   这个版本尚未引入 Media3 的破坏性变更，能够正常处理外部字幕。

2. 修改字幕加载方式
   将字幕文件预先转换为 Media3 支持的格式，或者考虑将字幕直接嵌入视频文件中。

3. 等待官方修复
   开发团队已经确认问题并计划在后续版本中修复。

最佳实践建议

1. 版本控制
   在 package.json 中明确指定 React Native Video 的版本，避免意外升级。

2. 错误处理
   实现完善的错误处理机制，捕获并妥善处理字幕加载失败的情况。

3. 功能检测
   在应用启动时检测字幕功能是否可用，必要时提供替代方案。

技术展望

随着 Media3 的持续演进，React Native Video 库需要做出相应调整：

1. 实现对新字幕格式的支持
2. 提供字幕格式转换工具
3. 完善跨平台字幕处理的一致性

这个问题提醒我们，在移动开发中，特别是涉及原生功能的部分，需要密切关注底层框架的变更，并及时调整上层实现。