feat(ncm): 网易云客户端 v1 UI+播放链路 (agent-205) — os.meow.ncm: 登录页(真实unikey二维码+轮询状态机)/我的歌单(listview)/歌单详情/播放页(封面+seek+滚动歌词+竖横屏切换)/设置(音质默认Hi-res+缓存上限默认10G); 播放线程(缓存LRU+minimp3→ALSA UAPI直开hw:0,0); 媒体会话MSG_META上报+PLAYCTL接收(首真实媒体源)
ncm 1e331964 (text 764KB); 0 warning; 宿主离屏6页截图目检+真实QR可扫+qemu-mipsel干净启动+解码446xRT 真机待联调: ALSA时序/803扫码闭环/媒体会话联动/gbk大字库渲染
This commit is contained in:
MeowOS committed
1 parent
32543ac616
commit
21519ce2e4
23 files changed
+3255
No files matched your search
@@ -216,3 +216,143 @@ a53e55f9cab828fd59b694330ec7371e core/ncm_login.c d81eda09640ff748b0a1c14607
|
||||
- **播放地址/缓存仅验证到“请求-解析-无版权返回 null”**；未做真实音频下载落盘（缓存 open/write/commit 已由单元测试覆盖；真实 mp3 下载留给带 UI 的播放层用 `ncm_http_download`+`ncm_cache_*` 串联）。
|
||||
- **栈用量**：单次 http 调用涉及 mbedtls ssl/净栈，峰值栈估几十 KB（与预研 demo 同级）；App 线程栈需 ≥64KB，联调时以真机线程栈为准。
|
||||
- **JSON 响应限幅**：歌单/歌曲详情走 1MB~2MB 堆缓冲 + token 计数后精确分配，不算常驻；封面/大 JSON 不整体驻留，封面下载另有 `max_bytes` 限幅（建议 ~256KB，未在本次接线）。
|
||||
|
||||
---
|
||||
|
||||
## 10. 网易云客户端 v1 = App + UI + 播放链路（`os.meow.ncm`）
|
||||
|
||||
> 日期：2026-08-31。在 §9 核心库之上落地 App：UI（登录/歌单/播放/设置）+ 播放链路（URL 降级→缓存→minimp3→audio_out）+ 媒体会话 IPC。
|
||||
> 仅改动 `patch_v2/ncm_app/app/`；未动 sdk/、meow_launcherd/（并行域冻结）；未碰 vendor/、core/（§9 核心库原样使用）。
|
||||
> 宿主 + qemu-mipsel 双边实测见 §10.5。未 commit/push/刷机/动设备。
|
||||
|
||||
### 10.1 包结构与页面
|
||||
|
||||
```
|
||||
patch_v2/ncm_app/
|
||||
├── app.json # {"name":"网易云音乐",exec:.../os.meow.ncm/ncm,package,version:0.1,version_code:1,framework:1,immersive:1,fonts:gbk}
|
||||
├── build_ncm.sh # mipsel 静态 0 warning
|
||||
├── build_ncm_host.sh # 宿主离屏自测（MEOW_UI_DUMP）
|
||||
├── ncm # mipsel 静态 App（md5 见 §10.6）
|
||||
├── app/app.c # main + 装配 + 事件分发（物理键不映射；左缘左滑=返回/退出）
|
||||
├── app/ncm_app_internal.h # 内部共享头（ACT_*/布局/数据上限/播放运行态/各页与 play/ipc 接口）
|
||||
├── app/ui/
|
||||
│ ├── chrome.c # TopAppBar/内容区几何/空态/页脚/底部提示条(ncm_snack)
|
||||
│ ├── login.c # 登录页：后台 worker: unikey→二维码矩阵→轮询→803 落 cookie→login_status
|
||||
│ ├── home.c # 我的歌单（meow_listview：folder图标+名称+曲目数副标题+箭头）
|
||||
│ ├── playlist.c # 歌单详情（曲目列表：歌名+歌手；点击起播并推进播页）
|
||||
│ ├── player.c # 播放页（封面+标题/歌手+进度条seek+播放/暂停/上下曲+滚动歌词；竖/横布局可切）
|
||||
│ └── settings.c # 设置（音质 Hi-res/较高/标准 + 缓存上限 1~100GB + 退出登录）
|
||||
├── app/logic/
|
||||
│ ├── appstate.c # ctx/cookie/uid/歌单/歌曲/设置加载与持久化（meow_config_*）
|
||||
│ ├── lyric.c # LRC 时间轴解析（原文+翻译合并、排序、行定位；流式有界 NCM_LYRIC_LINES）
|
||||
│ └── cover.c # 封面后台线程下载(≤288KB)+解码单张缓存 + 落盘 cover_current.jpg 供 launcher
|
||||
├── app/play/
|
||||
│ ├── player_manager.c # 播放线程：URL 降级→缓存(命中即播/否则流式落盘)→minimp3→audio_out；暂停冻结/seek重开/上下曲
|
||||
│ ├── audio_out.c # 音频输出：ALSA 直开 hw:0,0(内核UAPI) / FILE(WAV) / NULL(测RT)
|
||||
│ ├── ipc_media.c # 媒体会话 IPC：MSG_META 上报 + MSG_PLAYCTL 接收（meow_ipc.h 直接帧格式）
|
||||
│ └── minimp3_impl.c # minimp3_ex 唯一实现 TU
|
||||
└── app/test/
|
||||
├── test_ncm_app.c # 宿主真实页面渲染（NCM_PAGE=login|loginlive|home|playlist|player|lands|settings）
|
||||
└── test_decode.c # 解码链路（minimp3→audio_out FILE）验证
|
||||
```
|
||||
|
||||
**页面/导航**：根页 = 已登录 ? ACT_HOME : ACT_LOGIN。栈：HOME → PLAYLIST → PLAYER；SETTINGS 任意页可进。
|
||||
左缘左滑（`on_swipe LEFT`）：PLAYER→pop 回 PLAYLIST；SETTINGS→pop；PLAYLIST→pop 回 HOME；HOME/LOGIN→`meow_ui_request_exit()` 退出 App。
|
||||
|
||||
### 10.2 关键实现
|
||||
|
||||
**登录**（`ui/login.c`）：进入即起后台 worker（网络全在独立线程，UI 不卡）。`ncm_login_unikey`(eapi) → `ncm_login_qr_url` + `ncm_login_qr_matrix`(qrcodegen) → 渲染 37×37 位图（白底+黑模块 6px，居中）→ 每 1.5s `ncm_login_poll`(801/802/803/800)。803：捕获 set-cookie 合并 → `ncm_ctx_set_cookie` 加密落盘 → `ncm_login_status_check` 取 uid/nickname → 置 done → UI tick `meow_view_page_replace(ACT_HOME)`。800(过期)自动刷新二维码；网络失败 tap 重试。
|
||||
|
||||
**主页**（`ui/home.c`）：`meow_listview` 虚拟化（folder 图标 + 名字 + `N tracks` 副标题 + 右侧箭头）；空态/会话过期/错误绘制物；topbar 标题=昵称 + 「↻」刷新；行数据轻量（不下载封面缩略图）。点击行 → `playlist_open(idx)`。
|
||||
|
||||
**歌单详情**（`ui/playlist.c`）：`ncm_api_playlist_detail`(trackIds) + 分批 `ncm_api_song_detail`(≤256 首，NCM_SONG_MAX)；行=歌名+歌手；点击行 → `player_play_song(row)`（起播 + 推播放页）。
|
||||
|
||||
**播放页**（`ui/player.c`）：封面（`cover_request` 后台解码，`meow_ui_img_cover` 居中裁方 220px）+ 题/歌手 + 进度条（手绘，点 bar seek）+ 控制钮（prev/play-pause/next）+ 滚动歌词（`lyric_line_at(pos)` 居中高亮）。**横竖屏可切**：device LCD 为竖屏 480×720，故为**布局**切换（竖=封面上/歌词下；横=封面左/信息歌词右），topbar 「⟳」触发，`player_set_screen()`。进度/状态/歌词每 tick 读 `player_manager_*`（跨线程 mu）。
|
||||
|
||||
**设置**（`ui/settings.c`）：3 行卡片（音质/缓存上限/退出登录）。音质→BottomSheet(Hi-res/Higher/Standard)；缓存→BottomSheet(1/2/5/10/20/30/50/100 GB)；退出→confirm 弹窗 → `appstate_logout()` + replace ACT_LOGIN。持久化 `MeowData/os.meow.ncm/data/` 下 `ncm.level`/`ncm.cache_limit_gb`（键与核心库 `ncm_cache_load_setting` 对齐）。
|
||||
|
||||
### 10.3 播放链路（`app/play/player_manager.c`）
|
||||
|
||||
```
|
||||
player_manager_play(idx) → 播放线程外层循环 → run_song(idx):
|
||||
① song_local_file: ncm_cache_lookup 命中 → 直接播（离线）；否则
|
||||
ncm_api_song_url_auto(desired=设置音质, 逐档降级 hires→…→standard, 只收 mp3)
|
||||
+ ncm_http_download 流式写缓存 temp → ncm_cache_commit（先落盘再播）
|
||||
② mp3dec_ex_open(path, MP3D_SEEK_TO_BYTE) → audio_out_open(44.1k/16/2)
|
||||
③ 循环 mp3dec_ex_read → audio_out_write(pcm, frames) → frames_done→pos_ms（~200ms 节流更新）
|
||||
暂停=冻结（停读停写停推 pos，状态 PAUSED）；seek=重开解码器+audio_out 并字节 offset 近似定位；
|
||||
上下曲/停止=打断 run_song 回外层；播完=自动顺延下一首（无则 STOPPED）
|
||||
```
|
||||
- **缓存**：目录 `MeowData/os.meow.ncm/cache/`（`ncm_cache_*`），LRU 上限可配（默认 10GB，1~100）。
|
||||
- **audio_out**：宿主/qemu 无 `/dev/snd/pcmC0D0p` → 回退 FILE WAV（`NCM_AUDIO_SINK=file` / `NCM_AUDIO_OUT=<path>`）或 NULL（`NCM_AUDIO_SINK=null`，仅测 RT）。设备走 ALSA 内核 UAPI 直开（`sound/asound.h`，masks/intervals 重索引已按 musl 头修正），**真机时序待验证**。
|
||||
|
||||
### 10.4 媒体会话 IPC（`app/play/ipc_media.c`，SDK 无媒体封装自写最小客户端）
|
||||
|
||||
- 连接 `MEOW_IPC_SOCK`（缺省 `AF_UNIX /usr/data/meow_ipc.sock`）。
|
||||
- `MSG_HELLO`(app_id=`os.meow.ncm`, flags=`MF_PLAYBACK`) → 读 ACK。
|
||||
- 同 fd 每 ~1s 发 `MSG_META`（m_meta_t：title/artist/album/pos_ms/dur_ms/state=_1播 2暂停 0停 3缓冲，flags=MF_ART|MF_COVER（有 cover_current.jpg 时），artwork=该文件路径，app_id）。launcher 以最近活跃会话为准 → 通知中心媒体卡片 + Now Playing 页。
|
||||
- `poll(fd,POLLIN,200ms)` 收 `MSG_PLAYCTL` → cmd 1播放/2暂停/3上一首/4下一首/5seek → `player_manager_*`。
|
||||
- 无 launcher socket（宿主/qemu 无守护）→ log `ipc: no launcher socket` 并优雅返回。
|
||||
|
||||
### 10.5 验证记录（宿主 + qemu-mipsel 双向实测）
|
||||
|
||||
| 项 | 方式 | 结果 |
|
||||
|---|---|---|
|
||||
| 各页 UI | 宿主离屏 `MEOW_UI_DUMP` + PIL 转 PNG 目检 | login/home/playlist/player/lands/settings 全部正确（截图 `app/out/shots/*.png`） |
|
||||
| 登录真实二维码 | `NCM_PAGE=loginlive`：核心库真实 `ncm_login_unikey`→qr_matrix→渲染 | 真 unikey `40287b2e-9ef8-4f2e-8bf5-04febdaf631a`→37×37 可扫 QR（`out/shots/loginlive.png`） |
|
||||
| mipsel 二进制 | `qemu-mipsel ./ncm`（离屏+MEOW_UI_DUMP，timeout SIGTERM 干净退出） | 真实 mipsel 静态二进制跑通：`start`→`ipc: no launcher socket`(优雅)→登录页渲染**真实可扫 QR**（`out/shots/mipsel_qemu.png`） |
|
||||
| 解码链路 | `test_decode`（minimp3→audio_out FILE WAV） | MIPSTest.mp3 → 8.21s/48k/立体声/16bit PCM，WAV 合法（ch=2 rate=48000 frames=393984），**446× RT**（解码余量巨大） |
|
||||
| 构建 | `build_ncm.sh` mipsel | **0 warning**（自有代码 -Wall -Wextra）；text 764KB |
|
||||
|
||||
**宿主截图**：`app/out/shots/{login,loginlive,home,playlist,player,lands,settings,mipsel_qemu}.png`（PPM→PNG）。
|
||||
注：宿主 5×7 点阵字仅 ASCII（中文/歌名在设备上以 gbk 大字库渲染；桌面截图为 ASCII label 布局自查）。
|
||||
|
||||
### 10.6 md5
|
||||
|
||||
```
|
||||
1e331964b62b6f5b0a593c5d97a4e030 ncm # mipsel 静态 App
|
||||
（app 源码 md5）
|
||||
50dc58dc62a9d71a23e90bb00c79a36b app/app.c cf5e3283065dfce798d668c22ee87f65 app/ncm_app_internal.h
|
||||
b961bc769951208a09017f278c05a95b app/ui/login.c 5098bd843f6943bcda5aacfb7fae961f app/ui/home.c
|
||||
ef600c9d3a88eb2463d1c8f312a5a202 app/ui/playlist.c a55846822deb0246c6780d8a7ac99f46 app/ui/player.c
|
||||
05fef4b6fa5692abf0da57db40ad6f90 app/ui/settings.c 013111dea3172fdeb5353a2ec69a71a5 app/ui/chrome.c
|
||||
203a9932bde8a739b436e246ba634638 app/logic/appstate.c 48a92829ac414ffad5dbe27e0836c21b app/logic/lyric.c
|
||||
ed2d9658bc8707a5fd689b386da472f9 app/logic/cover.c e7cef918d2be04f6d4c5a25f62d2a9ab app/play/player_manager.c
|
||||
4ceeb2f4f1b0a312c9468b9f77886dc7 app/play/audio_out.c 8c1716ca99cd773a0cf9a105f793b845 app/play/ipc_media.c
|
||||
6ca4b2137c4a424d823f94a8b3fcd037 app/play/minimp3_impl.c a2ca48b2c6afa6c36f045ba8b2687fc5 app/test/test_ncm_app.c
|
||||
9ebfb5401c7818cfd0c21d640b07c521 app/test/test_decode.c
|
||||
```
|
||||
|
||||
### 10.7 出入清单
|
||||
|
||||
```
|
||||
新增（仅 patch_v2/ncm_app/）：
|
||||
app.json # 应用描述
|
||||
build_ncm.sh / build_ncm_host.sh # mipsel / 宿主构建
|
||||
app/app.c ncm_app_internal.h
|
||||
app/ui/{chrome,login,home,playlist,player,settings}.c
|
||||
app/logic/{appstate,lyric,cover}.c
|
||||
app/play/{player_manager,audio_out,ipc_media,minimp3_impl}.c
|
||||
app/test/{test_ncm_app,test_decode}.c
|
||||
out/shots/*.png # 验证截图
|
||||
修改：
|
||||
REPORT.md # 追加本批记录
|
||||
（未动 sdk/、meow_launcherd/、vendor/、core/；核心库 §9 原样使用）
|
||||
```
|
||||
|
||||
### 10.8 真机待验证项
|
||||
|
||||
1. **ALSA 直开 `hw:0,0`**：本层用内核 UAPI（`/dev/snd/pcmC0D0p` + ioctl hw_params：RW_Interleaved/S16_LE/44100/2ch）——**设备时序/权限/采样率匹配**待真机验证；宿主已回退 FILE sink 证解码链路。
|
||||
2. **真实扫码登录（803）**：set-cookie 捕获→加密落盘→`login_status` 校验链路按文档实现但**未真扫**；建议真机扫码验证一次 `MUSIC_U` 内容与 home 拉歌单闭环。
|
||||
3. **媒体会话**：需 launcher 在真机跑（本 App 首真实媒体源）；验证通知中心媒体卡片/Now Playing 显示 MSG_META + 下发 MSG_PLAYCTL 生效（本 App 已记 `ipc: no launcher socket` 为优雅降级，真机有 socket 即上报）。
|
||||
4. **大字库**：app.json `fonts:gbk` 声明已加；真机验证歌名/歌词中文渲染（宿主 ASCII 5×7 不含中文）。
|
||||
|
||||
### 10.9 诚实出入 / 已知限制
|
||||
|
||||
- **封面为歌单封面**（`playlist_detail` 的 coverImgUrl）而非**逐歌曲专辑封面**：`ncm_song_t` 未含 `al.picUrl`，为不改 §9 核心库（已驯化契约）故 v1 用歌单封面代为 artwork；逐曲封面需给 `ncm_song_t` 增 `al.picUrl` 字段（附加、向后兼容，建议二期）。
|
||||
- **歌词为同步加载**：播放页 enter 时 `player_manager_load_lyric` 同步网络拉取（UI 短暂阻塞）；建议后续改后台线程+就绪标志（音频线程独立不受影响）。
|
||||
- **歌单曲目截断**：`NCM_SONG_MAX=256`（大歌单显示前 256 首）；歌单数 `NCM_PLAYLIST_MAX=120`。
|
||||
- **launcher 媒体卡片封面**：经 MSG_META `artwork` 传 `<cache>/cover_current.jpg` 路径；若 launcher 读不到该路径则卡片仅题/艺/进度（App 内封面始终有）。
|
||||
- **IPC 仅处理 MSG_META/MSG_PLAYCTL**（未接 MSG_SYS，媒体会话最小闭环，符合 v1）。
|
||||
- **bss≈924KB / text≈764KB**：mipsel 静态；14MB 内存富余，但 bss 含封面下载缓冲(288KB)+QR 矩阵(31KB)+mbedtls 静态，已留充足余量。
|
||||
- **`meow_snack`/页脚**为 App 自绘（非 SDK 全局通知，避免与 launcher 系统 UI 冲突）。
|
||||
Reference in new issue
Block a user