Files
NESLite/docs/reports/m3-audio.md
T

36 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# M3 音频、时钟与快进记录
日期:2026-09-12
构建:`org.neslite.app.debug`,`0.3.4-debug`,versionCode 3004,arm64-v8a
## 已实现
- 固定 Oboe 1.10.0(`a81bb9f87d4105b84b682685d3bfbb5beca371d1`)从源码静态链接;依次尝试
独占低延迟、共享低延迟和共享安全输出,记录实际参数,全部失败时保留单调时钟运行路径。
- 4096 帧 SPSC stereo float 环形缓冲,目标水位约一个模拟帧;回调仅取样、增益/静音和原子计数,
欠载补零、满缓冲丢新帧。
- int16 stereo 到实际设备采样率的连续线性重采样,状态跨 libretro 批次保留。
- 以核心 FPS 和 `steady_clock` 为基准、音频水位 ±2% 修正的正常调度;音频不可用与静音不改变目标
速度。计时分离加载、暂停、正常与快进,帧工作耗时窗口固定 240 项。
- UI 提供音量、静音和按住 2× 静音快进;暂停/释放/失焦/断柄/退出清旧音频并取消快进。
- Android 音频焦点丢失安全暂停,重新获得焦点不自动继续;路由增删和 Oboe 断开由内核线程重建,
成功或失败均停在 Paused,可再次触发重建。
- 状态及诊断导出包含核心/设备采样率、burst、callback、缓冲水位、欠载/溢出、重建次数、速度和
帧时间。
## 本地验证
- `tools/check.ps1 -Scope Stage`:APK、Windows 原生 smoke test 和 JVM 测试全部通过。
- 原生测试覆盖环形缓冲空/满/环绕、增益/静音/欠载,48→48、24→48、48→44.1 kHz 重采样及跨
批次连续性,无音频/低水位/高水位/2× 调度分支,以及加载/暂停/快进计时分离。
- `:app:testDebugUnitTest`:12 项通过;Android lint:0 错误、26 个非阻断警告。
- 调试 APK:`app/build/outputs/apk/debug/app-debug.apk`,19,892,293 字节,SHA-256
`3904B93CF45D697518D556BE754CFC3BCB76A54826EB418A29E306B53478EE8F`;包内仅含目标 ABI 的
`lib/arm64-v8a/libneslite_jni.so`。
## 尚未形成门槛证据
当前没有已授权目标手机,也没有已登记合法 NTSC/PAL ROM。因而实际扬声器声音、Oboe 回退、音量/
静音组合、音频焦点、真实路由切换、断开后重建、NTSC/PAL 同轮速度及 30 分钟 H-AV 尚未执行。
G1/G2 未通过也阻止进入 G3;`todo.md` 中 M3 项与 G3 保持未勾选。