Skip to content

docs: bring the module README up to date - #22

Merged
wt159 merged 1 commit into
mainfrom
docs/readme-refresh
Nov 9, 2026
Merged

wt159 merged 1 commit into
mainfrom
docs/readme-refresh

Conversation

@wt159

@wt159 wt159 commented Nov 9, 2026

Copy link
Copy Markdown
Owner

九个 PR 之后,面向使用者的 README 已经落后:只写了 write/stop,没有 write_ex、运行时开关、根目录、sidecar,文件结构也缺了 sidecar.c / dump_writer.c / 契约脚本 / CMakeLists。

这次补齐:

  • 对外接口全部列出,并标注观测接口需要 DUMP_PCM_INTERNAL_DEBUG_API 或 DUMP_PCM_DESKTOP_OBSERVE
  • 增加格式结构与校验范围(8k–384k、1–8 声道、位深自洽)
  • 新增「运行时控制」小节:push 开关优先级、根目录必须在 init 前、sidecar 开关在文件打开时采样
  • 修正清理描述:实际是写线程首次处理时执行,且只匹配 .pcm 后缀
  • 新增「元数据 sidecar」章节:命名、生成三条件、complete 语义、原子写、强杀场景
  • 构建补 CMake;Android 集成明确「HAL 调用点不需要改动」

本地 check_docs_build_contract.sh 与 check_verification_flow.sh 均通过。

Nine PRs of API and behaviour changes left the user-facing document behind:

- document write_ex, the push switch, set_root_dir and the sidecar switch;
- add the format struct and its validation rules;
- correct the cleanup wording (it runs on the writer thread once, and only
  matches the .pcm suffix);
- add a sidecar section covering naming, completeness and atomic writes;
- list the new sources and the CMake build;
- state explicitly that HAL call sites do not need to change.
@wt159
wt159 merged commit e91e076 into main Nov 9, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant