feat: implement M4 controller input foundation

This commit is contained in:
2026-09-12 13:40:19 +08:00
parent 2e8b8812a6
commit e91de54bad
26 changed files with 1172 additions and 78 deletions
+9 -3
View File
@@ -1,14 +1,17 @@
# X5 Lite 实测键位与模式
本文档只登记真实设备结果,不根据按钮字母或网络资料推断 Android 键码。当前尚未连接目标手机和
X5 Lite,因此表格保持“待实测”;完成下述流程并导出诊断 JSON 后回填。
本文档只登记真实设备结果,不根据按钮字母、外观或网络资料推断 Android 键码。2026-09-12 已收到
用户提供的手柄正面和肩部照片;照片确认这是直连 USB-C 的伸缩式布局,并可见十字键、双摇杆、
ABXY、视图/菜单键及左右肩键。当前尚未连接目标手机,照片不能给出 Android VID/PID、descriptor、
键码、轴号或上报模式,因此这些字段仍待诊断 JSON 回填。
## 固定测试条件
- 手柄模式:原生安卓模式,实际切换方法待随设备说明和实测确认。
- 硬件连发:测试前关闭;实际指示状态待实测记录。
- 厂商保留组合:待实测;不得占用“视图+菜单长按”。
- 应用版本:`0.1.3-debug`。
- 照片观察:USB-C 直连、伸缩夹持;可见十字键、双摇杆、ABXY、视图/菜单及肩键。
- 应用版本:M1 采集页基线 `0.1.3-debug`;M4 映射页 `0.4.4-debug`。
- 事件上限:最近 512 条;页面显示最近 30 条。
## 连贯验收步骤
@@ -35,6 +38,9 @@ X5 Lite,因此表格保持“待实测”;完成下述流程并导出诊断
| 厂商保留组合 | 待实测 |
| 诊断 JSON/SHA-256 | 待实测 |
外观照片只作为“物理控件存在”的证据,不作为设备身份或 Android 事件映射证据。M4 在未取得上述
身份字段时使用标准 Android 通用映射,并允许在应用内逐项捕获;X5 Lite 专属签名不会按名称猜测。
## 键位与轴
| 物理控件 | Android KeyEvent/MotionEvent | sources/范围 | 重复上报 | 备注 |