OpenCV播放视频时如何避免键盘操作改变播放速度？

问题根源 #

• cv2.waitKey(ms)的机制是：等待指定毫秒数，期间如果有按键按下会立即返回按键值，不会等满设定时间，这就导致按键时循环执行变快，视频出现“快进”。
• 直接用time.sleep()替代的话，OpenCV的窗口事件队列得不到处理，imshow()的帧无法刷新到屏幕，所以视频完全无法显示。

解决方案：精确控制每帧时长，同时处理窗口事件 #

核心思路是保证每帧的总显示时长稳定，同时用waitKey()处理窗口事件避免假死，忽略按键输入对等待时长的影响。

方法1：循环调用短时长waitKey，确保总等待时间达标

这种方法最可靠，能持续处理窗口事件，同时严格控制每帧时长：

import time
import cv2

i = 0
frame_duration = 1 / frame_rate  # 每帧应持续的秒数
total_frames = len(frames)

while i < total_frames:
    start_time = time.time()
    
    # 显示当前帧
    cv2.imshow("video", frames[i])
    
    # 计算已经消耗的时间，得到剩余需要等待的时间
    elapsed = time.time() - start_time
    remaining_time = max(0.0, frame_duration - elapsed)
    
    # 循环调用waitKey(1)消耗剩余时间，确保窗口事件被处理
    while remaining_time > 0:
        cv2.waitKey(1)  # 处理1ms的窗口事件
        remaining_time -= 0.001
    
    i += 1

# 播放结束后销毁窗口
cv2.destroyAllWindows()

方法2：结合waitKey和sleep补全时长

如果觉得循环调用waitKey太繁琐，可以先调用一次waitKey处理事件，再用sleep补够剩余时间：

import time
import cv2

i = 0
target_wait_ms = int(1000 / frame_rate)
total_frames = len(frames)

while i < total_frames:
    cv2.imshow("video", frames[i])
    
    # 先调用waitKey处理窗口事件（1ms）
    start = time.time()
    cv2.waitKey(1)
    elapsed_ms = (time.time() - start) * 1000
    
    # 如果等待时间不够，用sleep补全
    if elapsed_ms < target_wait_ms:
        time.sleep((target_wait_ms - elapsed_ms) / 1000)
    
    i += 1

cv2.destroyAllWindows()

注意事项 #

• 记得在循环结束后调用cv2.destroyAllWindows()清理窗口资源。
• 原代码的while True会导致索引超出帧列表长度报错，建议用len(frames)控制循环边界。

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