FFmpegKit中视频元数据解析的宽高反转问题分析与解决方案

在移动端视频处理开发中，FFmpegKit作为强大的多媒体处理框架，其getMediaInformationAsync方法被广泛用于获取视频元数据。然而开发者在使用过程中可能会遇到视频宽高值反转的问题，这直接影响后续的视频处理流程。

问题现象

当处理iPhone相册中的某些视频时，会出现元数据中width和height值与实际显示不符的情况。例如：

• 实际视频分辨率：1080x1920（竖屏）
• 获取到的元数据：1920x1080（横屏）

值得注意的是，该问题并非在所有视频中都出现，具有选择性出现的特征。

根本原因分析

经过技术排查，这种现象通常与视频的旋转元数据（Rotation Metadata）有关。现代智能手机拍摄视频时会记录设备的物理方向，并通过以下两种方式存储方向信息：

1. Side Data列表：FFmpeg解析视频时会检测到旋转矩阵信息（如-90度旋转）
2. 视频标签：部分视频会将方向信息存储在tag字段中

当播放器或相册应用读取视频时，会自动应用这些旋转信息，而原始的视频流仍然是横向存储的。FFmpegKit默认返回的是视频流的原始宽高，不自动处理旋转信息。

解决方案

方案一：解析旋转元数据

通过检查FFprobe返回的完整信息，可以获取准确的视频方向：

{
  "streams": [
    {
      "side_data_list": [
        {
          "rotation": -90
        }
      ]
    }
  ]
}

当检测到rotation字段时，需要对宽高值进行交换处理。

方案二：检查视频标签

部分视频文件会将方向信息存储在tag中：

MediaInformation info = FFprobeKit.getMediaInformationAsync(videoPath);
Map<String, String> tags = info.getStreams().get(0).getTags();
String rotation = tags.get("rotate");

完整处理逻辑建议

MediaInformation info = FFprobeKit.getMediaInformationAsync(videoPath);
int width = info.getStreams().get(0).getWidth();
int height = info.getStreams().get(0).getHeight();

// 检查旋转信息
int rotation = 0;
if (info.getStreams().get(0).getSideDataList() != null) {
    // 从side data获取旋转角度
    rotation = ...;
} else if (info.getStreams().get(0).getTags() != null) {
    // 从tag获取旋转角度
    rotation = ...;
}

// 根据旋转角度调整宽高
if (Math.abs(rotation) % 180 == 90) {
    int temp = width;
    width = height;
    height = temp;
}

最佳实践建议

1. 始终检查视频的旋转元数据
2. 对于用户生成内容（UGC）要特别处理方向问题
3. 在显示视频前验证实际显示方向
4. 考虑使用FFmpeg的transpose滤镜进行主动旋转处理

扩展思考

这个问题实际上反映了多媒体处理中的一个重要概念：存储格式与显示格式的差异。理解视频容器、流数据、元数据之间的关系，对于开发稳定的视频处理功能至关重要。建议开发者在处理视频元数据时，建立完整的数据校验机制，特别是对于移动设备拍摄的视频内容。

通过系统性地处理视频方向信息，可以确保在各种场景下都能正确获取和使用视频分辨率参数，为后续的视频编辑、转码、播放等操作奠定可靠基础。