Files
NESLite/docs/controller-x5lite.md
T

54 lines
3.0 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.
# X5 Lite 实测键位与模式
本文档只登记真实设备结果,不根据按钮字母、外观或网络资料推断 Android 键码。2026-09-12 已收到
用户提供的手柄正面和肩部照片;照片确认这是直连 USB-C 的伸缩式布局,并可见十字键、双摇杆、
ABXY、视图/菜单键及左右肩键。当前尚未连接目标手机,照片不能给出 Android VID/PID、descriptor、
键码、轴号或上报模式,因此这些字段仍待诊断 JSON 回填。
## 固定测试条件
- 手柄模式:原生安卓模式,实际切换方法待随设备说明和实测确认。
- 硬件连发:测试前关闭;实际指示状态待实测记录。
- 厂商保留组合:待实测;不得占用“视图+菜单长按”。
- 照片观察:USB-C 直连、伸缩夹持;可见十字键、双摇杆、ABXY、视图/菜单及肩键。
- 应用版本:M1 采集页基线 `0.1.3-debug`;M4 映射页 `0.4.4-debug`。
- 事件上限:最近 512 条;页面显示最近 30 条。
## 连贯验收步骤
1. 连接目标手机,启用 USB 调试,运行 `pwsh -NoProfile -File tools/check-m1-device.ps1`。
2. 连接 X5 Lite,确认页面出现名称、descriptor、VID/PID、sources 和轴范围。
3. 分别操作十字键、左右摇杆、扳机和所有正面/肩键,观察按下、重复、松开与轴值。
4. 同时按住一个方向和 A/B,确认组合状态同时存在;全部松开后确认状态为“无”。
5. 按住方向及 A/B 时拔出手柄,确认出现 `device_removed` 且状态清空。
6. 重新连接,确认分配新的会话编号并可继续记录。
7. 点击“导出诊断 JSON”,保存文件并在本报告登记文件名和 SHA-256。
## 设备身份
| 项目 | 实测值 |
| --- | --- |
| 手机型号/系统 | 待实测 |
| API/ABI/页大小 | 待实测 |
| 屏幕/当前及可用刷新率 | 待实测 |
| 手柄名称/descriptor | 待实测 |
| VID/PID/sources | 待实测 |
| 安卓模式切换方法 | 待实测 |
| 硬件连发关闭方式/状态 | 待实测 |
| 厂商保留组合 | 待实测 |
| 诊断 JSON/SHA-256 | 待实测 |
外观照片只作为“物理控件存在”的证据,不作为设备身份或 Android 事件映射证据。M4 在未取得上述
身份字段时使用标准 Android 通用映射,并允许在应用内逐项捕获;X5 Lite 专属签名不会按名称猜测。
## 键位与轴
| 物理控件 | Android KeyEvent/MotionEvent | sources/范围 | 重复上报 | 备注 |
| --- | --- | --- | --- | --- |
| 十字键上/下/左/右 | 待实测 | 待实测 | 待实测 | 记录按键与 HAT 是否同时上报 |
| A/B/X/Y | 待实测 | 待实测 | 待实测 | 不按字母推断 NES 映射 |
| LB/RB/LT/RT | 待实测 | 待实测 | 待实测 | 记录扳机按键/轴双重上报 |
| 左摇杆/按下 | 待实测 | 待实测 | 待实测 | 记录 X/Y、flat 与范围 |
| 右摇杆/按下 | 待实测 | 待实测 | 待实测 | 记录 Z/RZ、flat 与范围 |
| 视图/菜单 | 待实测 | 待实测 | 待实测 | 保留厂商组合说明 |