docs: 文档一致性整理 (agent-249) — 对齐 M2.90/0.7.85 + ncm A2: SDK 新增 §5.9 meow_audio_* 客户端 API + IME 九键数字盘注记; README 网易云三期+A2 audiod+PCM 挂死已知问题; APPS §3.7/§5 直开 hw:0,0 旧案标注被 meow_audiod 取代; SETTINGS audio.output/音量键 audiod 收口注记; FRAMEWORK §10.1 supervisor 树补 meow_audiod + 头部里程碑 M2.90; PLAN 头部截至 M2.90; SPEC_REF OPEN_QUESTIONS 摘要同步 (#4/#12/#17 清结)

This commit is contained in:
MeowOS committed 2026-09-01 03:11:10 +08:00
1 parent 697fd6ba9b
commit 57509cd582
7 files changed
+39 -8

No files matched your search

+4 -2
View File
@@ -312,6 +312,8 @@ meow_launcherd --sim-exit N # 菜单打开 N 毫秒后模拟退出
## 5. 音频通路(未来应用的出声方案)
> **2026-09-01 更新**:常驻模式(MeowOS 主控、播放器未运行)下的出声方案**已由 `meow_audiod` 独占音频守护落地(M2.90)**——守护独占 hw:0,0、App 经 SDK `meow_audio_*` 喂 PCM(MEOW_APP_SDK §5.9 / `devdocs/plan/AUDIOD_DESIGN.md`)。本节下述 v3 候选为「会话覆盖模式(HibyOS 热键唤起、SIGSTOP 冻结播放器)」的历史推演,仅在该模式下仍有参考意义;常驻模式直开 hw:0,0 的旧结论见 §3.7。
参考 ANALYSIS.md 第 11 节结论:
- 声卡 = 内部唯一 card0(CS43198 双 DAC),**无混音**,谁打开谁独占;hiby_player 常驻持有 `hw:0,0`。
@@ -456,8 +458,8 @@ Description: A simulated app
**与 launcher 一致**:install/export 复用 M2.12 `meow_pkg_install/export` 同套语义(tar.gz、gzip 管道、包名=文件名茎、同名先备份、校验 app.json、数据 init);exFAT 无符号链接,数据目录由 MeowOS 经 `MEOW_DATA_DIR/CACHE_DIR` 注入,CLI 只建目录不建链接。
### 3.7 音频通路与媒体键(2026-08-31 实测定案,覆盖 §5 旧推论)
- **MeowOS 常驻模式(boot 直进,hiby_player 未运行)声卡空闲**:真机实测 `fuser /dev/snd/pcmC0D0p /dev/snd/controlC0` 无任何占用、`pidof hiby_player` 不存在——**MeowAPP 可直接 open `hw:0,0` 出声**(audio.output 设置键即此);无混音,后开者失败,音频焦点=先占先得(媒体会话/MPRIS 落地后再规范抢占语义)。
### 3.7 音频通路与媒体键(2026-08-31 实测定案,覆盖 §5 旧推论;**M2.90 起被 meow_audiod 收口,见末段**)
- **MeowOS 常驻模式(boot 直进,hiby_player 未运行)声卡空闲**:真机实测 `fuser /dev/snd/pcmC0D0p /dev/snd/controlC0` 无任何占用、`pidof hiby_player` 不存在。~~MeowAPP 可直接 open `hw:0,0` 出声~~ → **M2.90 起改走 `meow_audiod` 独占音频守护**:守护独占 hw:0,0,App 经 SDK `meow_audio_*` 客户端喂 PCM(见 MEOW_APP_SDK §5.9 / `devdocs/plan/AUDIOD_DESIGN.md`);独占+抢占(后开流赢,旧流收 PREEMPTED)、DAC 原生率跟随无 SRC、路由自动跟随插孔(meow_route 并入退役);App 直开仅 `MEOW_AUDIO_DIRECT=1` 调试用。媒体键路由最近活跃媒体会话不变。
- **会话覆盖模式(HibyOS 运行中热键唤起)**:SIGSTOP 冻结播放器,声卡仍被其持有,App 无声(§5 旧结论,仅适用该模式)。
- **物理媒体键路由**:MeowOS 与 HibyOS 不同时运行,不存在「转发给 hiby」问题;MeowOS 界面下播放/上下曲 = 全局媒体控制,路由给**最近活跃媒体会话**(**媒体会话已落地** M2.81:`MSG_META`(0x72)/`MSG_PLAYCTL`(0x73) + meow_media 最近活跃源(active_seq,30s 超时回收)+ 通知中心媒体卡片 + Now Playing 大页;**dev.player.ncm**(原 os.meow.ncm,agent-221 改名)是首真实媒体源),无会话时「抓住」不动作。