MeowOS
ab4da09e75
meow_ui.a→3e0ee8f7 launcher→9d0efc2f hello→9609ea6e files→90f5cf07 ncm→be8be221(均已上卡); 真机截图证据 .tmp/meowbug/fix1.png+fix_b2_after.png
308 lines
15 KiB
C
308 lines
15 KiB
C
/* ncm_app_internal.h — dev.player.ncm 应用内部共享头（UI 各页 + app 装配层 + 宿主测试面）。
|
||
*
|
||
* 层级（对齐 hello_app/app.c 批② + files_app）：
|
||
* - app.c main + 装配 + 事件分发（把 meow_ui_run 的平铺回调路由到各页）
|
||
* - app/ui/<page>.c 每页一个 view 文件（login/home/playlist/player/settings）
|
||
* - app/ui/common/chrome.c 共享 chrome（topbar / 内容区几何 / 空态 / 提示）
|
||
* - app/logic/ appstate（全局 ctx/歌单/歌曲/播放态）+ lyric(LRC 解析) + cover(封面缓存)
|
||
* - app/play/ player_manager(播放线程) + audio_out(ALSA/文件输出) + ipc_media(媒体会话 IPC)
|
||
*
|
||
* 铁律（APPS.md §3.4.1 / WORK_STATE.md）：物理键禁映射——on_key 不处理任何键语义；
|
||
* 返回=左缘左滑（on_swipe LEFT）/返回钮/meow_ui_request_exit；左缘返回：播放页→歌单→主页→退出。
|
||
* 播放/网络/IPC 用独立线程，UI 不卡。媒体会话经 meow_ipc.h 帧格式最小客户端上报
|
||
* MSG_META + 收 MSG_PLAYCTL（SDK 尚无媒体封装，App 内实现）。
|
||
*/
|
||
#ifndef NCM_APP_INTERNAL_H
|
||
#define NCM_APP_INTERNAL_H
|
||
|
||
#include <stdint.h>
|
||
#include <stddef.h>
|
||
#include <pthread.h>
|
||
#include "meow_ui.h"
|
||
#include "meow_ui_view.h"
|
||
#include "ncm.h" /* 核心库伞头（ctx/api/login/cache/...） */
|
||
|
||
/* ---- Activity 归属（§6.1 ①）---- */
|
||
#define ACT_LOGIN 0 /* 扫码登录页（根，未登录） */
|
||
#define ACT_HOME 1 /* 我的歌单（根/主页，已登录） */
|
||
#define ACT_PLAYLIST 2 /* 歌单详情（曲目列表） */
|
||
#define ACT_PLAYER 3 /* 播放页（可横竖屏切，v1 允许切） */
|
||
#define ACT_SETTINGS 4 /* 设置页 */
|
||
#define ACT_SEARCH 5 /* 搜索页（顶栏搜索按钮进入） */
|
||
|
||
/* ---- 布局 ---- */
|
||
#define APP_W 480
|
||
#define APP_H 720
|
||
#define APP_TOPBAR_H 56
|
||
#define APP_ROW_H 56 /* 列表行高 */
|
||
#define APP_PAD 16
|
||
#define APP_OP_W 48 /* 行右侧操作区触达宽 */
|
||
#define APP_FOOTER_H 26
|
||
|
||
/* ---- 数据规模（内存纪律：歌单/歌曲大列表虚拟化显示，数组有界）---- */
|
||
#define NCM_PLAYLIST_MAX 120 /* 我的歌单上限 */
|
||
#define NCM_SONG_MAX 256 /* 单个歌单曲目上限（大歌单截断前 256 条） */
|
||
#define NCM_SONG_BATCH 64 /* song_detail 分批每批条数 */
|
||
#define NCM_PLAYLIST_PAGE 50 /* 歌单曲目服务端分页每页条数（/api/playlist/track/all） */
|
||
#define NCM_LYRIC_LINES 600 /* 歌词行上限 */
|
||
#define NCM_COVER_MAX 288*1024 /* 封面下载限幅 ~288KB */
|
||
#define NCM_SEARCH_MAX 32 /* 搜索结果上限（v1 只显示前 32 条，无大缓冲） */
|
||
|
||
/* ---- 播放/媒体会话状态（play 线程 ↔ UI/IPC 共享，mu 保护）---- */
|
||
enum {
|
||
NCM_PC_STOPPED = 0,
|
||
NCM_PC_PLAYING = 1,
|
||
NCM_PC_PAUSED = 2,
|
||
NCM_PC_BUFFER = 3, /* 缓冲/加载中 */
|
||
};
|
||
|
||
/* 播放器命令（IPC MSG_PLAYCTL cmd 一一对应）*/
|
||
enum {
|
||
NCM_CTL_PLAY = 1,
|
||
NCM_CTL_PAUSE = 2,
|
||
NCM_CTL_PREV = 3,
|
||
NCM_CTL_NEXT = 4,
|
||
NCM_CTL_SEEK = 5,
|
||
};
|
||
|
||
/* 跨线程播放运行时状态（main 只读展示；play 线程写，IPC 线程读）。 */
|
||
typedef struct ncm_play_run {
|
||
pthread_mutex_t mu;
|
||
int state; /* NCM_PC_* */
|
||
int cur_song; /* 当前曲目在 g_st.songs[] 下标；-1=无 */
|
||
int64_t pos_ms; /* 当前播放位置（播放进程推进，seek 写此） */
|
||
int64_t dur_ms; /* 当前曲目标称时长 */
|
||
int cmd; /* 暂存最新内部命令（play/pause/prev/next/seek）*/
|
||
int64_t cmd_seek_ms; /* cmd==SEEK 目标 */
|
||
int seq; /* 播放代际（每次 start 递增，用于区分过期信号）*/
|
||
int err; /* 最近一次播放错误（0=无） */
|
||
char errmsg[96];
|
||
int has_track; /* 当前是否有可播曲目（含 url 获取中） */
|
||
} ncm_play_run_t;
|
||
|
||
/* ---- 音质档位字符串（设置页 + 持久化用）---- */
|
||
extern const char *media; /* 占位 */
|
||
|
||
/* ---- App 全局状态（main 线程拥有；play 线程经 ncm_play_run 共享）---- */
|
||
typedef struct ncm_app_state {
|
||
ncm_ctx_t ctx; /* 核心库上下文（device_id/cookie/cache） */
|
||
char data_dir[512]; /* 数据目录（MeowData/dev.player.ncm/data） */
|
||
char cache_dir[512];
|
||
|
||
/* 登录 */
|
||
char unikey[64];
|
||
char qr_url[256];
|
||
unsigned char qr_mods[177*177]; /* QR 位图矩阵（1=暗） */
|
||
int qr_size;
|
||
int login_state; /* NCM_LOGIN_* */
|
||
int logged_in;
|
||
|
||
/* 账号 */
|
||
char uid[32];
|
||
char nickname[128];
|
||
|
||
/* 我的歌单 */
|
||
ncm_playlist_t playlists[NCM_PLAYLIST_MAX];
|
||
int playlist_count;
|
||
int active_playlist; /* 当前打开歌单的下标；-1=无 */
|
||
|
||
/* 当前歌单曲目（id 用 int64_t：网易云歌曲 id 可 >2^31，MIPS32 long 溢出） */
|
||
int64_t song_ids[NCM_SONG_MAX];
|
||
ncm_song_t songs[NCM_SONG_MAX];
|
||
int song_count;
|
||
|
||
/* 播放页视图态 */
|
||
int playing_song; /* 正在播放歌曲在 songs[] 下标（UI 侧缓存）；-1=无 */
|
||
meow_img *cover_img; /* 当前封面（解码后；UI 持有，play 线程不碰） */
|
||
char cover_url[512]; /* 当前封面 URL（playlist/song cover） */
|
||
|
||
/* 歌词（播放器加载后由 play 线程填充，UI 读）*/
|
||
pthread_mutex_t lyric_mu;
|
||
int lyric_line_count;
|
||
int cur_lyric_line;
|
||
|
||
/* 设置（持久化 MeowData/dev.player.ncm/data）*/
|
||
int level; /* NCM_LEVEL_* */
|
||
int cache_limit_gb;
|
||
|
||
/* 搜索（结果复用 g_st.songs[] 浅拷贝区；仅搜索页上下文有效）*/
|
||
char search_query[256];
|
||
int search_count; /* 当前搜索结果数（含 0=无/未搜） */
|
||
volatile int search_loading; /* 1=搜索请求在途 */
|
||
int search_err; /* 最近一次搜索错误（0=ok） */
|
||
} ncm_app_state_t;
|
||
|
||
extern ncm_app_state_t g_st; /* 全局状态（app.c 定义） */
|
||
extern ncm_play_run_t g_play; /* 播放运行态（app.c 定义） */
|
||
extern volatile int g_app_quit; /* 请求退出（线程停） */
|
||
extern volatile int g_net_ready; /* 网络/核心库线程安全可用 */
|
||
extern int g_host_mock; /* 1=宿主/测试：跳过网络，用预置数据 */
|
||
|
||
/* ---- App 侧调色板（ui/common/ncm_colors.c）----
|
||
* 品牌红 + 播放页/登录专属色。中性色由 meow_theme_get() 语义色提供。§3.2/§3.3/§5.4。 */
|
||
typedef struct ncm_pal {
|
||
uint32_t red; /* 主 accent：day #C20C0C / night #EC4141 */
|
||
uint32_t red_lit; /* 亮点变体：day #EC4141 / night #FF6A6A */
|
||
uint32_t red_ctr; /* 红底浅块：day #FBE9E9 / night #3A1919 */
|
||
uint32_t on_red; /* 红底前景（#FFFFFF） */
|
||
uint32_t on_red_dim; /* 红底次前景（白 ~88%，文本用） */
|
||
uint32_t hero; /* 登录 hero 深红压场：day #C20C0C / night #7A0E0E */
|
||
uint32_t player_bg; /* 播放页沉浸底：day #FFFDF9 / night #0C0D10 */
|
||
uint32_t disc; /* 黑胶盘体：day #1A1A1A / night #141414 */
|
||
uint32_t disc_edge; /* 盘缘槽纹：day #2A2A2A / night #232323 */
|
||
} ncm_pal_t;
|
||
extern int g_dark; /* 1=黑红(night) 0=白红(day) */
|
||
const ncm_pal_t *ncm_palette(int dark); /* dark==g_dark */
|
||
void ncm_on_theme(meow_theme_mode m); /* 主题侦听：明暗变化 → 整 App 重绘 */
|
||
void ncm_fill_round(int x, int y, int w, int h, int r, uint32_t color); /* 填充圆角矩形 */
|
||
void ncm_draw_button(int x, int y, int w, int h, const char *label,
|
||
uint32_t bg, uint32_t fg); /* App 侧品牌红/FILLED 按钮 */
|
||
int first_glyph(const char *s, char *out, size_t sz); /* 取首个 UTF-8 字形（头像首字） */
|
||
const char *ncm_text_fit(const char *s, int maxw, int size); /* 按宽裁剪（"..."结尾；静态缓冲） */
|
||
|
||
/* ---- 通用矩形 ---- */
|
||
typedef struct { int x, y, w, h; } ncm_rect_t;
|
||
#define NR(x,y,w,h) ((ncm_rect_t){ (x),(y),(w),(h) })
|
||
|
||
/* ---- chrome（ui/common/chrome.c）---- */
|
||
int ncm_statusbar(void);
|
||
ncm_rect_t ncm_topbar_rect(void);
|
||
ncm_rect_t ncm_content_rect(void);
|
||
meow_widget *ncm_topbar_create(const char *title, int back, const char *action_label);
|
||
void ncm_draw_empty(ncm_rect_t r, const char *kind, const char *what);
|
||
void ncm_draw_footer(ncm_rect_t r, const char *text);
|
||
void ncm_snack(const char *text); /* 底部 2s 提示条（非阻塞） */
|
||
void chrome_tick(void); /* 周期检查 snack 到期清除 */
|
||
|
||
/* ---- 页面（ui/<page>.c）---- */
|
||
/* login */
|
||
meow_view *login_view_create(void);
|
||
int login_is_active(void);
|
||
void login_on_tap(int x, int y);
|
||
void login_tick(uint64_t now);
|
||
int login_start(void); /* 触发 unikey 获取（宿主测试：无网络则返回） */
|
||
const char *login_status_str(int state);
|
||
|
||
/* home */
|
||
meow_view *home_view_create(void);
|
||
int home_is_active(void);
|
||
int home_on_tap(int x, int y);
|
||
void home_swipe(int dir, int dist);
|
||
void home_touch_down(int x, int y);
|
||
void home_touch_move(int x, int y);
|
||
void home_reload(void); /* 刷新我的歌单（后台 worker，非阻塞） */
|
||
void home_tick(uint64_t now); /* UI tick：检查歌单 worker 是否完成并刷新 */
|
||
int home_go_up(void); /* 左缘返回：到底则退出 */
|
||
|
||
/* playlist */
|
||
meow_view *playlist_view_create(void);
|
||
int playlist_is_active(void);
|
||
int playlist_on_tap(int x, int y);
|
||
void playlist_swipe(int dir, int dist);
|
||
void playlist_touch_down(int x, int y);
|
||
void playlist_touch_move(int x, int y);
|
||
void playlist_open(int idx); /* 打开第 idx 个歌单（下拉进歌单详情） */
|
||
void playlist_refresh(void);
|
||
void playlist_tick(uint64_t now);/* UI tick：检查歌单 worker 是否完成并刷新 */
|
||
|
||
/* player */
|
||
meow_view *player_view_create(void);
|
||
int player_is_active(void);
|
||
void player_on_tap(int x, int y);
|
||
void player_tick(uint64_t now); /* 播放进度/歌词滚动 */
|
||
void player_play_song(int idx); /* 从歌单第 idx 首开始播放 */
|
||
void player_pause_toggle(int on);
|
||
void player_next(int dir); /* dir=+1 下一首 / -1 上一首 */
|
||
void player_seek(int64_t ms);
|
||
void player_on_swipe(int dir, int dist); /* 横屏切换/返回 */
|
||
int player_set_screen(int landscape); /* 1=横屏 0=竖屏；返回之前 */
|
||
int player_screen(void);
|
||
|
||
/* settings */
|
||
meow_view *settings_view_create(void);
|
||
int settings_is_active(void);
|
||
int settings_on_tap(int x, int y);
|
||
void settings_swipe(int dir, int dist);
|
||
void settings_touch_down(int x, int y);
|
||
void settings_touch_move(int x, int y);
|
||
void settings_open(void); /* 进设置页 */
|
||
void settings_reload(void);
|
||
|
||
/* search */
|
||
meow_view *search_view_create(void);
|
||
int search_is_active(void);
|
||
int search_on_tap(int x, int y);
|
||
void search_swipe(int dir, int dist);
|
||
void search_touch_down(int x, int y);
|
||
void search_touch_move(int x, int y);
|
||
void search_open(void); /* 进搜索页 */
|
||
void search_submit(const char *kw); /* 用户确认后发起搜索（风控：仅在确认时发） */
|
||
void search_tick(uint64_t now); /* UI tick：检查搜索 worker 完成并刷新 */
|
||
|
||
/* ---- logic ---- */
|
||
int appstate_init(void); /* 初始化 ctx/data/cookie/设置；0=成功 */
|
||
void appstate_load_settings(void);
|
||
void appstate_save_settings(void);
|
||
void appstate_set_logged_in(const char *uid, const char *nickname);
|
||
void appstate_logout(void);
|
||
int appstate_ensure_uid(void); /* 若 uid 缺失则 login_status_check 取回；0=成功 */
|
||
int appstate_load_playlists(void); /* 拉我的歌单 */
|
||
int appstate_load_playlist_songs(int idx); /* 兼容：整批载入（内部走分页循环） */
|
||
int appstate_load_playlist_songs_page(int idx, int offset, int limit);
|
||
/* 服务端分页载入第 offset 页（offset=0 重头填，
|
||
* offset>0 追加到 g_st.songs[offset..]）；写 g_st.song_count */
|
||
void appstate_apply_playlist_cover(int idx);
|
||
void appstate_set_playing_song(int idx, const char *cover_url);
|
||
int appstate_current_playing(void); /* 返回当前播放歌曲下标（UI） */
|
||
|
||
/* lyric */
|
||
int lyric_parse(const char *lrc, const char *tlrc); /* 填充 g_lyric_* */
|
||
int lyric_line_at(int64_t ms); /* 当前行 */
|
||
const char *lyric_line_text(int i);
|
||
const char *lyric_line_tl(int i);
|
||
int lyric_count(void);
|
||
void lyric_clear(void);
|
||
int lyric_state(void); /* 0=空闲/未拉 1=加载中 2=已拉完（可能 0 行=无词） */
|
||
|
||
/* cover */
|
||
void cover_request(const char *url); /* 提交目标封面 URL（后台线程下载+解码） */
|
||
meow_img *cover_get(void); /* 当前封面（不拥有；NULL=无） */
|
||
int cover_changed(void); /* 1=有新封面待绘制（UI tick 判变） */
|
||
void cover_ack(void); /* UI 消费一次（已见当前版本） */
|
||
const char *cover_current_path(void); /* 封面原始文件路径（供 launcher 媒体卡片读）；NULL=无 */
|
||
void cover_cache_reset(void);
|
||
|
||
/* ---- play（app/play/）---- */
|
||
/* audio_out */
|
||
int audio_out_open(int sample_rate, int channels, int bits); /* 0=成功 */
|
||
int audio_out_write(const short *samples, int frames); /* <0=错误/结束 */
|
||
void audio_out_close(void);
|
||
void audio_out_set_target(int ms); /* 预留：缓冲目标 */
|
||
int audio_out_buffered_ms(void);
|
||
|
||
/* player_manager：播放线程（下载+解码+输出）驱动 */
|
||
int player_manager_start(void); /* 起播放线程；0=成功 */
|
||
void player_manager_stop(void); /* 停播（清曲目/置 STOPPED） */
|
||
void player_manager_stop_thread(void);/* 停线程（app 退出时 join） */
|
||
void player_manager_play(int song_idx); /* 加载并播放 */
|
||
void player_manager_pause(int on); /* on=1 暂停 */
|
||
void player_manager_next(int dir); /* dir=+1/-1 */
|
||
void player_manager_seek(int64_t ms);
|
||
void player_manager_set_quality(int level, int cache_gb);
|
||
int player_manager_state(void); /* NCM_PC_* */
|
||
int player_manager_playing_song(void);
|
||
int64_t player_manager_pos_ms(void);
|
||
int64_t player_manager_dur_ms(void);
|
||
int player_manager_load_lyric(void); /* 为当前曲目拉歌词并解析 */
|
||
int player_manager_error(void);
|
||
|
||
/* ipc_media：媒体会话上报/收指令 */
|
||
int ipc_media_start(void); /* 起 IPC 线程；0=成功 */
|
||
void ipc_media_stop(void);
|
||
|
||
/* ---- 宿主测试面（app/test/test_ncm_app.c 驱动真实页面）---- */
|
||
void app_host_set_mock(int mode); /* 0=无 1=home 2=playlist 3=player 4=settings 5=login */
|
||
void app_host_paint_page(int page); /* 构建指定页并整帧绘制到 back_buf（供 dump）*/
|
||
|
||
#endif /* NCM_APP_INTERNAL_H */
|