3、摄像头数据采集实战：使用OpenCV调用USB摄像头，设置分辨率与帧率

好，咱们进入真正的实战环节了。前两章我们把理论框架搭了起来，也配好了环境。这一章，我带你亲手把摄像头的数据抓进来。

说白了，整个流媒体链路的第一步，就是「看见」数据。摄像头如果调不对，后面编码推流全是白搭。我在早期做直播项目时，就吃过这个亏——摄像头参数没配好，画面卡顿、颜色发绿，排查了半天才发现是帧率设置没生效。

3.1 打开摄像头的基本操作

OpenCV 打开摄像头，靠的是 cv2.VideoCapture。这个函数接受一个设备索引号。对于 USB 摄像头，通常是 0、1、2……

import cv2

# 打开默认摄像头（通常是第一个 USB 摄像头）
cap = cv2.VideoCapture(0)

if not cap.isOpened():
    print("无法打开摄像头，请检查连接")
    exit()

print("摄像头已打开")

嗯，这里要注意：cap.isOpened() 一定要检查。我遇到过好几次，摄像头被其他程序占用了，或者驱动没装好，直接读取会报错。

读取帧的循环也很简单：

while True:
    ret, frame = cap.read()
    if not ret:
        print("读取帧失败")
        break
    
    cv2.imshow("Camera Feed", frame)
    
    # 按 'q' 键退出
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

你想想看，这个 cap.read() 返回两个值：ret 是布尔值，表示是否成功；frame 就是图像数据，是一个 NumPy 数组。OpenCV 默认用 BGR 格式，不是 RGB，这个后面编码时会用到。

3.2 设置分辨率：别被 API 骗了

很多新手会直接这样写：

cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1920)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 1080)

然后以为摄像头就输出 1080p 了。其实不一定。

为什么？因为 摄像头硬件支持的分辨率是有限的。你设置一个它不支持的参数，它不会报错，而是默默用最接近的默认值。我当年做安防项目时，就因为这个被坑过——明明设了 4K，结果拿到的还是 720p 的数据。

正确的做法是：设置之后，再读回来验证。

cap = cv2.VideoCapture(0)

# 设置目标分辨率
target_width = 1280
target_height = 720

cap.set(cv2.CAP_PROP_FRAME_WIDTH, target_width)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, target_height)

# 读取实际生效的分辨率
actual_width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
actual_height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))

print(f"目标分辨率: {target_width}x{target_height}")
print(f"实际分辨率: {actual_width}x{actual_height}")

if actual_width != target_width or actual_height != target_height:
    print("警告：摄像头不支持该分辨率，已自动降级")

3.3 帧率设置：更隐蔽的坑

帧率的设置逻辑和分辨率类似，但更隐蔽。

cap.set(cv2.CAP_PROP_FPS, 30)
actual_fps = cap.get(cv2.CAP_PROP_FPS)
print(f"目标帧率: 30, 实际帧率: {actual_fps}")

你会发现，很多 USB 摄像头 根本不支持通过 OpenCV 修改帧率。它们有自己的固件逻辑，你设了也白设。

我曾经在一个直播项目中，摄像头标称 60fps，但 OpenCV 读出来始终只有 15fps。查了半天，发现是 USB 带宽不够——摄像头在 1080p 下只能跑 15fps，降到 720p 才能到 30fps。

所以，帧率的验证不能只看 cap.get()，还要实际测量：

import time

def measure_fps(cap, num_frames=100):
    start = time.time()
    for _ in range(num_frames):
        ret, frame = cap.read()
        if not ret:
            break
    end = time.time()
    
    elapsed = end - start
    fps = num_frames / elapsed
    return fps

# 测量实际帧率
real_fps = measure_fps(cap, 50)
print(f"实际测量帧率: {real_fps:.2f} fps")

3.4 完整实战代码

把上面的知识点串起来，我写了一个完整的摄像头采集脚本。这个脚本我在多个项目中都用过，稳定可靠。

import cv2
import time

class CameraCapture:
    def __init__(self, device_id=0, width=1280, height=720, fps=30):
        self.cap = cv2.VideoCapture(device_id)
        if not self.cap.isOpened():
            raise RuntimeError(f"无法打开摄像头 {device_id}")
        
        # 设置参数
        self.cap.set(cv2.CAP_PROP_FRAME_WIDTH, width)
        self.cap.set(cv2.CAP_PROP_FRAME_HEIGHT, height)
        self.cap.set(cv2.CAP_PROP_FPS, fps)
        
        # 验证实际参数
        self.actual_width = int(self.cap.get(cv2.CAP_PROP_FRAME_WIDTH))
        self.actual_height = int(self.cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
        self.actual_fps_set = self.cap.get(cv2.CAP_PROP_FPS)
        
        print(f"实际分辨率: {self.actual_width}x{self.actual_height}")
        print(f"设置帧率: {self.actual_fps_set}")
    
    def measure_real_fps(self, num_frames=50):
        start = time.time()
        for _ in range(num_frames):
            ret, frame = self.cap.read()
            if not ret:
                return 0
        end = time.time()
        return num_frames / (end - start)
    
    def run(self):
        print("开始采集，按 'q' 退出")
        while True:
            ret, frame = self.cap.read()
            if not ret:
                print("读取失败")
                break
            
            # 在画面上显示分辨率信息
            info = f"{self.actual_width}x{self.actual_height}"
            cv2.putText(frame, info, (10, 30), 
                       cv2.FONT_HERSHEY_SIMPLEX, 1, (0, 255, 0), 2)
            
            cv2.imshow("Camera Capture", frame)
            
            if cv2.waitKey(1) & 0xFF == ord('q'):
                break
        
        self.cap.release()
        cv2.destroyAllWindows()

if __name__ == "__main__":
    camera = CameraCapture(device_id=0, width=1280, height=720, fps=30)
    
    # 测量实际帧率
    real_fps = camera.measure_real_fps(50)
    print(f"实际测量帧率: {real_fps:.2f} fps")
    
    camera.run()

3.5 常见问题与排查

我整理了一个表格，把最常见的摄像头问题列出来，方便你对照排查。

现象	可能原因	解决方案
无法打开摄像头	设备索引错误、驱动未安装、被其他程序占用	尝试索引 0/1/2；检查设备管理器；关闭其他摄像头应用
分辨率设置不生效	摄像头不支持该分辨率	用 cap.get() 验证；尝试标准分辨率
帧率远低于设定值	USB 带宽不足、分辨率过高、CPU 瓶颈	降低分辨率；换 USB 3.0 接口；关闭显示窗口测试
画面颜色异常	摄像头自动白平衡、自动曝光干扰	尝试关闭自动参数：cap.set(cv2.CAP_PROP_AUTO_WB, 0)
读取帧偶尔失败	USB 线缆松动、电磁干扰	换线；加屏蔽；降低帧率

3.6 知识体系：摄像头采集全流程

下面这张图，我把摄像头采集的完整流程画出来了。从设备打开到参数验证，再到帧读取和释放，每一步都有对应的 OpenCV API 和注意事项。

这张图把整个流程串起来了。你注意看左侧的「关键验证点」和「常见坑点」——这些都是我踩过的坑，写出来让你少走弯路。

3.7 小结

这一章我们做了三件事：打开摄像头、设置参数、验证参数。听起来简单，但每一步都有细节。

• 打开摄像头：用 cv2.VideoCapture，记得检查 isOpened()
• 设置分辨率：用 cap.set()，但一定要用 cap.get() 验证是否生效
• 设置帧率：很多摄像头不支持修改，必须实际测量
• 完整脚本：我给你的 CameraCapture 类，可以直接用在项目中