屏幕提示

OpenLogi 通过自己的覆盖层显示短暂提示。提示不使用操作系统的通知服务。

控件与配置

打开设置（Settings），然后选择通用（General）。这里可以控制两种可配置提示：

• 低电量提示（Low battery notifications）控制低电量卡片。默认开启。
• 锁定键提示（Lock key notifications）控制锁定键指示器。默认开启。

键盘背光指示器没有设置开关。它也没有应用级配置项。

在 [app_settings] 中使用 low_battery_notifications。 使用 lock_key_notifications 设置锁定键提示开关。

低电量

已连接设备符合以下任一条件时，OpenLogi 会显示低电量卡片：

• 电量为 20% 或更低，且设备没有充电。
• 设备没有上报百分比，但上报了低电量或严重低电量级别。

卡片显示设备名称。设备上报百分比时，卡片也显示百分比。卡片显示 8 秒后消失，点击卡片也会隐藏它。覆盖层最多同时显示 3 张卡片，较新的卡片优先显示。

OpenLogi 对每次放电只提示一次。设备开始充电时，OpenLogi 会重新启用提示。设备上报 30% 或更高电量时，OpenLogi 也会重新启用提示。设备上报良好或满电级别时，OpenLogi 同样会重新启用提示。

当你关闭开关时，OpenLogi 仍会记录充电状态。因此，重新开启开关后，下一次低电量仍可提示。

这是 OpenLogi 的覆盖层窗口，不是操作系统通知。它不需要操作系统授予通知权限。

锁定键

具有 0x4220 LockKeyState 的键盘可以上报锁定键变化。只有锁定键提示开启时，OpenLogi 才会显示以下变化：

• Caps Lock 在 macOS、Linux 和 Windows 上显示。
• Num Lock 和 Scroll Lock 仅在 Linux 和 Windows 上显示。
• Fn 锁定（Fn Lock）永不显示。

OpenLogi 不会提示键盘连接时上报的状态。之后发生变化时，OpenLogi 会在屏幕中央显示指示器 1.5 秒。新的变化会替换已显示的指示器。

指示器是深色卡片，其中显示锁定键状态文本。锁定键开启时，按键图标为蓝色。锁定键关闭时，按键图标为灰色。

键盘背光级别

具有 0x1982 backlight 的键盘会发送硬件背光变化事件。你调节键盘背光后，如果背光处于点亮状态，OpenLogi 会在屏幕中央显示指示器 1.5 秒。

指示器显示背光（Backlight）、当前级别和设备上报的最大级别。蓝色进度条表示当前级别。新的背光事件会替换当前指示器，并重新开始 1.5 秒计时。

没有设置可控制此指示器。软件关闭背光、电池严重低电量或环境光过亮时，指示器会关闭。没有背光功能的键盘不会发送此事件，因此 OpenLogi 不会为它显示背光级别指示器。

屏幕位置

在 Wayland 以外的环境中，OpenLogi 会优先使用指针所在的屏幕。如果无法取得指针位置，OpenLogi 会使用主显示器。低电量卡片显示在屏幕底部中央。在 macOS 上，卡片显示在程序坞上方。在 Windows 上，卡片显示在任务栏上方。

在 Wayland 上，OpenLogi 会先请求底边的 layer-shell 表面。如果合成器不支持 layer-shell，OpenLogi 会打开普通窗口。合成器决定普通窗口的位置。

锁定键和背光指示器是居中的弹出窗口。代码没有显式选择显示器。因此，OpenLogi 不保证它们在多显示器环境中的位置。

在配置中

schema_version = 9

[app_settings]
low_battery_notifications = true
lock_key_notifications = true

完整配置说明见配置。

**状态：**macOS、Linux 和 Windows 均可用。锁定键提示需要 0x4220 LockKeyState。背光级别提示需要 0x1982 backlight。