摄像头
预览罗技摄像头,并调整设备级 UVC 控制项、预设和已保存的设置。
OpenLogi 可识别罗技 USB Video Class(UVC)摄像头,并在摄像头(Camera)标签页中提供设备控制项。它通过罗技的 USB 厂商 ID 0x046d 识别摄像头,而不使用型号列表。
多数摄像头使用 USB 产品字符串作为名称。如果已知摄像头未报告 USB 产品字符串,OpenLogi 会提供注册表名称。
摄像头控制
选择摄像头并打开摄像头(Camera)。摄像头控制(Camera controls)面板只显示已连接摄像头报告的控制项。每个范围和默认值均来自该摄像头。
| 控制项 | UVC 控制项 | 自动切换 | 说明 |
|---|---|---|---|
| 变焦(Zoom) | CT_ZOOM_ABSOLUTE_CONTROL | / | 镜头控制项。 |
| 水平转动(Pan) | CT_PANTILT_ABSOLUTE_CONTROL | / | 与 垂直转动(Tilt)共用一个选择器。 |
| 垂直转动(Tilt) | CT_PANTILT_ABSOLUTE_CONTROL | / | 与 水平转动(Pan)共用一个选择器。 |
| 对焦(Focus) | CT_FOCUS_ABSOLUTE_CONTROL | 自动(Auto):CT_FOCUS_AUTO_CONTROL | 移动滑块会将此控制项切换到手动模式。 |
| 曝光(Exposure) | CT_EXPOSURE_TIME_ABSOLUTE_CONTROL | 自动(Auto):CT_AE_MODE_CONTROL | 移动滑块会将此控制项切换到手动模式。 |
| 防闪烁(Anti-flicker) | PU_POWER_LINE_FREQUENCY_CONTROL | / | 如果设备支持离散取值,则显示 50 Hz、60 Hz 或 自动(Auto)。Windows 不提供此项。 |
| 低光补偿(Low light compensation) | CT_AE_PRIORITY_CONTROL | / | 0–1 范围显示为二元开关。Windows 不提供此项。 |
| 亮度(Brightness) | PU_BRIGHTNESS_CONTROL | / | 图像控制项。 |
| 对比度(Contrast) | PU_CONTRAST_CONTROL | / | 图像控制项。 |
| 饱和度(Saturation) | PU_SATURATION_CONTROL | / | 图像控制项。 |
| 锐度(Sharpness) | PU_SHARPNESS_CONTROL | / | 图像控制项。 |
| 增益(Gain) | PU_GAIN_CONTROL | / | 图像控制项。 |
| 背光补偿(Backlight compensation) | PU_BACKLIGHT_COMPENSATION_CONTROL | / | 图像控制项。 |
| 白平衡(White balance) | PU_WHITE_BALANCE_TEMPERATURE_CONTROL | 自动(Auto):PU_WHITE_BALANCE_TEMPERATURE_AUTO_CONTROL | 移动滑块会将此控制项切换到手动模式。 |
| 色调(Tint) | PU_HUE_CONTROL | / | Linux 没有对应的标准 V4L2 控制项。 |
改动会写入摄像头的 UVC 控制项。其他打开该摄像头的应用也能观察到相同的图像设置。
设置精确值
点击滑块右侧的数值。OpenLogi 会打开设置亮度(Set Brightness)等对话框,并显示摄像头的支持范围:(Supported range)。
输入摄像头报告为受支持的值。如果值超出范围,或不在受支持的离散取值中,对话框会保持打开,摄像头不会改变。
预设和恢复默认值
默认(Default)会把每个显示的控制项和自动模式恢复为摄像头报告的默认值。直播(Streaming)和视频通话(Video call)会设置相对范围的亮度、对比度、饱和度和锐度。
直播(Streaming)和视频通话(Video call)会启用摄像头报告的每个自动模式。你可以把当前控制项和自动模式的值保存为自定义预设。最后应用的预设会保持选中状态。
使用恢复默认值(Reset to defaults)可在一次操作中恢复所有显示的控制项和自动模式。双击控制项所在行可把该控制项恢复为设备默认值。
预览和平台行为
实时预览只在摄像头(Camera)标签页可见时运行。离开该标签页、返回首页或选择其他设备都会关闭视频流。
如果视频流无法启动,预览会显示错误。只要标签页保持可见,OpenLogi 每 2 秒重试一次。资源错误可能表示其他应用正在使用摄像头,但不能据此确定原因。
实时预览支持 macOS、Windows 和 Linux。其他平台会显示:「实时预览暂不支持此平台。」
在 macOS 上,选择预览中的点击以启用摄像头访问。。然后允许 OpenLogi 使用摄像头。OpenLogi 在首次请求访问前,可能不会出现在「系统设置 → 隐私与安全性 → 摄像头」中。
摄像头权限只控制预览。读取和写入 UVC 控制项使用独立的 USB 路径,因此不需要此权限。
Linux 和 Windows
Linux 通过内核的 uvcvideo 驱动使用 V4L2。访问权限取决于摄像头的 /dev/video* 节点,因此 Linux 没有按应用显示的摄像头权限提示。
罗技 Brio 在 Linux 上可暴露彩色和红外捕获节点。OpenLogi 会将两个节点合并为一个摄像头条目,并选择彩色节点。
Windows 通过 DirectShow 映射镜头和图像控制项。它不提供防闪烁(Anti-flicker)或低光补偿(Low light compensation)。
名称和已保存的设置
具有 USB 序列号的摄像头会使用基于序列号的设备键保存控制项和预设。没有 USB 序列号的摄像头没有唯一且跨端口稳定的身份。
对于无序列号的摄像头,custom_name 会跟随操作系统捕获 ID。把此摄像头移到另一个 USB 端口后,可能需要再次命名。
配置文件中的内容
OpenLogi 会在摄像头的物理设备键下保存控制项和自定义预设。此示例使用 USB 序列号为 1234abcd 的摄像头。
[devices."camera:046d:0893:serial:1234abcd".camera_controls]
brightness = 128
focus_auto = 1
[devices."camera:046d:0893:serial:1234abcd".camera_profiles."Custom 1"]
brightness = 140
focus_auto = 0完整的架构和 OpenLogi 已生成的设备键,参见配置参考。
**状态:**摄像头控制和实时预览支持 macOS、Windows 和 Linux。其他平台没有摄像头采集或 UVC 控制后端。