React Audio Native

React DOM 的完整音频能力，不是 React Native SDK。

StrictMode 与 SSR 安全、事件驱动、完整 TypeScript，并与 Vue 版本共享同一音频状态契约。

播放、列表、缓冲、错误、互斥和宿主 Bridge 与 Vue 版本保持一致。

forwardRef、callback ref、订阅式不可变快照和无副作用导入。

同一构建生成搜索、Markdown、llms.txt、Agent Contract 与只读 MCP。

这套文档解决什么问题

React Audio Native 把 @trsoliu/audio-core 的浏览器媒体契约映射为 SSR 安全的 React 组件、Headless Hook 和命令句柄。文档同时覆盖 WebView 能力、Bridge 边界、跨仓库发布顺序和真机证据。

使用者从快速开始进入；维护者先看项目地图和 React 架构；AI 客户端读取构建生成的 /.well-known/silen/manifest.json，并保持只读直到用户明确授权写入。

react-audio-native@1.0.0 已通过 OIDC Trusted Publishing 发布到 npm 的 latest，携带 SLSA provenance，并精确依赖已发布的 @trsoliu/audio-core@1.0.0；next 保留 beta.2。
包面向 React DOM 18.2/19、移动浏览器与 WebView，不包含 React Native 原生 SDK。
稳定 1.0.0 已由维护者的版本绑定自动化评估授权；未执行的宿主真机场景及剩余风险在兼容性评估与真机记录中如实保留。

目标	文档
安装并播放第一段音频	安装与快速开始
从 Vue API 切换到 React	Vue → React 迁移
查找 props、回调 payload、状态、错误、Hook 和 ref	公共 API
理解 package、Demo、lab 与 fixtures	Monorepo 项目地图
处理浏览器/WebView 差异	浏览器与 WebView
准备 beta 或稳定发布	发布知识库