如何在Python中使用cv2库获取正在播放视频的当前时间位置

你可以直接通过OpenCV VideoCapture 自带的属性获取精确到毫秒的播放时间，完全匹配视频原生时间轴，不会受播放卡顿、系统调度延迟的影响。 #

两种实现方式 #

方式1：直接读取毫秒级时间（最简便） #

直接调用 cap.get(cv2.CAP_PROP_POS_MSEC) 即可返回当前播放位置的毫秒数，除以1000就能得到带三位小数的秒级时间。

方式2：通过帧数+帧率计算（兼容性更好） #

如果遇到部分特殊封装格式的视频CAP_PROP_POS_MSEC取值不准，可以用视频原生帧率和已播放帧数计算：

• 获取视频原生帧率：fps = cap.get(cv2.CAP_PROP_FPS)
• 获取当前已读取的帧数：current_frame = cap.get(cv2.CAP_PROP_POS_FRAMES)
• 当前播放时间（秒）：current_time_sec = (current_frame - 1) / fps
• 转毫秒只需乘以1000即可。

修改后的完整代码 #

import cv2
import numpy as np

file_name = "2.mp4"
window_name = "window"
interframe_wait_ms = 30

cap = cv2.VideoCapture(file_name)
if not cap.isOpened():
    print("Error: Could not open video.")
    exit()

# 提前获取视频原生帧率，可用于帧数方式计算时间
fps = cap.get(cv2.CAP_PROP_FPS)
print(f"视频原生帧率：{fps:.2f} fps")

cv2.namedWindow(window_name, cv2.WND_PROP_FULLSCREEN)
cv2.setWindowProperty(window_name, cv2.WND_PROP_FULLSCREEN, cv2.WINDOW_FULLSCREEN)

while (True):
    ret, frame = cap.read()
    if not ret:
        print("Reached end of video, exiting.")
        break

    # 方式1：直接取毫秒级时间
    current_msec = cap.get(cv2.CAP_PROP_POS_MSEC)
    current_sec = current_msec / 1000
    # 如需切换为方式2，注释上面两行，取消注释下面三行即可
    # current_frame = cap.get(cv2.CAP_PROP_POS_FRAMES)
    # current_sec = (current_frame - 1) / fps
    # current_msec = current_sec * 1000

    # 输出时间，保留3位小数即对应毫秒精度
    print(f"当前播放时间：{current_sec:.3f} 秒 / {current_msec:.0f} 毫秒")

    cv2.imshow(window_name, frame)
    if cv2.waitKey(interframe_wait_ms) & 0x7F == ord('q'):
        print("Exit requested.")
        break

cap.release()
cv2.destroyAllWindows()

注意事项 #

• 如果你的视频是可变帧率(VFR)格式，优先使用CAP_PROP_POS_MSEC获取时间，比帧数计算结果更准确
• 建议把interframe_wait_ms设置为接近1000/fps的数值，保证播放速度和视频原生速度一致，观感和时间进度匹配

内容的提问来源于stack exchange，提问作者AhmadMhd