OpenCV视频播放时长与原视频不符的问题及解决咨询

用户提供的OpenCV视频播放代码：

import cv2
import time

# Open the video file
cap = cv2.VideoCapture('marker test.mp4')

# Get the frames per second (fps) of the video
fps = cap.get(cv2.CAP_PROP_FPS)

# Read the first frame
ret, frame = cap.read()

while ret:
    # Display the frame
    cv2.imshow('Video Playback', frame)
    
    # Wait for the specified delay to maintain the original timeline
    delay = int(1000 / fps)  # Calculate the delay in milliseconds
    if cv2.waitKey(delay) == 27:  # Exit if the 'Esc' key is pressed
        break
    
    # Read the next frame
    ret, frame = cap.read()

# Release the video capture object and close the windows
cap.release()
cv2.destroyAllWindows()

实际遇到的问题：

• 原视频是30fps录制的，时长约13秒
• 用上述代码播放时，时长被拖至20秒；使用默认delay=1时，播放时长仅约6秒（电脑刷新率60Hz）
• 尝试通过固定计算的delay修正播放速率，但未解决问题，希望实现和原视频完全一致的播放时长

核心问题 #

你的代码只考虑了理论上的帧间隔，却忽略了读取帧、渲染帧本身消耗的时间。这些额外耗时会不断累积，导致实际播放节奏变慢；而用delay=1时，等待时间远小于30fps要求的每帧间隔（约33ms），又会导致播放过快。

修正方案 #

需要基于实际时间戳动态控制播放节奏，而不是依赖固定延迟。修正后的代码如下：

import cv2
import time

cap = cv2.VideoCapture('marker test.mp4')
fps = cap.get(cv2.CAP_PROP_FPS)
frame_duration = 1.0 / fps  # 单帧应持续的精确时间（秒）

ret, frame = cap.read()
if not ret:
    cap.release()
    exit()

# 记录第一帧的起始时间
start_time = time.time()
frame_count = 0

while ret:
    cv2.imshow('Video Playback', frame)
    
    # 计算当前帧的预期显示结束时间
    expected_time = start_time + frame_count * frame_duration
    # 动态计算需要等待的时长，避免负延迟
    delay = max(1, int((expected_time - time.time()) * 1000))
    
    if cv2.waitKey(delay) == 27:
        break
    
    # 更新帧计数并读取下一帧
    ret, frame = cap.read()
    frame_count += 1

cap.release()
cv2.destroyAllWindows()

关键说明 #

• frame_duration：根据视频fps算出每帧应该停留的精确时间（30fps对应约0.0333秒）
• expected_time：基于起始时间和帧计数，算出当前帧应该显示到什么时候，确保整体时间线对齐原视频
• delay：动态计算需要等待的毫秒数，若读取/渲染耗时已经超过预期，就直接进入下一帧（用max(1, ...)避免负延迟）

这种方式能抵消读取、渲染帧的额外耗时，保证总播放时长和原视频完全一致。

内容的提问来源于stack exchange，提问作者Ang Jit Wei Aaron