MeowOS
2796f181f7
meow_ui.a→9a8eb7ef; hello→fc299577; launcher→b33da20a; 宿主5套件+新test_notif_open+qemu分发 全过 出入: SDK符号用meow_ui_前缀防与launcher内同名冲突; 叠加会话真机待验; §10.5文档旧号段已过时
46 lines
2.2 KiB
C
46 lines
2.2 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 为毫秒）。 */
|
||
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);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* MEOW_UI_MEDIA_H */
|