/**
 ****************************************************************************************************
 * @file        ui_home.h
 * @author      HiFi Player Project
 * @version     V1.2
 * @date        2026-01-01
 * @brief       主界面（iPhone 风格图标网格）界面接口
 *
 * 按键：K1 上一个图标 / K2 下一个图标 / K3 打开 / K0 切换应用（全局）
 ****************************************************************************************************
 */

#ifndef __UI_HOME_H
#define __UI_HOME_H

#include "lvgl.h"

#ifdef __cplusplus
extern "C" {
#endif

/** 创建主界面（只创建，不显示） */
void ui_home_create(void);

/** 显示主界面并复位内部状态 */
void ui_home_show(void);

/** 周期刷新显示 */
void ui_home_tick(void);

/** 处理本界面的功能键（K1/K2/K3）；K0 由 ui.c 统一处理 */
void ui_home_handle_key(uint8_t key);

/** 仅触发按键高亮（不做动作），供 K0 使用 */
void ui_home_flash(int key);

#ifdef __cplusplus
}
#endif

#endif /* __UI_HOME_H */