76 lines
3.9 KiB
C
76 lines
3.9 KiB
C
/*
|
||
* meow_ui_sys.h — SDK 内置系统状态读取器 + 全局状态栏（A-0 核心）。
|
||
*
|
||
* 供 meow_ui 内部各 TU 协作（绘制后端 present() 前置覆盖 + 输入层事件循环 1s 轻刷）。
|
||
* 不随 meow_ui.h 发布给应用。应用侧只通过公共 API 控制显隐/全屏：
|
||
* meow_ui_set_statusbar() / meow_ui_statusbar_visible() /
|
||
* meow_ui_set_fullscreen() / meow_ui_statusbar_height()。
|
||
*
|
||
* 数据源与 launcher 的 meow_sys 同源单点一致：
|
||
* - 电量 /sys/class/power_supply/battery/{capacity,status}
|
||
* - WiFi /sys/class/net/wlan0/operstate
|
||
* - 蓝牙 实际 powered（hciconfig -a hci0 的 UP；spawn 贵 → 缓存 30s 刷一次）
|
||
* - 音量 /usr/data/meow/settings.conf 的 audio.volume（launcher 同文件；
|
||
* 0-100 并 clamp 到 audio.volume_max 上限，与 launcher vol_clamp 口径一致）
|
||
* - 时钟 localtime_r（每秒在绘制时现取）
|
||
*/
|
||
#ifndef MEOW_UI_SYS_H
|
||
#define MEOW_UI_SYS_H
|
||
|
||
#include "meow_ui.h"
|
||
|
||
/* 系统快照（状态栏数据源）。时钟不走这里——绘制时现取 localtime。 */
|
||
typedef struct meow_sys_state {
|
||
int batt; /* 电量 %；-1=未知 */
|
||
int charging; /* 1=充电/满 */
|
||
int wifi_on; /* operstate==up */
|
||
int bt_seen; /* hci0 节点存在 */
|
||
int bt_on; /* 实际上电（hciconfig UP） */
|
||
int vol; /* 音量 0-100 */
|
||
} meow_sys_state;
|
||
|
||
/* 顶部状态栏几何（与 launcher SB_BAR_H=28 / SB_FONT=20 对齐，视觉统一）。
|
||
* 高度 40→28（用户定），字号 28→20（28px 栏放不下 28 号；20 号按 (高-行高)/2 垂直居中）。 */
|
||
#define MUI_SBAR_H 28
|
||
#define MUI_SBAR_FONT 20
|
||
|
||
/* 收合（collapsed）状态下状态栏的有效加载高度（inset）= 顶部提示线高度（px）。
|
||
* 收合=状态栏内容上移出屏、只留一条提示线：app 内容据此上移（非满 28），
|
||
* 形成「不完全沉浸（留提示线）」；与 fullscreen（整条隐藏、inset0）区别。
|
||
* 取值沿用公共宏 MEOW_SBAR_HOTZONE_FS（=4，全屏时顶部热区/提示线的缩后高度），
|
||
* 具体绘制高度（gfx.c 的 MUI_SBAR_HINT_H=6）在渲染端，这里按提示线高度口径即可。 */
|
||
#define MUI_SBAR_COLLAPSE_H MEOW_SBAR_HOTZONE_FS
|
||
|
||
/* 首次全量读取；失败仍返回 0（字段置 -1/0）。 */
|
||
int meow_ui_sys_init(void);
|
||
|
||
/* 1s 轻刷：电量/WiFi/音量（便宜）；蓝牙 30s 缓存刷新。 */
|
||
void meow_ui_sys_refresh(void);
|
||
|
||
/* 当前快照（内部只读）。 */
|
||
const meow_sys_state *meow_ui_sys_get(void);
|
||
|
||
/* 状态栏是否应绘制（= set_statusbar(1) 且 非 fullscreen），收合（collapsed）兼容：
|
||
* collapsed 视为状态栏仍在（只留提示线），故 collapsed 时即使 fullscreen 也返回 1，
|
||
* 让渲染端/输入层继续驱动上收动画与提示线；fullscreen 且不 collapsed → 0（整条隐藏，
|
||
* 沉浸，保持既有语义）。 */
|
||
int meow_ui_sys_statusbar_active(void);
|
||
|
||
/* 状态栏有效高度（px，供 inset/提示条定位）：active 时 28；collapsed 时=提示线高度
|
||
* MUI_SBAR_COLLAPSE_H（非满 28，app 内容可上移）；否则 0（供 meow_ui_statusbar_height 用）。 */
|
||
int meow_ui_sys_statusbar_height(void);
|
||
|
||
/* 系统级「下拉展开通知中心」手势挂钩（M2.5x 接线）：输入层识别出「起始于顶部热区的
|
||
* SWIPE_DOWN」后路由到这里。通知中心 UI 为后续里程碑，此入口作记录/占位；届时由对应
|
||
* 代理在此挂真实展开逻辑（IPC SHOW_ACTIVITY / 覆盖层渲染）。 */
|
||
void meow_ui_sys_notif_pull(void);
|
||
|
||
/* 自上次渲染后状态栏数据是否已变（1s 轻刷/显隐切换置位）；读取即清除。
|
||
* 渲染后端 present() 用它决定是否重画顶部条（配合脏区/整帧判断）。 */
|
||
int meow_ui_sys_statusbar_force(void);
|
||
|
||
/* 把状态栏画进 back_buf（顶部 MUI_SBAR_H 行）+ 标脏。调用方负责随后上屏。 */
|
||
void meow_ui_sys_statusbar_render(void);
|
||
|
||
#endif /* MEOW_UI_SYS_H */
|