feat: implement M4 controller input foundation
This commit is contained in:
@@ -0,0 +1,42 @@
|
||||
# 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-256
|
||||
`DC57D4F6818A0F637264DC8F96328CBEEA2B16302899FE6777EE70737E5DAC00`。包内原生库仅有目标 ABI
|
||||
`arm64-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 保持未勾选。
|
||||
Reference in New Issue
Block a user