HiFi player project, first commit.

main/APP/ui_common.h

@@ -0,0 +1,114 @@
+/**
+ ****************************************************************************************************
+ * @file        ui_common.h
+ * @author      HiFi Player Project
+ * @version     V1.2
+ * @date        2026-01-01
+ * @brief       界面共用组件：配色、基础控件、底部按键提示条、按键高亮
+ *
+ * 所有 App 的界面都从这里取用公共资源，保证风格一致、代码不重复。
+ ****************************************************************************************************
+ */
+
+#ifndef __UI_COMMON_H
+#define __UI_COMMON_H
+
+#include <stdbool.h>
+#include <stdint.h>
+
+#include "lvgl.h"
+
+#include "app.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* ---------------- 屏幕 ---------------- */
+#define UI_HOR_RES          320
+#define UI_VER_RES          240
+#define UI_TICK_MS          50              /* 界面刷新 / 事件处理周期 */
+#define UI_KEY_FLASH_MS     400             /* 按键提示高亮持续时间 */
+
+/* ---------------- 配色 ---------------- */
+#define UI_COL_BG           0x0B0E17
+#define UI_COL_PANEL        0x151B2B
+#define UI_COL_CARD         0x1C2438
+#define UI_COL_CARD_SEL     0x233A5C
+#define UI_COL_TRACK        0x232C42
+#define UI_COL_ACCENT       0x4FC3F7
+#define UI_COL_ACCENT2      0x7C4DFF
+#define UI_COL_TEXT         0xF2F5FF
+#define UI_COL_SUB          0x8A93A8
+#define UI_COL_DIM          0x5A6076
+#define UI_COL_OK           0x3DDC84
+#define UI_COL_WARN         0xFFB020
+#define UI_COL_ERR          0xFF5C5C
+
+/* ---------------- 基础控件 ---------------- */
+
+/** 给屏幕设置统一的背景与内边距 */
+void ui_style_screen(lv_obj_t *scr);
+
+/** 创建一个无边框圆角容器 */
+lv_obj_t *ui_card(lv_obj_t *parent, lv_coord_t x, lv_coord_t y,
+                  lv_coord_t w, lv_coord_t h, uint32_t color, lv_coord_t radius);
+
+/** 创建标签 */
+lv_obj_t *ui_label(lv_obj_t *parent, const char *text,
+                   const lv_font_t *font, uint32_t color);
+
+/** 文本不同才更新，减少重绘 */
+void ui_label_set_if_changed(lv_obj_t *label, const char *text);
+
+/** 秒数 -> "mm:ss" */
+void ui_format_time(uint32_t seconds, char *buffer, size_t size);
+
+/* ---------------- 底部按键提示条 ---------------- */
+
+typedef struct {
+    lv_obj_t *card[APP_KEY_NUM];
+    lv_obj_t *icon[APP_KEY_NUM];
+    lv_obj_t *caption[APP_KEY_NUM];
+    bool      enabled[APP_KEY_NUM];
+    int       highlight;                    /* 当前高亮按键，-1 表示无 */
+} ui_key_bar_t;
+
+/**
+ * @brief  创建 4 个按键提示卡片（横向一排，位于屏幕底部）
+ * @param  symbols  LV_SYMBOL_xxx 图标，可为 NULL
+ * @param  captions 卡片底部说明文字
+ * @param  enabled  该按键在当前界面是否可用（不可用显示为灰色）
+ */
+void ui_key_bar_create(lv_obj_t *parent, ui_key_bar_t *bar,
+                       const char *const symbols[APP_KEY_NUM],
+                       const char *const captions[APP_KEY_NUM],
+                       const bool enabled[APP_KEY_NUM]);
+
+/** 设置某个按键的高亮状态（-1 表示全部取消） */
+void ui_key_bar_set_highlight(ui_key_bar_t *bar, int index);
+
+/** 修改某个按键的图标（例如播放/暂停切换） */
+void ui_key_bar_set_icon(ui_key_bar_t *bar, int key, const char *symbol);
+
+/** 修改某个按键的说明文字 */
+void ui_key_bar_set_caption(ui_key_bar_t *bar, int key, const char *caption);
+
+/* ---------------- 按键高亮闪动 ---------------- */
+
+typedef struct {
+    int32_t  key;                           /* 上次触发的按键，-1 表示无 */
+    uint32_t tick;                          /* 触发时刻（lv_tick_get） */
+} ui_flash_t;
+
+/** 记录一次按键，用于 400ms 高亮 */
+void ui_flash_trigger(ui_flash_t *flash, int key);
+
+/** 返回当前应当高亮的按键（超时或未触发返回 -1） */
+int ui_flash_active(const ui_flash_t *flash);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __UI_COMMON_H */