计算机视觉 / 系统课时

读取视频属性

读取视频属性

视频文件打开后,真正决定后续处理方式的是它的尺寸、帧率、总帧数和当前读取位置。本节直接用 VideoCapture.get() 读取这些属性,并处理“属性不可用”这一常见情况,最终得到可验证的视频元数据与时长估算。

学习目标

  • 使用 CAP_PROP_FRAME_WIDTH、CAP_PROP_FRAME_HEIGHT、CAP_PROP_FPS 和 CAP_PROP_FRAME_COUNT 读取基础属性。
  • 用 CAP_PROP_POS_FRAMES 与 CAP_PROP_POS_MSEC 判断当前读取位置。
  • 识别摄像头、网络流和变帧率视频中可能出现的不可靠属性值。

常用属性和值的含义

VideoCapture.get(propId) 返回浮点数,即使“宽度”和“总帧数”本质上是整数,也通常需要显式转成 int。对普通文件,最常用的属性如下:

属性 常见含义 典型值
CAP_PROP_FRAME_WIDTH 解码后帧宽,单位像素 1920
CAP_PROP_FRAME_HEIGHT 解码后帧高,单位像素 1080
CAP_PROP_FPS 视频标称帧率 29.97、30、60
CAP_PROP_FRAME_COUNT 可报告的总帧数 900
CAP_PROP_POS_FRAMES 下一帧的 0 起始索引 0、1、120
CAP_PROP_POS_MSEC 当前视频位置,单位毫秒 0、4000

例如 1920×1080、30 FPS、900 帧的视频,按“总帧数 ÷ 帧率”估算时长为 30 秒。这个算法适合固定帧率文件;变帧率素材只能把它当近似值。

读取并校验元数据

下面示例适用于 Python 3 和 OpenCV 4.x。运行时把视频路径作为命令行参数传入,先检查 isOpened(),再读取属性;这样不会把“文件没打开”误判成“视频属性全部为 0”。

python
import sys
import cv2

def main() -> int:
    if len(sys.argv) != 2:
        print("用法: python video_props.py <video_path>")
        return 2

    cap = cv2.VideoCapture(sys.argv[1])
    if not cap.isOpened():
        print("无法打开视频")
        return 1

    # get() 返回 float;像素尺寸和帧数在展示时转成整数。
    width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
    height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
    fps = cap.get(cv2.CAP_PROP_FPS)
    frame_count = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
    pos_before = int(cap.get(cv2.CAP_PROP_POS_FRAMES))

    ok, _ = cap.read()
    pos_after = int(cap.get(cv2.CAP_PROP_POS_FRAMES))

    print(f"width={width}")
    print(f"height={height}")
    print(f"fps={fps:.3f}")
    print(f"frame_count={frame_count}")
    if fps > 0 and frame_count > 0:
        print(f"duration_seconds={frame_count / fps:.3f}")
    else:
        print("duration_seconds=unknown")
    print(f"pos_frames_before_read={pos_before}")
    print(f"first_read_ok={ok}")
    print(f"pos_frames_after_read={pos_after}")

    cap.release()
    return 0

if __name__ == "__main__":
    raise SystemExit(main())

预期输出:若输入文件确实是 1920×1080、30 FPS、900 帧,并且第一帧可正常读取,可得到类似结果。

text
width=1920
height=1080
fps=30.000
frame_count=900
duration_seconds=30.000
pos_frames_before_read=0
first_read_ok=True
pos_frames_after_read=1

实际尺寸、帧率和帧数会随文件变化;如果 first_read_ok=False,说明容器虽然可能被打开,但没有成功解码出第一帧,应继续检查编码器支持或文件完整性。

当前位置怎样变化

CAP_PROP_POS_FRAMES 适合按帧观察进度。刚打开文件时通常为 0;成功执行一次 read() 后通常变为 1,表示下一次将读取第 1 号帧。若读取到第 120 帧附近,值会随解码进度继续增加。

CAP_PROP_POS_MSEC 用毫秒表示时间位置。例如 30 FPS 的固定帧率视频,读到约第 120 帧时,时间位置大约是 4000 ms。压缩视频执行随机跳转时,后端可能先落到邻近关键帧再继续解码,因此不要把它当作所有格式下都绝对精确的时间戳。

属性值不可靠的情况

摄像头和实时网络流通常没有“总帧数”,因此 CAP_PROP_FRAME_COUNT 可能返回 0 或其他不可用值;某些设备的 CAP_PROP_FPS 也可能是 0。此时应把“值大于 0”作为计算时长或帧间隔前的最小检查条件。

变帧率文件还有另一个边界:FRAME_COUNT / FPS 只给出近似时长。如果业务需要精确时间轴,应以每帧时间戳或专门的媒体探测工具为准,而不是仅依赖 VideoCapture 的两个汇总属性。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取视频属性

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通