AndroidX Media3 1.5.0版本视频尺寸显示问题分析

在AndroidX Media3库从1.4.1升级到1.5.0版本后，开发者报告了一个关于视频尺寸显示异常的问题。本文将深入分析该问题的成因、影响范围以及解决方案。

问题现象

开发者在使用ExoPlayer的PlayerView组件时发现，在1.5.0版本中视频的显示尺寸与1.4.1版本存在明显差异。具体表现为视频在Pixel等特定设备上出现宽度拉伸的情况，而1.4.1版本则显示正常。

技术背景

AndroidX Media3 1.5.0版本引入了一个重要的变更，涉及视频宽高比处理逻辑的修改。这个变更原本是为了改进视频渲染质量，但在特定设备上却导致了意外的显示问题。

问题根源

经过技术分析，发现问题主要出在Pixel系列设备的MediaCodec实现上。具体表现为：

1. Pixel设备在MediaCodecVideoRenderer的onOutputFormatChanged()方法中提供了错误的mediaFormat数据
2. 这些设备错误地将sar-width和sar-height参数设置为1，而实际上视频流中携带的正确比例应为360:427
3. 其他非Pixel设备则不会携带sar参数，因此不受此问题影响

解决方案

开发团队已经采取了以下措施解决该问题：

1. 回滚了导致问题的PR #1371变更
2. 在内部bug跟踪系统中记录了更详细的分析（b/378713448）
3. 对于使用Compose的开发者，建议启用PlayerView的特定工作区设置

开发者建议

对于遇到类似问题的开发者，建议：

1. 确保使用最新版本的AndroidX Media3库
2. 在Compose环境中正确配置PlayerView的工作区设置
3. 针对Pixel设备进行专门的测试和适配
4. 关注官方发布说明中的已知问题和解决方案

总结

这个案例展示了Android多媒体开发中设备兼容性的重要性。即使是经过充分测试的库更新，也可能在特定硬件上出现意外行为。开发团队通过快速响应和问题定位，及时解决了这一显示异常问题，为开发者提供了稳定的视频播放体验。