/**
 ****************************************************************************************************
 * @file        ui_player.h
 * @author      HiFi Player Project
 * @version     V1.2
 * @date        2026-01-01
 * @brief       播放器界面接口
 *
 * 按键：K0 返回主界面 / K1 播放暂停 / K2 下一曲 / K3 音量
 ****************************************************************************************************
 */

#ifndef __UI_PLAYER_H
#define __UI_PLAYER_H

#include <stdint.h>

#include "lvgl.h"

#ifdef __cplusplus
extern "C" {
#endif

/** 创建播放器界面（只创建，不显示） */
void ui_player_create(void);

/** 显示播放器界面并立即刷新一次 */
void ui_player_show(void);

/** 周期刷新界面数据（进度、音量、状态等） */
void ui_player_tick(void);

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

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

#ifdef __cplusplus
}
#endif

#endif /* __UI_PLAYER_H */