MeowOS
820d1e52bf
Bug1: SDK meow_ui_media 按 g_last_state 本地判 play/pause，但 ncm 走自有 ipc_media 线程不经 SDK meta 上报 → g_last_state 恒 0 → 恒发 cmd=1(播放)，播放中按键无效。 修：SDK 164 恒发 cmd=6 toggle（删 g_last_state 判定），ncm apply_playctl case 6 按 player_manager_state() 当前态翻转（源是状态权威）；launcher meow_media/util 本就透传 cmd 不动结构，仅 meow_ipc.h/SPEC_REF 注释补 6=toggle。媒体卡片/NP 页 按钮（按 launcher 侧 s->state 判，来自 META 是准的）维持现状。 Bug2: App 前台时状态栏为 launcher 叠加层，App 内 SDK 改音量/亮度只写 settings.conf+DAC，launcher meow_settings 内存表不感知 → g_sys.vol 停旧值。 修：app_overlay_statusbar 前插 app_overlay_settings_poll——1s 节流 stat settings.conf，mtime 变才 meow_settings_init 重读+sync 缓存+g_sys.vol/brightness （meow_settings 新增 meow_settings_file_path() 访问器防硬编码分叉）。 验证：宿主 test_sdk_input_keys 19/19（K4 改 toggle 断言）、test_media +cmd=6 透传用例 ALL PASS、ncm bench/toggle_sim 10/10（新）、player_flow/cache_evict sim PASS、ncm core 宿主+qemu-mipsel PASS、test_settings_brightness PASS； mipsel 交叉 -Wall -Wextra 0 warning（改动文件单独验+整构建）。 真机(0.7.91)：ncm 热更（.new+mv）后 autoplay(Docu) 起播缓存曲 → meow_ipc playctl 6 二连发 → paused(pos=139691)/resumed 日志实证 toggle 全链路。 md5：ncm 8f10eee5 / meow_ui.a 7b359ec9（gitignore）/ launcher eba4f2b2 （/usr/bin 只读，fw_content.conf 已更新待固件）。物理键 164 实体按压留用户终验。
54 lines
2.8 KiB
C
54 lines
2.8 KiB
C
/* meow_ui_media.h — App 侧媒体会话封装（SDK 公共件；FRAMEWORK_DESIGN 附录 B / D1）。
|
||
*
|
||
* 让框架/第三方播放类 App 以 SDK 标准上报实时元数据（MSG_META）并接收控制（MSG_PLAYCTL）。
|
||
* 声明 MF_PLAYBACK 的 App 首次上报 → launcher 注册为媒体源（最近活跃=当前源）；通知中心
|
||
* 媒体卡片 / 主界面 Now Playing 页据此显示与控制。
|
||
*
|
||
* 连接管理（best-effort）：懒连（首次 meta/注册回调时 connect）+ 断线重连（下次上报时重试）；
|
||
* launcher 不在 → 优雅静默降级，绝不崩。帧格式/负载复用 launcher 共享 meow_ipc.h（同一份）。
|
||
*
|
||
* 命名：launcher 侧已占用 meow_media_*（meow_media.c），SDK 侧统一 meow_ui_media_* 前缀，
|
||
* 避免两态同符号在 launcher（链 meow_ui.a + meow_media.c）出现重复定义。
|
||
*/
|
||
#ifndef MEOW_UI_MEDIA_H
|
||
#define MEOW_UI_MEDIA_H
|
||
|
||
#include <stdint.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* 播放控制回调：cmd 1=播放 2=暂停 3=上一首 4=下一首 5=seek（seek_ms 为毫秒）6=播放/暂停切换
|
||
* （toggle：物理播放/暂停键 164 恒发 6，由媒体源按自身当前态翻转——源是状态权威）。 */
|
||
typedef void (*meow_media_playctl_fn)(int cmd, int64_t seek_ms);
|
||
|
||
/* 指定 app_id（NULL=env MEOW_LOG_APP，缺省 "app"）。幂等，首次调用生效。 */
|
||
void meow_ui_media_init(const char *app_id);
|
||
|
||
/* 注册播放控制回调并启动后台接收线程（懒起；重复调用幂等）。
|
||
* 线程：连接（HELLO+MF_PLAYBACK 注册为媒体源）→ poll 读 launcher 下发 MSG_PLAYCTL → 调 cb。 */
|
||
void meow_ui_media_on_playctl(meow_media_playctl_fn cb);
|
||
|
||
/* 上报实时元数据/进度/状态（state：0=停止 1=播放 2=暂停 3=缓冲）。
|
||
* artwork/lyric 非空 → 自动置 MF_ART/MF_COVER/MF_LYRIC 标志；封面/歌词路径或 MeowOS 槽位。
|
||
* best-effort：无 socket/launcher 不在 → 静默降级（打日志不崩）。 */
|
||
void meow_ui_media_meta(uint32_t state, uint32_t pos_ms, uint32_t dur_ms,
|
||
const char *title, const char *artist, const char *album,
|
||
const char *artwork, const char *lyric);
|
||
|
||
/* 停止后台接收线程并断开连接（App 退出时调；幂等）。 */
|
||
void meow_ui_media_stop(void);
|
||
|
||
/* 物理媒体键 → 系统语义（SDK 输入层调用；App 前台也生效）。
|
||
* code：164=播放/暂停（恒发 cmd=6 toggle，源侧翻转）、165/19=上一曲、163=下一曲。
|
||
* 本 App 注册过 playctl 回调（媒体源）→ 本地直接回调 cb(cmd,seek_ms)；
|
||
* 否则经 IPC 发 MSG_PLAYCTL 给 launcher 转发到最近活跃媒体会话。非媒体键/无源静默。
|
||
* best-effort：无 launcher/socket → 优雅降级，绝不崩。 */
|
||
void meow_ui_media_sys_key(int code);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* MEOW_UI_MEDIA_H */
|