feat: add configurable four and eight way controls

This commit is contained in:
2026-09-13 00:09:33 +08:00
parent 3dbde6829d
commit baeb1130eb
23 changed files with 448 additions and 67 deletions
+8 -2
View File
@@ -1,4 +1,4 @@
# NESLite 架构(0.9.10 候选基线)
# NESLite 架构(0.9.11 候选基线)
## 边界与线程
@@ -101,7 +101,7 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及
按 pointerId 维护触摸来源并送入与物理手柄相同的 `InputRouter`,因此多来源去重、相反方向和释放规则
一致;取消、滑出、失焦与暂停清空所有虚拟来源。首次使用状态也存于设置 DataStore,不接触用户存档。
0.9.10 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
0.9.11 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
区域绘制虚拟手柄;左上角横排图标入口独立于游戏安全内边距,打开游戏列表、导入和设置的全屏页面。
方向键与 ABXY 的半径为原布局的 1.5 倍,Select、Start、暂停和重置为原布局的 1.3 倍。Magic8 横屏
安全区允许时,方向键、Select、4:3 画面、Start、暂停和重置整体左移一个 A 键直径,右侧扩展空间用于
@@ -109,6 +109,12 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及
连发动作;重置要求持续按住 650 ms。游戏页沉浸式隐藏系统栏,管理页恢复系统栏;页面打开前先等待
运行会话进入暂停态,页面关闭后不自动恢复,避免文件选择或设置过程中游戏在后台继续。
屏幕方向键使用单一圆形触控域和互斥方向扇区,不再由四个重叠圆形命中区判定。中心 15% 为中立区,
有效触控半径比可见十字键大 30%,当前方向获得 25% 的切换迟滞,并在方向首次按下或切换时反馈。
八方向模式允许一个触点同时持有横向和纵向,四方向模式保留最近明确输入的主轴;同一策略在统一
`InputRouter` 中约束物理摇杆。多触点状态以动作集合保存,因此 A 与 B 可以同时按住。方向键大小、
水平与垂直偏移存入 AppSettings DataStore。
手柄设置支持逐项向导和单项修改/清除。捕获目标动作后,物理 KeyEvent 或超过按下阈值的轴方向成为
该动作的唯一绑定;冲突必须由用户确认替换。轴捕获后必须先回到释放阈值内才进入下一项,防止同一
持续轴值误绑多个动作。草稿与正在使用的档案分离,仅保存成功后替换运行档案并按设备指纹持久化。
+2 -2
View File
@@ -1,6 +1,6 @@
# NESLite 可复现构建说明
本说明对应 0.9.10 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
本说明对应 0.9.11 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
FCEUmm 或 Oboe 文件。
## 前置条件
@@ -50,7 +50,7 @@ pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\package-rc.ps1
脚本重跑 Stage 和 release lint,生成 `org.neslite.app` 的未签名 release APK、完整原生符号、应用及
三个固定第三方依赖的源码包、许可证/说明、静态原生审计、候选清单和 SHA-256。输出位于
`.build/rc-0.9.10/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
`.build/rc-0.9.11/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
arm64-v8a 库。
默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离
+4 -1
View File
@@ -5,10 +5,13 @@
ABXY、视图/菜单键及左右肩键。随后在荣耀 Magic8 页面取得了 Android 设备身份和静态轴范围;
实际 KeyEvent、动态轴采样、手柄模式及拔出重连仍待诊断 JSON 回填。
在 0.9.10-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动
在 0.9.11-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动
设置全部按键”,按页面顺序操作 X5 Lite;也可点击任一动作单独修改或清除。轴方向捕获后先松回中位,
冲突时确认是否替换,最后点击“保存”。配置按下表设备指纹保存,不依赖临时 deviceId。
“设置 → 屏幕方向键与手柄摇杆”可选择四方向或八方向。八方向允许摇杆同时上报一个横向和一个纵向;
四方向会保留最近明确输入的主轴,降低斜推误触。
## 固定测试条件
- 手柄模式:原生安卓模式,实际切换方法待随设备说明和实测确认。
+1 -1
View File
@@ -6,7 +6,7 @@
| --- | --- |
| 显示名称 | `NESLite` |
| 正式 application ID/namespace | `org.neslite.app` |
| 当前候选版本 | `0.9.10`,`versionCode = 9010` |
| 当前候选版本 | `0.9.11`,`versionCode = 9011` |
| 调试 application ID | `org.neslite.app.debug` |
| 发布 ABI | `arm64-v8a` |
| min/target SDK | 28/36 |
+2 -2
View File
@@ -1,6 +1,6 @@
# 已知问题与候选版限制
本清单对应 0.9.10 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
本清单对应 0.9.11 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
明确接受或修复结论。
| 编号 | 优先级 | 状态 | 问题与处理条件 |
@@ -9,7 +9,7 @@
| RC-B02 | 阻断 | 开放 | 尚无满足动作/滚屏、声音和可观察电池进度要求的合法游戏样本;冻结的 12 个 CC0 最小样本只能用于加载冒烟。 |
| RC-B03 | 阻断 | 开放 | H-LONG、H-INPUT、4 KB/16 KB 运行、API 28 冒烟及 H-UPGRADE 尚未在设备执行。 |
| RC-B04 | 阻断 | 开放 | 尚未提供受保护的发布签名密钥及同 ID/同签名旧版数据集;当前 RC 静态审计包为未签名 APK。 |
| RC-M01 | 中 | 开放 | Debug lint 有 45 个非阻断警告,主要是动态界面文本国际化、依赖版本提示和 Android 16 固定横屏兼容提醒;无 lint 错误。 |
| RC-M01 | 中 | 开放 | Debug lint 有 46 个非阻断警告,主要是动态界面文本国际化、依赖版本提示和 Android 16 固定横屏兼容提醒;无 lint 错误。 |
不得通过删除失败 ROM、缩短规定轮数/时长、用 x86_64 替代 arm64,或用桌面原生测试替代 Android
实机运行来关闭阻断项。每项关闭时应在 M8 报告登记设备、包哈希、ROM 哈希、命令、原始日志和结论。
+2 -2
View File
@@ -1,7 +1,7 @@
# M8 0.9.4 发布候选记录
> 此文件保留 0.9.4 的历史候选证据。0.9.10 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能
> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.10 候选记录。
> 此文件保留 0.9.4 的历史候选证据。0.9.11 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能
> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.11 候选记录。
日期:2026-09-12
+2
View File
@@ -12,6 +12,8 @@
4. 点左上角“设置”图标可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进。进入
“手动设置手柄按键、摇杆与功能键”后,可启动逐项向导,也可单独点击动作修改或清除;按下物理键
或推动轴完成捕获,检查无误后点“保存”。冲突会要求确认,设置按设备特征在重启和重连后恢复。
“屏幕方向键与手柄摇杆”可切换四方向/八方向,并循环选择标准、大、特大方向键;两个位置滑块可
调整方向键的水平和垂直位置。默认八方向与大号,A、B 支持两根手指同时按住。
5. 游戏中点右侧“暂停”或按手柄右摇杆进入暂停菜单;“重置”需要持续按住约 650 ms,滑出会取消。
“存档管理”显示十个手动槽、三个自动恢复点、
提交时间和缩略图。只有原生层确认安全落盘后才显示保存成功。