OpenLogi

摄像头

预览罗技摄像头,并调整设备级 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 控制后端。

本页目录