OpenLogi

补光灯与摄像头

控制 Litra 补光灯的开关、亮度与色温,并调节罗技摄像头的 UVC 图像参数。

并非所有罗技外设都说 HID++。OpenLogi 还通过原始 HID 协议驱动独立补光灯,通过 USB Video Class(UVC)驱动摄像头,并把它们和鼠标、键盘一起显示在同一个设备轮播里。

Litra 补光灯

Litra Glow046d:c900)与 Litra Beam046d:c901)通过各自的原始 HID 接口识别。选中后会出现 Lighting 标签页:

  • 开关 —— 点亮 / 熄灭。
  • 亮度 —— 0100%,映射到灯自身的原生范围(Litra 为 20–250 流明)。
  • 色温 —— 2700–6500 K,步进 100 K。
  • 随摄像头自动点亮 —— 任一摄像头启用时点亮,摄像头停用时熄灭(macOS)。手动的开关选择与其它设置不受这一策略影响。
[devices."raw:046d:c900:ff43:0202:serial:YOUR-SERIAL".light]
enabled = true
auto_camera = true
brightness_percent = 65
temperature_kelvin = 4600

补光灯的配置键由原始 HID 路由加序列号组成。如果 HID 后端只为你的灯暴露了临时的系统节点身份,OpenLogi 不会为它持久化设置,openlogi light list 会打印它看到的 HID 元组与身份,是最快的判断方式。

摄像头

任何罗技 USB 摄像头(Brio、StreamCam、C920、C922、C930e、C270……)都是标准 UVC 设备,因此识别只依据罗技厂商 id,而不维护型号表,插上就能看到。

摄像头的详情页以 Camera 标签页开头,包含实时预览与图像控制:

  • 镜头 —— 变焦、对焦、曝光,摄像头支持时各带一个 Auto 开关。
  • 图像 —— 亮度、对比度、饱和度、锐度、白平衡、色调。
  • 预设 —— Default、Streaming、Video call 三个内置预设,外加你自己保存的预设;重新打开该页时会高亮上次应用的那个。

这些都是设备级的 UVC 控制:改动落在摄像头自己的寄存器里,因此 Zoom、Meet、OBS 等所有应用都会看到,而不只是预览窗口。

保存的取值位于该摄像头的设备条目下:

[devices."<camera-key>".camera_controls]
brightness = 128
contrast = 32

[devices."<camera-key>".camera_profiles."Streaming"]
brightness = 140
saturation = 160

实时预览与抓拍需要摄像头权限。在 macOS 上请到「系统设置 → 隐私与安全性 → 摄像头」授予;读写 UVC 控制项则不需要该权限。

状态: 只要原始 HID 可用,Litra 控制就可用:macOS、Linux、Windows 均支持,随摄像头自动点亮的策略目前限 macOS。摄像头的采集与控制在 macOS(AVFoundation + IOKit UVC)、Windows(Media Foundation + DirectShow)与 Linux(经 uvcvideo 的 V4L2)上都有完整后端。

本页目录