3、摄像头实时画面接入：cv2.VideoCapture详解、帧率设置、分辨率调整、画面翻转与镜像、实时显示循环

摄像头接入，是实时检测的第一步。说白了，就是让计算机“睁开眼睛”。

OpenCV 里负责这件事的核心类，就是 cv2.VideoCapture。我刚开始接触它的时候，以为就是个简单的摄像头开关，后来踩了不少坑才发现——参数设置、帧率控制、画面方向，每一个细节都直接影响检测效果。

3.1 cv2.VideoCapture 的两种打开方式

VideoCapture 支持两种输入源：摄像头设备号和视频文件路径。用法几乎一样，但内部逻辑略有不同。

import cv2

cap = cv2.VideoCapture(0)
if not cap.isOpened():
    print("摄像头打开失败，请检查设备连接")
    exit()

print("摄像头已成功打开")

3.2 帧率设置与分辨率调整

摄像头默认的分辨率和帧率，往往不是我们想要的。比如笔记本自带摄像头，很多只有 640x480@30fps。做 YOLO 检测时，我一般会调低分辨率来换取速度。

OpenCV 提供了 cap.set() 方法来修改摄像头参数。常用的属性有：

cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)
cap.set(cv2.CAP_PROP_FPS, 30)

# 读取实际生效的参数
actual_width = cap.get(cv2.CAP_PROP_FRAME_WIDTH)
actual_height = cap.get(cv2.CAP_PROP_FRAME_HEIGHT)
actual_fps = cap.get(cv2.CAP_PROP_FPS)
print(f"实际分辨率: {actual_width}x{actual_height}, 帧率: {actual_fps}")

我曾经在一个项目里，摄像头死活调不到想要的 1280x720。查了半天，发现是 USB 带宽不够。换了个 USB 3.0 接口，问题就解决了。嗯，硬件层面的坑，有时候比代码还难搞。

3.3 画面翻转与镜像

摄像头装的位置不同，画面方向可能不对。比如你把摄像头倒着挂，画面就上下颠倒了。或者做自拍镜像效果，需要左右翻转。

OpenCV 的 cv2.flip() 函数专门干这个：

frame = cv2.flip(frame, 1)   # 左右镜像
frame = cv2.flip(frame, 0)   # 上下翻转
frame = cv2.flip(frame, -1)  # 180° 旋转

3.4 实时显示循环

实时显示的核心，就是一个 while 循环，不断从摄像头读取帧，处理，然后显示。听起来简单，但写不好容易 CPU 跑满、画面卡顿、窗口无响应。

标准写法如下：

while True:
    ret, frame = cap.read()
    if not ret:
        print("读取帧失败，退出循环")
        break

    # 画面翻转（如果需要）
    frame = cv2.flip(frame, 1)

    # 显示画面
    cv2.imshow('Camera', frame)

    # 按 'q' 键退出
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

这里有几个关键点：

• cap.read() 返回两个值： ret 是布尔值，表示是否成功读取；frame 是图像数据。一定要检查 ret，否则程序可能崩溃。
• cv2.waitKey(1) 不能省： 这个函数负责刷新窗口和检测按键。参数 1 表示等待 1 毫秒。如果不加，窗口会卡死。
• 释放资源： 循环结束后，记得 cap.release() 释放摄像头，cv2.destroyAllWindows() 关闭窗口。否则下次打开摄像头可能会报错。

3.5 本章知识结构图

下面这张图，帮你理清摄像头接入的完整流程：

3.6 完整示例代码

把上面所有知识点串起来，就是一个完整的摄像头接入程序：

import cv2

# 1. 打开摄像头
cap = cv2.VideoCapture(0)
if not cap.isOpened():
    print("摄像头打开失败")
    exit()

# 2. 设置参数
cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)
cap.set(cv2.CAP_PROP_FPS, 30)
cap.set(cv2.CAP_PROP_BUFFERSIZE, 1)

# 3. 实时循环
while True:
    ret, frame = cap.read()
    if not ret:
        print("读取帧失败")
        break

    # 4. 画面翻转（左右镜像）
    frame = cv2.flip(frame, 1)

    # 5. 显示
    cv2.imshow('Real-time Camera', frame)

    # 6. 按 'q' 退出
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

# 7. 释放资源
cap.release()
cv2.destroyAllWindows()