在Windows系统中使用OpenCV-Python禁用USB摄像头自动对焦

阿华AIGC实验室

2026-5-19

解决Windows下Python+OpenCV禁用Trust摄像头自动对焦的问题

我之前帮朋友处理过类似的Windows下OpenCV控制摄像头对焦的问题，给你几个实际可行的方向试试看：

1. 先确认摄像头是否支持OpenCV的自动对焦属性控制

有时候cap.set(cv.CAP_PROP_AUTOFOCUS, 0)无效，是因为当前摄像头或OpenCV后端不支持这个属性。你可以先运行这段代码验证一下：

import cv2 as cv

# 初始化摄像头
cap = cv.VideoCapture(0)
# 获取当前自动对焦状态
current_state = cap.get(cv.CAP_PROP_AUTOFOCUS)
print(f"当前自动对焦状态: {current_state}")
# 尝试禁用自动对焦
set_success = cap.set(cv.CAP_PROP_AUTOFOCUS, 0)
print(f"设置自动对焦禁用是否成功: {set_success}")
# 再次获取状态确认
new_state = cap.get(cv.CAP_PROP_AUTOFOCUS)
print(f"设置后的自动对焦状态: {new_state}")

cap.release()

如果set_success返回False，说明OpenCV默认的后端不支持对这个摄像头的对焦控制，接下来可以试试切换后端。

2. 切换OpenCV的VideoCapture后端

Windows下OpenCV有两个常用的摄像头后端：CAP_DSHOW（DirectShow）和CAP_MSMF（Media Foundation）。有些摄像头在特定后端下才能响应对焦指令，你可以分别试试：

# 尝试用DirectShow后端初始化
cap = cv.VideoCapture(0, cv.CAP_DSHOW)
# 或者用Media Foundation后端
# cap = cv.VideoCapture(0, cv.CAP_MSMF)

# 然后重复上面的验证代码，看设置是否生效
current_state = cap.get(cv.CAP_PROP_AUTOFOCUS)
print(f"当前自动对焦状态: {current_state}")
set_success = cap.set(cv.CAP_PROP_AUTOFOCUS, 0)
print(f"设置自动对焦禁用是否成功: {set_success}")
new_state = cap.get(cv.CAP_PROP_AUTOFOCUS)
print(f"设置后的自动对焦状态: {new_state}")

cap.release()

3. 直接调用Windows DirectShow API控制对焦

如果OpenCV的接口始终不行，可以用Python调用Windows原生的DirectShow API来控制摄像头。需要先安装comtypes库：

pip install comtypes

然后用这段代码尝试禁用自动对焦：

import comtypes
from comtypes.client import CreateObject, GetModule

# 加载DirectShow类型库
GetModule("{56a86891-0ad4-11ce-b03a-0020af0ba770}")
from comtypes.gen.DShowLib import (
    IAMCameraControl, CameraControl_Focus, CameraControl_Flags_Manual
)

def disable_camera_autofocus(device_index=0):
    # 创建系统设备枚举器
    enum_devs = CreateObject(
        "{860BB310-5D01-11D0-BD3B-00A0C911CE86}",
        interface="{62BE5D10-60EB-11D0-BD3B-00A0C911CE86}"
    )
    
    dev_idx = 0
    while True:
        try:
            dev = enum_devs.Next()
        except StopIteration:
            print("未找到指定索引的摄像头")
            break
        
        if dev_idx == device_index:
            # 获取摄像头控制接口
            try:
                cam_control = dev.QueryInterface(IAMCameraControl)
                # 设置为手动对焦模式（禁用自动对焦）
                hr = cam_control.Set(
                    CameraControl_Focus,
                    0,  # 手动对焦的数值，可根据需求调整
                    CameraControl_Flags_Manual
                )
                if hr == 0:
                    print("自动对焦已成功禁用")
                else:
                    print(f"设置失败，错误码: {hr}")
            except comtypes.COMError:
                print("该摄像头不支持手动对焦控制")
            break
        
        dev_idx += 1

if __name__ == "__main__":
    disable_camera_autofocus()

如果你的电脑有多个摄像头，需要调整device_index参数来匹配Trust摄像头的索引。