Win11 C# UWP下UVC摄像头FocusControl不支持的对焦实现咨询

问题原因 #

mediaCapture.VideoDeviceController.FocusControl返回不支持是正常现象：该封装API仅适配了按照微软媒体基础（MF）规范上报对焦能力的设备，大量消费级UVC摄像头未做该层适配，哪怕硬件本身支持对焦，该属性也会返回false，官方CameraManualControls示例检测失败也是相同原因。

可用替代API #

UWP框架下无需依赖第三方库，可直接通过底层摄像头控制接口实现对焦，和OpenCV的对焦控制底层逻辑完全一致，都是走标准UVC控制通道：

方案1：调用标准UVC摄像头控制接口（优先尝试，覆盖90%以上免驱UVC摄像头） #

使用VideoDeviceController.CameraControls下的标准UVC控制项，不需要摄像头做微软专属适配：

// 获取标准UVC对焦控制项
var uvcFocusControl = mediaCapture.VideoDeviceController.CameraControls[KnownCameraControl.Focus];

if (uvcFocusControl.Capabilities.Supported)
{
    // 查询对焦支持的取值范围（手动对焦时使用）
    int minFocusVal = uvcFocusControl.Capabilities.Min;
    int maxFocusVal = uvcFocusControl.Capabilities.Max;
    int focusStep = uvcFocusControl.Capabilities.Step;

    // 开启自动对焦
    uvcFocusControl.TrySetAuto(true);
    
    // 如需手动设置对焦值，调用以下接口，传入min-max范围内的合法值即可
    // uvcFocusControl.TrySetValue(targetFocusValue);
}

方案2：自定义扩展单元控制（适用于厂商自定义控制协议的摄像头） #

如果上述标准控制项返回不支持，说明摄像头厂商将对焦能力放在了自定义UVC扩展单元中：

1. 从摄像头厂商处获取UVC控制协议文档，拿到扩展单元GUID、对焦功能对应的属性ID、参数格式
2. 使用MediaCapture.VideoDeviceController提供的GetDevicePropertyById、SetDevicePropertyById方法直接向摄像头发送控制指令即可，该接口可直接和UVC设备固件交互，无沙箱权限限制。

注意事项 #

• 不建议通过桌面桥接方式调用桌面版OpenCV、DirectShow接口实现对焦，UWP沙箱会拦截部分底层硬件访问，同时存在应用商店上架合规风险
• 所有MediaCapture相关的控制操作需在UI线程执行，后台线程调用可能出现无响应、调用失败的问题
• 部分硬件自带AF功能的UVC摄像头默认开启硬件自动对焦，不需要软件发送任何控制指令即可完成自动对焦。

内容的提问来源于stack exchange，提问作者Hyoungcheol Park