计算机视觉 / 系统课时

读取视频文件

读取视频文件

本课使用 OpenCV 打开本地视频文件,读取基础元数据并逐帧播放。完成后,你将能够识别文件无法打开、正常播放结束和提前读取失败这三类状态,并为后续逐帧分析建立稳定入口。

学习目标

  • 使用 cv2.VideoCapture 打开并验证本地视频文件
  • 按原始帧率逐帧读取和显示画面
  • 根据读取进度判断文件结束或可能的解码异常

打开文件并读取元数据

cv2.VideoCapture 既能连接摄像头,也能接收视频文件路径。打开前先检查路径是否存在,打开后再检查 isOpened(),这样可以区分“文件不存在”和“存在但无法解码”。

视频的帧率、分辨率和声明总帧数可通过 CAP_PROP_* 属性读取。这些值来自容器和解码后端,适合控制播放和展示信息,但不应作为绝对可靠的业务数据。

主示例:逐帧播放到结束

下面的程序接收一个视频路径,按帧率计算窗口等待时间,并在 read() 返回失败时结束循环。保存为 video_reader.py,运行 python video_reader.py sample.mp4。

python
import argparse
from pathlib import Path

import cv2

def main() -> None:
    parser = argparse.ArgumentParser(description='Read a local video file')
    parser.add_argument('video', type=Path, help='path to the video file')
    args = parser.parse_args()

    if not args.video.is_file():
        raise FileNotFoundError(f'视频文件不存在:{args.video}')

    cap = cv2.VideoCapture(str(args.video))
    if not cap.isOpened():
        raise RuntimeError(f'视频无法打开或缺少解码器:{args.video}')

    fps = cap.get(cv2.CAP_PROP_FPS)
    total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
    width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
    height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
    delay_ms = max(1, round(1000 / fps)) if fps > 0 else 1

    print(f'视频已打开:{args.video.name}')
    print(f'分辨率:{width}x{height}')
    print(f'帧率:{fps:.2f},声明总帧数:{total_frames}')

    frame_count = 0
    try:
        while True:
            ok, frame = cap.read()
            if not ok or frame is None:
                if total_frames > 0 and frame_count < total_frames:
                    reason = '提前停止,可能存在损坏帧或解码问题'
                else:
                    reason = '到达视频末尾'
                print(f'读取结束:{reason},已处理 {frame_count} 帧')
                break

            frame_count += 1
            cv2.imshow('Video Preview - press q to quit', frame)

            # 用视频帧率近似控制播放速度,按 q 可提前结束。
            if cv2.waitKey(delay_ms) & 0xFF == ord('q'):
                print(f'用户退出,已处理 {frame_count} 帧')
                break
    finally:
        cap.release()
        cv2.destroyAllWindows()

if __name__ == '__main__':
    main()

预期结果

text
视频已打开:sample.mp4
分辨率:<WIDTH>x<HEIGHT>
帧率:<FPS>,声明总帧数:<TOTAL_FRAMES>
读取结束:到达视频末尾,已处理 <FRAME_COUNT> 帧

同时会出现视频预览窗口。<WIDTH>、<HEIGHT>、<FPS>、<TOTAL_FRAMES> 和 <FRAME_COUNT> 取决于输入文件;部分编码格式的声明总帧数可能与实际解码帧数略有差异。

识别视频结束状态

视频读取循环不需要预先知道总帧数。每次调用 read(),成功时得到一帧;返回 False 时,通常表示已经到达文件末尾,也可能表示解码器遇到损坏帧或不支持的编码。

示例通过“已读取帧数是否明显小于声明总帧数”给出初步判断。该判断只能用于排查提示,因为可变帧率视频、索引不完整的容器或某些解码后端可能返回不准确的 CAP_PROP_FRAME_COUNT。

播放速度与批处理

waitKey() 的参数单位是毫秒。对于固定帧率视频,可用 1000 / fps 近似每帧等待时间;当读取不到有效帧率时,示例退化为 1 毫秒,以避免除零错误。

如果目标是离线分析而不是实时播放,应删除 imshow() 和 waitKey(),让程序尽快读取。此时仍要保留 read() 状态检查和 release(),并在每帧成功后执行检测、转码或统计逻辑。

常见问题与边界

  • 文件存在但无法打开:可能缺少对应编解码器,先换用常见的 MP4/H.264 或重新转码。
  • 播放速度明显不准:文件可能是可变帧率,单纯依赖 CAP_PROP_FPS 只能近似播放。
  • 读取提前结束:检查文件是否损坏,并用其他播放器验证同一时间点能否正常解码。
  • 服务器没有桌面环境:移除窗口相关调用,将处理结果写入文件、日志或数据库。

本课总结

  • 文件路径和 isOpened() 应分别检查,以便快速区分路径错误与解码失败。
  • read() 返回失败是循环结束信号,但需要结合读取进度判断是否可能提前终止。
  • 元数据适合辅助播放和诊断,不应盲目信任总帧数与帧率。

下一课预告

下一课可以继续学习视频属性控制与定位,例如跳转到指定帧、读取时间戳,或把处理后的帧写入新视频。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取视频文件

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

登录哪都通