计算机视觉 / 系统课时

打开本地摄像头

打开本地摄像头

本课使用 OpenCV 连接默认或指定摄像头,持续读取图像帧并显示实时预览。完成后,你将能够判断设备是否成功打开、处理单帧读取失败,并在退出时正确释放摄像头资源。

学习目标

  • 使用 cv2.VideoCapture 打开默认或指定摄像头
  • 根据 isOpened() 与 read() 的返回值判断设备和帧状态
  • 在程序结束时释放设备并关闭预览窗口

打开设备并循环读取

摄像头通常用整数索引标识,0 表示系统识别到的第一个摄像头,1、2 依次表示其他设备。创建 VideoCapture 后应先调用 isOpened(),避免在设备不存在、被占用或权限被拒绝时进入无效循环。

下面的程序可通过命令行参数选择摄像头。保存为 camera_preview.py,运行 python camera_preview.py --camera 0。运行前需安装 opencv-python,并允许终端或 Python 访问摄像头。

python
import argparse

import cv2

def main() -> None:
    parser = argparse.ArgumentParser(description='Open a local camera')
    parser.add_argument('--camera', type=int, default=0, help='camera index')
    args = parser.parse_args()

    cap = cv2.VideoCapture(args.camera)
    if not cap.isOpened():
        raise RuntimeError(f'无法打开摄像头,索引:{args.camera}')

    width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
    height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
    print(f'摄像头已打开:index={args.camera}, size={width}x{height}')

    frame_count = 0
    try:
        while True:
            ok, frame = cap.read()
            if not ok or frame is None:
                print('读取图像帧失败,循环结束')
                break

            frame_count += 1
            cv2.imshow('Camera Preview - press q to quit', frame)

            # waitKey 同时处理窗口事件;按 q 主动退出预览。
            if cv2.waitKey(1) & 0xFF == ord('q'):
                print(f'用户退出,已读取 {frame_count} 帧')
                break
    finally:
        # 无论正常退出还是发生异常,都要归还摄像头资源。
        cap.release()
        cv2.destroyAllWindows()

if __name__ == '__main__':
    main()

预期结果

text
摄像头已打开:index=0, size=<WIDTH>x<HEIGHT>
用户退出,已读取 <FRAME_COUNT> 帧

同时会出现实时预览窗口。<WIDTH>、<HEIGHT> 和 <FRAME_COUNT> 由设备、分辨率设置和运行时长决定,实际值可能不同。

理解两个状态检查

isOpened() 检查视频捕获对象是否成功连接到设备,但它不保证后续每一帧都能读取成功。设备临时断开、驱动异常或摄像头被系统回收时,read() 仍可能返回 False。

read() 返回 (ok, frame)。只有 ok 为 True 且 frame 不是 None 时,当前帧才可继续处理。实时程序不应假设摄像头会永久稳定输出。

正确退出与资源释放

cap.release() 会释放摄像头句柄,使其他应用能够再次使用设备;cv2.destroyAllWindows() 用于关闭 OpenCV 创建的窗口。把这两个调用放在 finally 中,可以覆盖按键退出、读取失败和运行时异常等路径。

cv2.waitKey(1) 不只是等待按键,它还负责处理预览窗口事件。若省略,窗口可能无响应。批处理环境没有图形桌面时,应移除 imshow() 与 waitKey(),只保留读取和业务处理逻辑。

常见失败处理

  • isOpened() 为 False:确认索引是否正确,并关闭可能占用摄像头的会议或录屏软件。
  • 系统提示权限不足:在 Windows、macOS 或 Linux 的隐私与设备权限中允许当前应用访问摄像头。
  • 打开速度慢或黑屏:先更换摄像头索引;Windows 下还可尝试在创建对象时指定 cv2.CAP_DSHOW 后端。
  • 远程服务器运行失败:多数服务器没有摄像头或图形桌面,应改用视频文件、网络流或无界面处理模式。

本课总结

  • 打开摄像头后先检查 isOpened(),每次取帧再检查 read()。
  • 实时预览循环必须提供明确退出条件,并处理设备中断。
  • 使用 finally 释放摄像头和窗口,避免资源长期占用。

下一课预告

下一课将使用同一个 VideoCapture 接口读取本地视频文件,并区分正常到达文件末尾与提前解码失败。

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

目录与阅读设置

阅读设置

17

记录一个想法

打开本地摄像头

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

登录哪都通