2.9 KiB
2.9 KiB
M4 完整手柄操作记录
日期:2026-09-12
构建:org.neslite.app.debug,0.4.4-debug,versionCode 4004,arm64-v8a
已实现
- 标准 Android 通用映射覆盖方向、NES A/B、Start/Select、X/Y 软件连发、右摇杆暂停菜单和 RB 按住快进;Guide/Mode、厂商组合与快速读档不占用,支持 A/B 交换。
- 设备、按键、轴方向和测试触屏来源独立合成;重复来源去重,单来源释放不误清其他来源,相反方向 同时按下归零。
- 可配置按下/释放双死区阈值,跨向时先释放旧方向;设置页可捕获按键或轴、提示并确认冲突、保存、 取消及恢复默认,所有退出路径清输入状态。
- 软件连发由核心线程按模拟时间生成 15 Hz 门控,NTSC/PAL 采用同一时间口径;暂停、退出、失焦和 断柄清除连发。右摇杆暂停及 RB 快进按合成边沿触发,KeyEvent repeat 不重复命令。
- 游戏列表、暂停菜单和手柄设置使用 Android 可聚焦控件;运行时方向送游戏,暂停时方向留给焦点 导航,手柄 B 提供返回路径。
- DataStore 1.1.7 按 VID/PID 和 descriptor 的稳定指纹保存映射、A/B 状态和死区;临时 deviceId 只 出现在当前诊断,不进入持久化档案。
X5 Lite 证据边界
用户提供的两张照片确认了 USB-C 伸缩夹持、十字键、双摇杆、ABXY、视图/菜单和肩键的物理布局,
详见 docs/controller-x5lite.md。照片不能证明 Android VID/PID、descriptor、键码、轴号、重复上报或
硬件连发状态;专属签名表因此保持为空,连接前使用标准 Android 通用映射,可在设置页逐项捕获。
本地验证
- 原生 smoke test 覆盖 NTSC 60 帧与 PAL 50 帧各一模拟秒均产生 15 次连发脉冲。
- JVM 测试覆盖通用与精确签名选择、A/B 交换、档案 JSON 往返、设备指纹、双来源按住/释放、 轴键去重、相反方向、死区边界和跨向顺序、暂停/快进边沿、断柄及触屏来源。
tools/check.ps1 -Scope Stage:APK、Windows 原生 smoke test 和 JVM 测试全部通过;JVM 共 23 项, 失败 0、错误 0。Android lint:0 错误、30 个非阻断警告。- 调试 APK:
app/build/outputs/apk/debug/app-debug.apk,21,844,231 字节,SHA-256DC57D4F6818A0F637264DC8F96328CBEEA2B16302899FE6777EE70737E5DAC00。包内原生库仅有目标 ABIarm64-v8a的libneslite_jni.so与 DataStore 的libdatastore_shared_counter.so。
尚未形成门槛证据
当前没有已授权目标手机,也没有 M1 导出的 X5 Lite Android 身份/事件表及合法 ROM。真实专属默认
映射、绑定交互、全手柄启动与菜单路径、NTSC/PAL 实际连发、断柄取消快进和 H-HOT 20 轮插拔尚未
执行。G1~G3 未通过也阻止进入 G4;todo.md 中 M4 项与 G4 保持未勾选。