React Native Video 在 iOS 上文本轨道显示问题的技术分析

问题背景

React Native Video 是一个流行的视频播放组件库，在最新的 v6 Beta 版本中，iOS 平台上出现了文本轨道（字幕/字幕）无法正常显示的问题。这个问题在基础示例项目中就能复现，影响了包括 HLS 流媒体和本地视频的字幕显示功能。

问题表现

开发者在使用 React Native Video 时发现：

1. 示例项目中标记为"带字幕"的视频无法显示任何字幕
2. 即使明确设置了 selectedTextTrack 属性，字幕仍然不显示
3. 问题出现在多种视频源上，包括 Sintel 示例视频和本地加载的字幕

技术分析

根本原因

经过核心开发团队的调查，发现这个问题源于两个独立的技术因素：

1. Swift Promise 移除导致的回归问题：在 v6 版本中移除 Swift Promise 的过程中，意外影响了字幕显示的核心功能。这是导致内置字幕无法显示的主要原因。

2. HLS 流媒体的技术限制：对于通过 textTracks 属性侧载的字幕文件，iOS 平台存在技术限制。React Native Video 内部使用 AVMutableCompositionTrack 来添加字幕轨道，这种技术无法应用于 HLS (m3u8) 流媒体视频。

解决方案

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

1. 对于内置字幕的显示问题，已经通过代码修复恢复了功能
2. 对于侧载字幕，修复后可以正常工作，但仅限于非 HLS 视频源（如 MP4 等本地文件）

开发者注意事项

1. HLS 流媒体的字幕限制：如果需要为 HLS 流媒体添加字幕，应该考虑将字幕直接嵌入到流媒体中，而不是通过 textTracks 属性侧载。

2. 字幕属性设置：确保正确设置 textTracks 和 selectedTextTrack 属性。可以使用语言代码或索引值来指定要显示的字幕轨道。

3. 测试策略：在实现字幕功能时，建议同时测试多种视频格式和字幕加载方式，以确保兼容性。

版本兼容性

这个问题主要影响 v6 Beta 版本，v5.2 版本中字幕功能是正常工作的。开发团队正在努力确保 v6 正式版中字幕功能的稳定性。

总结

React Native Video 的字幕功能在 iOS 平台上遇到的技术挑战主要源于架构变更和平台限制。开发团队已经识别并修复了核心问题，但开发者仍需注意 HLS 流媒体的特殊限制。随着 v6 版本的完善，这些功能将变得更加稳定可靠。