AndroidX Media3 全屏退出黑屏问题分析与解决方案

问题背景

在使用 AndroidX Media3 1.2.1 版本开发视频播放器时，开发者遇到了一个特定于 Android 13 设备的显示问题：当从全屏模式退出返回普通模式时，视频画面变为黑屏，仅能听到音频。这个问题在 Android 13 以下的设备上不会出现，且在 Media3 1.1.1 及更早版本中也不存在。

技术细节分析

该问题涉及视频播放器的全屏切换实现机制。开发者采用了以下技术方案：

1. 视图层级结构：Fragment > FrameLayout > AspectRatioFrameLayout > SurfaceView
2. 全屏切换逻辑：通过将包含播放器的 ViewGroup 从原 Fragment 移除并添加到新的全屏 Activity 来实现全屏模式
3. 播放器绑定：在嵌入式模式下调用 ExoPlayer.setVideoSurfaceView 方法

问题根源

经过深入排查，发现问题并非直接由 Media3 库本身引起，而是与 Android 13 系统对 Activity 过渡动画的处理方式变化有关。具体表现为：

1. API 变更影响：Android 13 (API 33) 中弃用了传统的 overridePendingTransition(enterAnim, exitAnim) 方法
2. 新方法问题：替代方法 overridePendingTransition(enterAnim, exitAnim, backgroundColor) 在 Android 13 上存在兼容性问题
3. 修复情况：该问题在 Android 14 中已得到修复

解决方案

针对此问题，开发者可以采用以下两种解决方案：

1. 回退到旧API：在 Android 13 设备上继续使用已弃用的两参数 overridePendingTransition 方法

   if (Build.VERSION.SDK_INT == Build.VERSION_CODES.TIRAMISU) {
       // Android 13 专用处理
       activity.overridePendingTransition(enterAnim, exitAnim);
   } else {
       // 其他版本使用新API
       activity.overridePendingTransition(enterAnim, exitAnim, backgroundColor);
   }
   

2. 优化过渡动画：考虑使用更现代的过渡动画 API，如 ActivityOptions 或 Transition API

经验总结

1. 版本兼容性测试：在升级 Media3 或目标 SDK 版本时，需进行全面测试，特别是针对特定 Android 版本的测试
2. API 弃用处理：对于弃用 API，不能简单替换为新 API，需要考虑版本兼容性问题
3. 日志分析：遇到显示问题时，应仔细检查系统日志，特别是与 Surface 和 EGL 相关的错误信息

最佳实践建议

1. 在实现全屏切换功能时，建议统一使用现代过渡动画 API
2. 对于关键功能，应建立针对不同 Android 版本的自动化测试
3. 在升级媒体播放相关库时，需特别注意 Surface 和视图层级相关的变更

通过本文的分析和解决方案，开发者可以避免在 Android 13 设备上遇到全屏退出黑屏的问题，同时也能更好地理解 Android 系统级变更对媒体播放功能的影响。