React Native Video 项目中外部字幕标题显示为 null 的解决方案

问题背景

在 React Native Video 项目的 Android 平台实现中，开发者发现当使用外部字幕文件时，即使明确提供了字幕标题(title)，在控制台日志中显示的字幕标题值却为 null。这个问题影响了开发者对字幕信息的正确获取和处理。

技术分析

经过深入分析，问题根源在于 React Native Video 的 Android 原生代码实现中，对于字幕标题的处理存在不一致性。具体表现为：

1. 在构建字幕源时，标题被设置为 Format 对象的 label 属性
2. 但在将 ExoPlayer 轨道信息转换为通用轨道信息时，却尝试从 Format 对象的 id 属性获取标题

这种不一致导致了即使正确设置了字幕标题，也无法在最终输出的轨道信息中正确获取。

解决方案

修复方案涉及对 ReactExoplayerView.java 文件中 exoplayerTrackToGenericTrack 方法的修改：

private Track exoplayerTrackToGenericTrack(Format format, int trackIndex, TrackSelection selection, TrackGroup group) {
    Track track = new Track();
    track.setIndex(trackIndex);
    if (format.sampleMimeType != null) track.setMimeType(format.sampleMimeType);
    if (format.language != null) track.setLanguage(format.language);
    // 修改点：从label属性获取标题而非id属性
    if (format.label != null) track.setTitle(format.label);
    track.setSelected(isTrackSelected(selection, group, 0));
    return track;
}

这一修改确保了标题信息的获取方式与设置方式保持一致，解决了标题显示为 null 的问题。

实现原理

在 Android 平台的视频播放实现中：

1. 外部字幕通过 buildTextSource 方法构建
2. 字幕标题被设置为 MediaItem.SubtitleConfiguration 的 label 属性
3. 轨道信息转换时，应该从同一属性获取标题信息才能保证一致性

这种设计遵循了 ExoPlayer 的常规使用模式，其中 label 属性通常用于存储用户可见的描述性信息，而 id 属性则更多用于内部标识。

版本更新

该修复已包含在 React Native Video 的 6.0.0-rc.0 版本中。开发者可以通过升级到该版本或更高版本来获得此修复。

最佳实践

对于需要在 React Native 应用中处理视频字幕的开发者，建议：

1. 始终使用最新稳定版本的 React Native Video 库
2. 在设置外部字幕时，确保同时提供语言和标题信息
3. 在轨道选择变化时，验证获取的轨道信息是否包含预期的元数据
4. 对于自定义字幕处理，考虑扩展 Track 类以包含更多上下文信息

通过遵循这些实践，可以确保视频字幕功能在各种场景下都能正常工作。