理解AndroidX Media3中视频尺寸回调与帧可用的时序问题

在AndroidX Media3项目中，开发者在使用setVideoSurface接收视频纹理时可能会遇到一个时序问题：SurfaceTexture.setOnFrameAvailableListener的回调有时会在Player.Listener.onVideoSizeChanged之前触发。这种情况使得开发者难以在帧可用时确定正确的Bitmap尺寸。

问题本质

当视频开始播放时，系统会通过两个关键回调通知应用：

1. onVideoSizeChanged - 通知视频的实际尺寸
2. OnFrameAvailableListener - 通知有新帧可用

理想情况下，尺寸回调应该先于帧可用回调触发，这样开发者就能提前知道需要准备多大的Bitmap来接收视频帧。然而在实际运行中，这两个回调的时序可能颠倒，导致开发者无法在帧到达时确定正确的尺寸。

解决方案

AndroidX Media3团队建议使用VideoFrameMetadataListener替代传统的方式。这个监听器有以下优势：

1. 它会在视频帧被释放到播放器表面之前同步调用
2. 它提供了包含尺寸信息的Format对象
3. 它在播放线程上执行，保证了时序的正确性

实现建议

开发者可以这样重构代码：

1. 移除对SurfaceTexture.setOnFrameAvailableListener的依赖
2. 实现VideoFrameMetadataListener接口
3. 在回调中获取视频尺寸信息
4. 根据尺寸信息准备适当的Bitmap缓冲区

这种方法不仅解决了时序问题，还提供了更可靠的视频元数据访问方式，是处理视频帧和尺寸信息的推荐做法。

总结

理解Android多媒体框架中各种回调的时序关系对于开发稳定的视频应用至关重要。通过使用Media3提供的VideoFrameMetadataListener，开发者可以避免因回调时序不确定导致的问题，确保在正确处理视频帧的同时获得准确的尺寸信息。