使用Python和OpenCV多摄像头时如何确定VideoCapture端口？

问题核心 #

用Python+OpenCV调用3个摄像头时，依赖固定端口号（0、1、2...）区分设备的方式不可靠。原本预期0对应内置摄像头、外接摄像头从1开始，但实际场景中内置摄像头的端口号经常不是0，甚至出现传入0启动外接摄像头、不传0反而启动内置摄像头的颠倒情况。

原因 #

Windows系统中，视频设备的端口号由系统枚举顺序决定，和设备连接顺序、驱动加载优先级、重启后的设备识别顺序有关，硬编码端口号必然导致设备匹配不稳定。

解决方法：通过设备名称识别摄像头 #

放弃硬编码端口号，改为枚举所有可用视频设备，通过设备名称区分内置/外接摄像头，示例代码如下：

import cv2

def scan_available_cameras():
    camera_info = {}
    # 枚举0到10的端口（可根据实际设备数量调整范围）
    for port in range(10):
        cap = cv2.VideoCapture(port, cv2.CAP_DSHOW)
        if cap.isOpened():
            # 获取设备名称（不同驱动返回格式可能有差异）
            device_name = cap.get(cv2.CAP_PROP_DEVICE_NAME)
            camera_info[port] = device_name
            cap.release()
    return camera_info

# 扫描所有可用摄像头
available_cameras = scan_available_cameras()
print("当前可用摄像头：")
for port, name in available_cameras.items():
    print(f"端口 {port}: {name}")

# 根据名称关键词匹配目标摄像头（示例：内置摄像头名称通常含"Integrated"或"内置"）
built_in_port = None
usb_camera_ports = []
for port, name in available_cameras.items():
    if "Integrated" in name or "内置" in name:
        built_in_port = port
    else:
        usb_camera_ports.append(port)

# 初始化目标摄像头
if built_in_port is not None:
    cap_built_in = cv2.VideoCapture(built_in_port, cv2.CAP_DSHOW)
    cap_built_in.set(cv2.CAP_PROP_FRAME_WIDTH, 1280)
    cap_built_in.set(cv2.CAP_PROP_FRAME_HEIGHT, 720)
    cap_built_in.set(cv2.CAP_PROP_FPS, 30)
    # 后续处理逻辑
    print("内置摄像头初始化完成")

for idx, port in enumerate(usb_camera_ports):
    cap_usb = cv2.VideoCapture(port, cv2.CAP_DSHOW)
    cap_usb.set(cv2.CAP_PROP_FRAME_WIDTH, 1280)
    cap_usb.set(cv2.CAP_PROP_FRAME_HEIGHT, 720)
    cap_usb.set(cv2.CAP_PROP_FPS, 30)
    print(f"外接摄像头{idx+1}初始化完成")

注意事项 #

• 不同摄像头驱动返回的设备名称格式可能不同，需要根据实际输出调整关键词匹配规则
• 枚举端口范围可根据实际设备数量灵活调整，一般0-10足以覆盖多数场景
• 保留cv2.CAP_DSHOW参数可避免Windows下的摄像头占用冲突问题

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