React Native Video 项目中外部字幕标题显示为 null 的问题解析

问题背景

在 React Native Video 项目（v6 Beta 版本）的 Android 平台上，开发者报告了一个关于外部字幕标题显示的问题。当使用外部字幕文件时，即使明确提供了标题字符串，字幕轨道的 title 属性仍然会被设置为 null 值。

技术分析

这个问题源于 React Native Video 的 Android 原生代码中对字幕轨道属性的处理逻辑。具体来说，在 ReactExoplayerView.java 文件中的 exoplayerTrackToGenericTrack 方法存在属性映射错误。

原始代码尝试从格式对象的 id 属性获取标题信息：

if (format.id != null) track.setTitle(format.id);

然而实际上，在构建字幕源时，标题是被设置到了 label 属性而非 id 属性：

.setLabel(title)

这种属性映射的不一致导致了标题信息无法正确传递到前端。

解决方案

修复方案相当直接，只需修改属性访问逻辑，从 label 而非 id 获取标题信息：

if (format.label != null) track.setTitle(format.label);

这个修改确保了标题信息的正确传递路径：前端传入的标题 → 设置到 label 属性 → 从 label 属性读取 → 设置到 track 的 title 属性。

版本更新

该修复已被包含在 React Native Video 的 6.0.0-rc.0 版本中。开发者只需升级到该版本或更高版本即可解决此问题。

技术思考

这个问题引发了一个更深层次的思考：在跨平台多媒体开发中，属性命名和映射的一致性至关重要。不同的底层播放器（如 Android 的 ExoPlayer 和 iOS 的 AVPlayer）可能有不同的属性命名习惯，框架层需要做好统一的抽象和映射。

在 React Native Video 的设计中，可以考虑：

1. 统一前后端属性命名规范
2. 增加属性映射的文档说明
3. 在核心代码中添加注释说明各属性的对应关系

这样可以避免类似的属性映射问题，提高框架的稳定性和可维护性。

总结

这个问题的解决展示了开源项目中常见的问题排查和修复流程：从问题报告 → 原因分析 → 代码修复 → 版本发布。对于开发者而言，及时关注项目更新和变更日志是保持应用稳定的重要实践。