计算机视觉 / 系统课时

访问摄像头画面

访问摄像头画面

访问本地摄像头时,最重要的不是只写 VideoCapture(0),而是确认设备编号、打开状态和实际生效的分辨率。下面用 OpenCV 4.x 的 Python 接口建立一个可退出、可验证、失败时能定位问题的实时采集循环。

学习目标

  • 能用设备编号连接本地摄像头并检查打开状态。
  • 能请求分辨率与帧率,并读取设备实际采用的值。
  • 能根据设备编号、权限、占用和视频后端定位常见打开失败问题。

选择设备编号并确认打开

cv2.VideoCapture(0) 中的 0 表示默认的第一个摄像头;接入第二个 USB 摄像头后常见编号是 1,再往后可能是 2。编号由操作系统和视频后端枚举决定,插拔设备后顺序可能变化,因此程序不能假设某个外接摄像头永远固定为 1。

打开后立即检查 cap.isOpened()。如果为 False,不要继续调用 read();先尝试 0、1、2 三个编号,并关闭会议软件、浏览器摄像头页面或其他可能独占设备的程序,再重新打开。

请求分辨率并读取实际值

摄像头属性会经过 OpenCV、视频后端、操作系统、驱动和硬件多层传递,因此 cap.set() 只是提出请求,不代表设备一定采用该值。请求 1280×720、30 FPS 后,应立即用 cap.get() 读取 CAP_PROP_FRAME_WIDTH、CAP_PROP_FRAME_HEIGHT 和 CAP_PROP_FPS 验证实际结果。

OpenCV 摄像头属性从应用层到硬件层的传递关系

常见的实际情况是设备只支持若干离散模式,例如 640×480@30、1280×720@30 或 1920×1080@30。若读回值与请求值不同,应以读回值为准;不要只根据 set() 的布尔返回值判断分辨率是否真正生效。

建立实时采集循环

下面脚本请求 1280×720、30 FPS,随后打印实际后端和实际参数。窗口中持续显示摄像头帧,按 Esc 退出;try/finally 保证正常退出和异常退出都会释放设备。

python
import cv2

camera_index = 0
cap = cv2.VideoCapture(camera_index)

if not cap.isOpened():
    raise SystemExit(f"无法打开摄像头,device index={camera_index}")

cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1280)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 720)
cap.set(cv2.CAP_PROP_FPS, 30)

actual_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
actual_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
actual_fps = cap.get(cv2.CAP_PROP_FPS)

print(f"backend={cap.getBackendName()}")
print("requested=1280x720@30")
print(f"actual={actual_width}x{actual_height}@{actual_fps:.2f}")
print("press Esc to quit")

try:
    while True:
        ok, frame = cap.read()
        if not ok:
            print("读取摄像头帧失败")
            break

        cv2.imshow("Camera", frame)

        # waitKey 既读取按键,也让 HighGUI 处理窗口事件。
        if cv2.waitKey(1) & 0xFF == 27:
            break
finally:
    cap.release()
    cv2.destroyAllWindows()

预期输出

text
backend=<BACKEND>
requested=1280x720@30
actual=<WIDTH>x<HEIGHT>@<FPS>
press Esc to quit

<BACKEND>、<WIDTH>、<HEIGHT> 和 <FPS> 由系统、驱动和摄像头能力决定,实际值可能不同。验收标准是窗口持续刷新真实画面,按 Esc 后摄像头指示灯熄灭或设备被释放,且程序正常结束。

打不开时按层定位

先排除最常见的四类问题:编号错误、设备被占用、系统没有授权摄像头、默认视频后端与驱动组合不兼容。Windows 可检查“设置 > 隐私和安全性 > 相机”,macOS 可检查“系统设置 > 隐私与安全性 > 相机”;Linux 则先确认系统确实枚举出 /dev/video0 等设备节点。

OpenCV 4.x 允许显式指定后端。Windows 常见 cv2.CAP_DSHOW 或 cv2.CAP_MSMF,Linux 常见 cv2.CAP_V4L2,macOS 常见 cv2.CAP_AVFOUNDATION;只有当前 OpenCV 构建包含对应后端时才可用。默认 CAP_ANY 已能工作时,不必强制指定。

若 isOpened() 为真但 read() 持续失败,优先把请求分辨率降到 640×480,并关闭其他摄像头程序后重试。若低分辨率能工作而高分辨率失败,通常说明设备、驱动或 USB 带宽不支持当前采集模式,而不是读取循环本身有问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

访问摄像头画面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通