摄像头
预览罗技摄像头,并调节设备级 UVC 图像参数与预设。
OpenLogi 通过 USB Video Class(UVC)驱动罗技摄像头,并把它们和鼠标、键盘一起显示在首页设备列表里。
任何罗技 USB 摄像头(Brio、StreamCam、C920、C922、C930e、C270……)都是标准 UVC 设备,因此识别只依据罗技厂商 ID,而不维护型号表,插上就能看到。
摄像头的详情页以 Camera 标签页开头,包含实时预览与图像控制:
- 镜头 —— 变焦、对焦、曝光,摄像头支持时各带一个 Auto 开关。
- 图像 —— 亮度、对比度、饱和度、锐度、白平衡、色调。
- 抗闪烁与低光补偿 —— 在 macOS 和 Linux 上,当摄像头报告相应控制项时可用。 抗闪烁提供设备支持的电源频率模式;低光补偿在设备报告二值范围时显示为开关。 Windows 后端尚未实现这两个控制项。
- 预设 —— Default、Streaming、Video call 三个内置预设,外加你自己保存的预设;重新打开该页时会高亮上次应用的那个。
这些都是设备级的 UVC 控制:改动落在摄像头自己的寄存器里,因此 Zoom、Meet、OBS 等所有应用都会看到,而不只是预览窗口。
预览与摄像头访问
只有预览标签页可见时才打开视频流。离开标签页、返回首页或选择其他设备都会释放视频流, OpenLogi 不会在后台继续运行摄像头。
如果其他应用正在使用摄像头的视频流,请先停止,再打开预览。启动失败时会显示错误; 只要预览页仍可见,OpenLogi 就会重试。摄像头忙碌的错误也可能表示系统资源不可用, 不能单凭它断言摄像头被其他应用占用。
在 macOS 上,点击预览区的权限提示,为 OpenLogi 请求并允许摄像头访问。 应用可能要先发起请求,才会出现在「系统设置 → 隐私与安全性 → 摄像头」中。 这项授权与代理的 HID / 输入权限相互独立;读写 UVC 控制项不需要摄像头权限。
保存设置
保存的取值位于该摄像头的设备条目下:
[devices."<camera-key>".camera_controls]
brightness = 128
contrast = 32
[devices."<camera-key>".camera_profiles."Streaming"]
brightness = 140
saturation = 160可以在首页为同型号的摄像头设置不同名称。没有 USB 序列号的摄像头使用系统采集 ID 保存身份; 换到另一个 USB 端口后,可能需要重新命名和配置。
Litra 补光灯可以随摄像头活动自动开关,详见 Litra 补光灯。
状态: 摄像头的采集与控制在 macOS(AVFoundation + IOKit UVC)、Windows(Media Foundation +
DirectShow)与 Linux(经 uvcvideo 的 V4L2)上都有完整后端。