43 lines
2.9 KiB
Markdown
43 lines
2.9 KiB
Markdown
# 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 保持未勾选。
|