AndroidX Media3 中竖屏旋转视频的显示问题解析

问题背景

在AndroidX Media3项目(原ExoPlayer)中，开发者遇到了一个关于视频旋转显示的特殊问题。某些iPhone拍摄的视频在元数据中标记为1920x1080(横屏)分辨率并带有90度旋转信息，但实际上这些是竖屏视频。播放器未能正确识别这种特殊情况，导致视频无法全屏适配显示。

技术现象分析

当使用Media3播放这类视频时，出现了三种不同的显示效果：

1. RESIZE_MODE_FIT模式下：视频无法填满整个屏幕，两侧出现黑边
2. RESIZE_MODE_FILL模式下：视频被拉伸填充，但比例失调
3. RESIZE_MODE_ZOOM模式下：视频被放大裁剪，丢失部分内容

而同样的视频在Linux基础播放器和VLC播放器中却能正确识别为竖屏视频，并自动旋转后按高度填满屏幕。

根本原因

经过技术分析，问题根源在于：

1. 播放器仅依赖视频元数据中的宽高信息(1920x1080)判断视频方向，将其视为横屏视频
2. 虽然元数据中包含90度旋转信息，但播放器在计算显示比例时未充分考虑这一因素
3. 当前实现中，PlayerView的内容框测量逻辑基于videoAspectRatio计算，但该值未包含旋转度数的修正

解决方案探讨

针对这一问题，技术团队提出了几个解决方向：

1. 使用新版Compose UI组件：Media3新推出的media3-ui-compose库提供了更好的Compose集成支持，可能更正确处理这类特殊情况

2. 修改宽高计算逻辑：建议在计算显示比例时，应同时考虑视频的旋转度数信息。当前实现中，Player.videoFormat.rotationDegrees的值未被充分利用

3. 底层修正建议：理想情况下，播放器在应用旋转后应自动交换宽高尺寸，使后续的缩放计算基于正确的方向信息

技术实现建议

对于开发者遇到的具体问题，可以采取以下措施：

1. 升级到最新版Media3库，特别是使用专为Compose设计的UI组件
2. 在自定义PlayerView时，重写aspect ratio计算逻辑，加入旋转度数的修正
3. 对于紧急修复，可以在获取视频尺寸后手动检查旋转信息，必要时交换宽高值

总结

这类视频旋转与显示适配问题在移动端视频处理中较为常见，特别是在处理不同设备拍摄的视频时。AndroidX Media3团队已经意识到这一问题，并在新版中提供了改进方案。开发者应根据项目需求选择合适的解决方案，确保视频在各种情况下都能正确显示。