计算机视觉 / 系统课时
读取视频文件
读取视频文件
本课使用 OpenCV 打开本地视频文件,读取基础元数据并逐帧播放。完成后,你将能够识别文件无法打开、正常播放结束和提前读取失败这三类状态,并为后续逐帧分析建立稳定入口。
学习目标
- 使用
cv2.VideoCapture打开并验证本地视频文件 - 按原始帧率逐帧读取和显示画面
- 根据读取进度判断文件结束或可能的解码异常
打开文件并读取元数据
cv2.VideoCapture 既能连接摄像头,也能接收视频文件路径。打开前先检查路径是否存在,打开后再检查 isOpened(),这样可以区分“文件不存在”和“存在但无法解码”。
视频的帧率、分辨率和声明总帧数可通过 CAP_PROP_* 属性读取。这些值来自容器和解码后端,适合控制播放和展示信息,但不应作为绝对可靠的业务数据。
主示例:逐帧播放到结束
下面的程序接收一个视频路径,按帧率计算窗口等待时间,并在 read() 返回失败时结束循环。保存为 video_reader.py,运行 python video_reader.py sample.mp4。
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()预期结果
视频已打开: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()返回失败是循环结束信号,但需要结合读取进度判断是否可能提前终止。- 元数据适合辅助播放和诊断,不应盲目信任总帧数与帧率。
下一课预告
下一课可以继续学习视频属性控制与定位,例如跳转到指定帧、读取时间戳,或把处理后的帧写入新视频。