feat: refine immersive game controls

This commit is contained in:
2026-09-12 21:20:39 +08:00
parent 2c09d42737
commit 20fa1855ca
16 changed files with 312 additions and 118 deletions
+4 -4
View File
@@ -1,4 +1,4 @@
# NESLite 架构(0.9.5 候选基线)
# NESLite 架构(0.9.6 候选基线)
## 边界与线程
@@ -101,10 +101,10 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及
按 pointerId 维护触摸来源并送入与物理手柄相同的 `InputRouter`,因此多来源去重、相反方向和释放规则
一致;取消、滑出、失焦与暂停清空所有虚拟来源。首次使用状态也存于设置 DataStore,不接触用户存档。
0.9.5 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
0.9.6 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
区域绘制虚拟手柄;左侧固定入口打开游戏列表、导入和设置的全屏独立页面。X/Y 复用 M4 的 A/B 软件
连发动作,重置为一次性触摸命令。页面打开前先等待运行会话进入暂停态,页面关闭后不自动恢复,避免
文件选择或设置过程中游戏在后台继续。
连发动作;重置要求持续按住 650 ms。游戏页沉浸式隐藏系统栏,管理页恢复系统栏;页面打开前先等待
运行会话进入暂停态,页面关闭后不自动恢复,避免文件选择或设置过程中游戏在后台继续。
## M7 系统交接与诊断
+2 -2
View File
@@ -1,6 +1,6 @@
# NESLite 可复现构建说明
本说明对应 0.9.5 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
本说明对应 0.9.6 候选基线。命令使用系统默认 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.5/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
`.build/rc-0.9.6/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
arm64-v8a 库。
默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离
+1 -1
View File
@@ -6,7 +6,7 @@
| --- | --- |
| 显示名称 | `NESLite` |
| 正式 application ID/namespace | `org.neslite.app` |
| 当前候选版本 | `0.9.5`,`versionCode = 9005` |
| 当前候选版本 | `0.9.6`,`versionCode = 9006` |
| 调试 application ID | `org.neslite.app.debug` |
| 发布 ABI | `arm64-v8a` |
| min/target SDK | 28/36 |
+2 -2
View File
@@ -1,6 +1,6 @@
# 已知问题与候选版限制
本清单对应 0.9.5 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
本清单对应 0.9.6 候选源码。优先级含义:阻断表示 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 有 53 个非阻断警告,主要是动态界面文本国际化、依赖版本提示和 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.5 改动了主界面、触屏输入路径和页面/会话交接,不能直接
> 继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.5 候选记录。
> 此文件保留 0.9.4 的历史候选证据。0.9.6 改动了主界面、触屏输入路径和页面/会话交接,不能直接
> 继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.6 候选记录。
日期:2026-09-12
+5 -3
View File
@@ -1,7 +1,8 @@
# NESLite 日常使用
1. 应用会自动进入横屏。主画面中央是 4:3 游戏区,左侧是方向键与 Select,右侧是 A/B/X/Y、
Start、暂停和重置;X/Y 分别是 A/B 连发。左上角的“列表”“导入”“设置”会打开独立页面。
1. 应用会自动进入沉浸式横屏,中央 4:3 游戏区优先占满安全高度。左侧是十字方向键,右侧是
A/B/X/Y;较小的 Select/Start 分别位于游戏画面底部两侧。X/Y 分别是 A/B 连发。左上角的
“列表”“导入”“设置”会打开独立页面,并临时恢复系统栏。
2. 点左侧“导入”,选择你合法持有的 `.nes` 文件。应用按完整 SHA-256 建库;同名不同内容独立,
相同内容不会重复。可按名称/哈希搜索、收藏或从列表隐藏。隐藏不删除 ROM 和存档,重新导入相同
内容会恢复关联。
@@ -9,7 +10,8 @@
屏幕按键。多点触控支持方向与动作同时按住,滑出、取消、失焦或暂停都会释放输入。
4. 点左侧“设置”可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进,并进入
手柄按键设置、A/B 交换、死区调整及设备诊断。设置会在重启后恢复。
5. 游戏中点右侧“暂停”或按手柄右摇杆进入暂停菜单。“存档管理”显示十个手动槽、三个自动恢复点、
5. 游戏中点右侧“暂停”或按手柄右摇杆进入暂停菜单;“重置”需要持续按住约 650 ms,滑出会取消。
“存档管理”显示十个手动槽、三个自动恢复点、
提交时间和缩略图。只有原生层确认安全落盘后才显示保存成功。
6. 存档包通过 Android 系统文件选择器导入导出,默认不含 ROM。导入前先加载对应游戏并暂停;哈希、
内核提交、配置、路径、大小或校验不匹配会被拒绝并保留现有有效存档。