React Native Video 在 Android 11 及以下版本的 PIP 模式崩溃问题分析

问题背景

React Native Video 是一个流行的视频播放组件库，但在 Android 11 及以下版本中，当启用画中画(PIP)模式时，会出现多种崩溃问题。这些问题主要与 PIP 模式的生命周期管理和视图处理相关。

主要崩溃类型分析

1. 空指针异常

当计算画中画宽高比时，播放器对象为空会导致崩溃。这是由于在 calcPictureInPictureAspectRatio 方法中，没有对传入的 ExoPlayer 对象进行空值检查。

2. 宽高比参数非法

Android 系统对 PIP 模式的宽高比有严格限制，必须在 0.418410 到 2.390000 之间。当视频的实际宽高比超出这个范围时，系统会抛出 IllegalArgumentException。

3. 视图索引越界

在多播放器实例场景下，当尝试访问视图集合时可能出现索引越界问题。这是由于 PIP 模式切换时对视图集合的操作没有做好同步保护。

4. 视图父容器冲突

当视图已经被添加到另一个父容器时，再次尝试添加会导致 IllegalStateException。这表明 PIP 模式切换时没有正确处理视图的移除和重新添加逻辑。

解决方案

1. 空指针防护

在计算宽高比前，应添加对播放器对象的空值检查：

if (player == null) {
    return new Rational(16, 9); // 返回默认宽高比
}

2. 宽高比范围限制

在进入 PIP 模式前，应对计算出的宽高比进行范围检查：

if (aspectRatio.toFloat() > 2.39f) {
    aspectRatio = new Rational(239, 100); // 限制最大宽高比
} else if (aspectRatio.toFloat() < 0.41841f) {
    aspectRatio = new Rational(100, 239); // 限制最小宽高比
}

3. 视图操作安全防护

对于视图集合操作，应添加索引检查和同步保护：

if (viewList != null && index >= 0 && index < viewList.size()) {
    // 安全操作视图
}

4. 视图父容器处理

在重新添加视图前，应先从原父容器移除：

if (view.getParent() != null) {
    ((ViewGroup)view.getParent()).removeView(view);
}
// 然后添加视图到新容器

最佳实践建议

1. 版本适配：针对不同 Android 版本实现不同的 PIP 处理逻辑
2. 错误捕获：对所有 PIP 相关操作添加 try-catch 块
3. 日志记录：记录 PIP 模式切换的关键步骤和参数
4. 状态同步：确保播放器状态与 PIP 模式状态同步
5. 资源释放：在 PIP 模式退出时正确释放相关资源

总结

React Native Video 在 Android 11 及以下版本的 PIP 模式崩溃问题主要源于边界条件处理不足和系统限制考虑不周。通过添加适当的防护措施和错误处理，可以显著提高 PIP 模式的稳定性。开发者在实现类似功能时，应特别注意系统版本差异和边界条件处理，以确保功能的稳定性和兼容性。