React Native Video 在 iOS 上切换字幕轨道时出现 AVFoundationErrorDomain 错误的解决方案

问题背景

在 React Native Video 6.0.0-beta.4 版本中，iOS 平台上切换字幕轨道时会出现一个严重问题。当开发者尝试通过 selectedTextTrack 属性更改当前选中的字幕轨道时，系统会抛出 AVFoundationErrorDomain 错误，错误代码为 -11800，同时视频播放也会中断。

错误表现

具体错误信息如下：

{
  "error": {
    "code": -11800,
    "domain": "AVFoundationErrorDomain",
    "localizedDescription": "The operation could not be completed",
    "localizedFailureReason": "An unknown error occurred (-12783)",
    "localizedRecoverySuggestion": ""
  },
  "target": 3557
}

问题根源

经过技术团队深入分析，发现问题出在 iOS 原生代码处理字幕轨道的逻辑上。主要涉及两个关键点：

1. 在检查轨道是否具有可读特性(.legible)时，条件判断不够严谨
2. 在转换文本轨道数据时，没有正确处理可选值的情况

解决方案

技术团队通过以下代码修改解决了这个问题：

1. 修正轨道特性检查逻辑：

// 修改前
for i in 0 ..< trackCount where (player?.currentItem?.tracks[i].assetTrack?.hasMediaCharacteristic(.legible)) != nil

// 修改后
for i in 0 ..< trackCount where player?.currentItem?.tracks[i].assetTrack?.hasMediaCharacteristic(.legible) ?? false

2. 完善文本轨道数据转换：

// 修改前
"textTracks": textTracks.map(\.json)

// 修改后
"textTracks": self._textTracks?.compactMap { $0.json } ?? textTracks.map(\.json)

技术细节解析

1. 轨道特性检查：原代码仅检查了 hasMediaCharacteristic 方法是否存在，而没有实际验证返回值。修改后明确检查返回值是否为 true，确保只有真正具有字幕特性的轨道才会被处理。

2. 数据安全转换：新代码增加了对可选值的处理，使用 compactMap 过滤掉 nil 值，并通过 nil 合并运算符(??)提供了回退方案，增强了代码的健壮性。

版本影响

此修复已包含在 React Native Video 6.0.0-beta.6 版本中。使用早期 beta 版本遇到此问题的开发者建议升级到最新版本。

开发者建议

1. 如果需要在应用中使用字幕轨道功能，请确保使用 6.0.0-beta.6 或更高版本
2. 注意 iOS 平台对字幕轨道的支持有一定限制，建议在实现前充分测试各种场景
3. 对于复杂的字幕需求，可以考虑预先将字幕烧录到视频中，避免依赖外部字幕轨道

总结

这个问题的解决展示了 React Native 社区对质量问题的快速响应能力。通过技术团队的协作，一个影响核心功能的严重问题在短时间内得到了修复。开发者现在可以放心地在 iOS 平台上使用 React Native Video 的字幕轨道功能了。