键盘
通过 HID++ 绑定罗技键盘控件,使用系统钩子重映射功能键,并管理键盘设置。
OpenLogi 提供两条互相独立的键盘绑定路径。选择键盘后,打开它的按键(Keys)标签页。该页会显示此设备可用的路径。
两种键盘绑定路径
| 属性 | HID++ 控件 | 系统钩子功能键 |
|---|---|---|
| 范围 | 一台上报可重编程控件的罗技键盘 | 本机接收的键盘事件 |
| 标识 | HID++ 0x1b04 16 位控件 ID | esc、f1–f19,可带修饰键 |
| 配置位置 | [devices."unit:6be9d300".bindings] | [keyboard.bindings] |
| 绑定作用域 | 按物理设备保存,应用配置文件可以覆盖 | 全局作用于本机 |
| GUI | 按键标签页显示带标记的 HID++ 控件 | 按键标签页回退到功能键行 |
| 平台 | macOS、Linux 与 Windows | macOS 与 Windows;Linux 不捕获键盘事件 |
在 GUI 中绑定按键
在按键标签页点击一个按键,会打开它的面板。面板列出与鼠标按键选择器相同的动作目录,另有高级功能(Power User)分区。选择一个动作即可完成绑定。

要清除绑定,选择原生功能(Native function),或再次选择当前已绑定的动作。两种方式都会删除覆盖设置,按键恢复原生行为。v0.8.15 的功能键面板没有恢复默认值(Reset to defaults)按钮。
HID++ 键盘控件
上报 HID++ 0x1b04 可重编程控件的罗技键盘,按 16 位控件 ID(CID)绑定按键。键盘图片带有控件标记时,按键(Keys)标签页会显示这些控件。否则,标签页会显示系统钩子功能键行。
你可以使用下表中的目录名,或对 openlogi diag controls 报告的任意可接管控件使用 control:0x<cid>。未绑定的控件保留固件动作。在 v0.8.15 中,已保存的 None 不表示未绑定。代理会接管并抑制该控件。要恢复固件动作,必须删除控件条目。
[devices."unit:6be9d300".bindings]
KeySearch = "MissionControl"
KeyCalculator = { CustomShortcut = "Cmd+Shift+C" }
"control:0x01f3" = "ShowActionsRing"控件目录
OpenLogi 为以下 43 个 HID++ 控件命名。键盘上报对应控件时,按键(Keys)标签页会使用本地化标签。
| 配置键 | 按键标签 | CID |
|---|---|---|
KeyBrightnessDown | 屏幕亮度减小键 | 0x00c7 |
KeyBrightnessUp | 屏幕亮度增大键 | 0x00c8 |
KeyBacklightDown | 背光减弱键 | 0x00e2 |
KeyBacklightUp | 背光增强键 | 0x00e3 |
KeyMissionControl | 调度中心键 | 0x00e0 |
KeyLaunchpad | 启动台键 | 0x00e1 |
KeyShowDesktop | 显示桌面键 | 0x006e |
KeySearch | 搜索键 | 0x00d4 |
KeyDictation | 听写键 | 0x0103 |
KeyEmoji | 表情符号键 | 0x0108 |
KeyScreenCapture | 截屏键 | 0x010a |
KeyPrintScreen | 截屏键(Print Screen) | 0x00bf |
KeyMicMute | 麦克风静音键 | 0x011c |
KeyPreviousTrack | 上一曲键 | 0x00e4 |
KeyPlayPause | 播放/暂停键 | 0x00e5 |
KeyPlayPauseTrack | 播放/暂停键(曲目) | 0x0141 |
KeyNextTrack | 下一曲键 | 0x00e6 |
KeyMute | 静音键 | 0x00e7 |
KeyVolumeDown | 音量减小键 | 0x00e8 |
KeyVolumeUp | 音量增大键 | 0x00e9 |
KeyCalculator | 计算器键 | 0x000a |
KeyLock | 锁定键 | 0x006f |
KeyDoNotDisturb | 勿扰模式键 | 0x011d |
KeyEmojiHeartEyes | 爱心眼表情键 | 0x0104 |
KeyEmojiCrying | 哭泣表情键 | 0x0105 |
KeyEmojiSmiley | 微笑表情键 | 0x0106 |
KeyEmojiTears | 笑哭表情键 | 0x0107 |
KeyLookUp | 查询键 | 0x00ea |
KeyAppSwitch | 切换应用键 | 0x0100 |
KeyAppSwitchLaunchpad | 切换应用/启动台键 | 0x0109 |
KeyHome | Home 键 | 0x0118 |
KeyEnd | End 键 | 0x0119 |
KeyPageUp | Page Up 键 | 0x011a |
KeyPageDown | Page Down 键 | 0x011b |
KeyMultiPlatformAppSwitch | 切换应用键(多平台) | 0x00ba |
KeyMultiPlatformHome | 主屏幕键(多平台) | 0x00bb |
KeyMultiPlatformMenu | 菜单键(多平台) | 0x00bc |
KeyMultiPlatformInsert | Insert 键(多平台) | 0x00be |
KeyLanguageSwitch | 切换输入语言键 | 0x00dd |
KeyCircle | 圆形键 | 0x01a3 |
KeyTriangle | 三角形键 | 0x01a4 |
KeyDiamond | 菱形键 | 0x01a5 |
KeyStar | 星形键 | 0x01a6 |
全局功能键重映射
系统钩子路径可重映射任意键盘上的 Escape 键和 F1 至 F19 键。这些绑定是全局的,因此不属于某台罗技设备,也不属于应用配置文件。触发器写作 [修饰键+]按键。有效修饰键为 shift、control(ctrl)、option(alt)和 command(cmd)。
固件不会把 Fn 作为普通按键修饰键上报,因此 Fn 不能作为触发器。在按键(Keys)面板选择原生功能(Native function),可以清除功能键绑定。GUI 会从 [keyboard.bindings] 删除该触发器。
[keyboard.bindings]
f1 = "MissionControl"
"shift+f2" = "ShowDesktop"
"cmd+f5" = { CustomShortcut = "Cmd+Shift+P" }操作列表包含操作环(Actions Ring)。其高级功能(Power User)分区可编辑输入文本…(Type Text…)和工作流…(Workflow…)动作。配置格式还支持用于即时按键组合的 CustomShortcut。完整说明见配置参考。
设备设置
选择键盘后,打开设备(Device)标签页。键盘卡片包含已连接键盘支持的设置。

Fn 锁定(Fn Lock)会使直接按下 F 区时发送 F1–F12。印刷功能随后改为 Fn + 按键。OpenLogi 支持 HID++ 0x40a3、0x40a2 与 0x40a0 Fn 反转功能,并会在键盘重连时重新应用已保存的设置。
保持系统布局(Keep OS layout)适用于暴露 HID++ 0x4531 的多平台键盘。启用后,代理会在键盘连接时为此计算机的操作系统设置键盘布局。键盘布局快捷键改变布局后,代理会再次设置布局。
相关键盘功能
Easy-Switch。Easy-Switch 通道保存已配对的电脑,并可与其他设备协调主机切换。详见 Easy-Switch。
键盘灯光。背光控制和静态 RGB 灯光独立于按键绑定。详见键盘灯光。
锁定键指示器。键盘上报状态变化时,OpenLogi 可以在屏幕上显示 Caps Lock、Num Lock 与 Scroll Lock。详见屏幕提示。
**状态:**键盘上报 0x1b04 specialKeysMSEButtons 时,HID++ 控件绑定可在 macOS、Linux 与 Windows 上使用。Fn 锁定使用 0x40a0 fnInversion、0x40a2 fnInversionWithDefaultState 或 0x40a3 fnInversionMultiHost。保持系统布局使用 0x4531 multiPlatform。全局功能键重映射可在 macOS 与 Windows 上使用。Linux 不捕获键盘事件。