React Native Video 在 iOS 上的字幕显示问题分析与解决方案

问题背景

React Native Video 是一个流行的视频播放组件库，在最新的 v6 Beta 版本中，开发者在 iOS 平台上发现了一个关键问题：内置示例项目中的字幕功能无法正常显示。这个问题影响了两种类型的字幕：内嵌字幕和外部加载的字幕。

问题现象

在测试过程中，开发者发现以下现象：

1. 对于标有"带有字幕"的示例视频（如Sintel龙视频），字幕无法显示
2. 对于标有"带有侧载字幕"的示例视频，同样无法显示字幕
3. 即使手动设置了 selectedTextTrack 属性（无论是通过索引还是语言代码），字幕仍然不显示

技术分析

经过深入调查，发现这个问题源于以下几个技术因素：

1. Swift Promise 移除导致的回归问题：在版本升级过程中，移除 Swift Promise 可能意外影响了字幕功能的正常工作。

2. HLS 流媒体与本地字幕的兼容性问题：技术团队发现，对于 HLS 格式的流媒体（m3u8），无法通过 AVMutableCompositionTrack 添加外部字幕。这是由于技术限制导致的，因为 HLS 是流式传输，而本地字幕需要静态组合。

3. 字幕轨道选择逻辑问题：即使正确设置了 textTracks 和 selectedTextTrack 属性，系统也没有正确激活字幕轨道。

解决方案

开发团队已经针对这个问题提出了修复方案：

1. 对于普通视频文件（如MP4），已经修复了外部字幕加载功能
2. 明确了 HLS 流媒体不支持外部字幕的技术限制
3. 修复了字幕轨道选择的逻辑问题

开发者注意事项

在使用 React Native Video 的字幕功能时，开发者需要注意：

1. 对于 HLS 流媒体，只能使用内嵌字幕，无法使用外部字幕文件
2. 对于本地视频文件或非流媒体视频，可以使用外部字幕（VTT格式）
3. 设置字幕时，建议同时检查 textTracks 和 selectedTextTrack 两个属性
4. iOS 平台对字幕格式有特定要求，确保使用兼容的格式

结论

React Native Video 团队已经识别并修复了 iOS 平台上的字幕显示问题。这个问题的解决确保了视频播放组件在移动应用中的完整功能体验。开发者在使用字幕功能时，应当注意不同视频格式对字幕支持的限制，特别是 HLS 流媒体的特殊要求。