48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# X5 Lite 实测键位与模式
|
||
|
||
本文档只登记真实设备结果,不根据按钮字母或网络资料推断 Android 键码。当前尚未连接目标手机和
|
||
X5 Lite,因此表格保持“待实测”;完成下述流程并导出诊断 JSON 后回填。
|
||
|
||
## 固定测试条件
|
||
|
||
- 手柄模式:原生安卓模式,实际切换方法待随设备说明和实测确认。
|
||
- 硬件连发:测试前关闭;实际指示状态待实测记录。
|
||
- 厂商保留组合:待实测;不得占用“视图+菜单长按”。
|
||
- 应用版本:`0.1.3-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 KeyEvent/MotionEvent | sources/范围 | 重复上报 | 备注 |
|
||
| --- | --- | --- | --- | --- |
|
||
| 十字键上/下/左/右 | 待实测 | 待实测 | 待实测 | 记录按键与 HAT 是否同时上报 |
|
||
| A/B/X/Y | 待实测 | 待实测 | 待实测 | 不按字母推断 NES 映射 |
|
||
| LB/RB/LT/RT | 待实测 | 待实测 | 待实测 | 记录扳机按键/轴双重上报 |
|
||
| 左摇杆/按下 | 待实测 | 待实测 | 待实测 | 记录 X/Y、flat 与范围 |
|
||
| 右摇杆/按下 | 待实测 | 待实测 | 待实测 | 记录 Z/RZ、flat 与范围 |
|
||
| 视图/菜单 | 待实测 | 待实测 | 待实测 | 保留厂商组合说明 |
|