跳到主要内容

界面导航:页面、弹窗和输入所有权

页面变化也是状态变化​

主菜单、战斗、暂停、设置和结算不只是五个节点。它们决定玩家能看见什么、哪些输入有效、游戏时间是否推进以及返回按钮做什么。把每个面板各自设置 active,容易出现两个互斥页面同时显示、弹窗关闭后底层仍锁定,或暂停设置页关闭后意外恢复战斗。先设计导航状态,再绑定节点表现。

可以把界面分为基础页面与覆盖层。基础页面通常互斥,如菜单与局内;覆盖层形成栈,如暂停上打开设置,设置上再打开确认弹窗。返回先关闭最上层可关闭覆盖层,没有覆盖层时再执行页面级返回。进入结算时通常需要清空不再适用的局内弹窗,避免玩家从失败结果返回一个已经失效的暂停菜单。

对后端开发者,导航类似带资源所有权的工作流。每层需要说明谁创建、谁关闭、是否持有暂停权、是否阻挡输入、关闭后返回哪里。不要让面板自己遍历场景找“上一个界面”;导航器保留状态和参数,面板只展示并发出动作意图。参数应是关卡编号或结果快照,而不是任意场景节点引用。

一个小栈足以处理第一版​

type Overlay = 'pause' | 'settings' | 'confirm-exit';
class Navigation {
page: 'menu' | 'run' | 'result' = 'menu';
readonly stack: Overlay[] = [];
open(kind: Overlay) {
if (this.stack[this.stack.length - 1] !== kind) this.stack.push(kind);
}
back(): Overlay | undefined { return this.stack.pop(); }
showResult() {
this.page = 'result';
this.stack.length = 0;
}
get top() { return this.stack[this.stack.length - 1]; }
}

示例只演示结构,正式项目还需约束哪些页面允许打开何种覆盖层。重复打开同一弹窗是否忽略、刷新参数或创建新实例,应明确。只有少量页面时无需引入路由框架;当存在资源异步加载,再给打开请求加代次,确保旧请求完成后不会覆盖新导航。加载失败也应该能返回,而不是留下半个透明遮罩挡住所有操作。

暂停不能只靠“暂停面板是否显示”推导。应用隐藏、设置、广告或用户主动暂停都可能持有暂停原因;可以维护原因集合,集合非空就停止局内时间。关闭设置只移除设置对应原因,不能一概恢复游戏。恢复前清空持续按住的输入,防止手指在切后台时没有收到抬起事件,回来后角色继续移动。

输入所有权必须清楚​

遮罩除了视觉变暗,还应按设计拦截底层触摸。Cocos 3.8 UI 提供 BlockInputEvents,适合阻挡节点范围内的鼠标与触摸。需要确认遮罩的 UITransform 尺寸覆盖实际可交互区域,并检查透明节点是否意外挡住按钮。阻挡节点事件并不自动停止全局输入监听,角色控制器仍应检查局级许可。

一个常见穿透问题是玩家点击“重试”,同一个触摸结束又被战斗攻击按钮处理。可以在导航提交时清空本轮输入,或确保输入域只允许最上层处理;不能仅在每个按钮里添加任意延迟。键盘也要统一返回与确认行为,焦点应该停留在当前层,不要让隐藏页面上的按钮继续响应快捷键。桌面课程示例支持键盘,不代表触摸版就已验证可用。

多点触摸需要决定是否支持同时移动与攻击。方向按钮通常在按下时加入输入,在抬起和取消时移除,关闭页面时清空全部按住状态。一次性购买、确认等动作使用点击或提交沿,不能在每帧按住时重复执行。按钮禁用期间要给出可理解的状态,而不是只在程序内部静默拒绝。

布局从安全区域开始​

桌面阅读站与手机游戏采用不同布局目标。游戏的设计分辨率提供坐标基准,实际设备仍可能长宽比不同。关键按钮放在安全区域内,背景可延伸,HUD 通过 Widget 锚定,长列表通过 Layout 或 ScrollView 管理。安全区域不是把整个世界缩成小矩形,战斗镜头、背景与可操作控件可以采用不同适配策略。

Cocos Widget 会修改对齐结果,和代码每帧设置同一节点位置可能互相覆盖。避免一边使用左右拉伸,一边又写固定宽度;父容器的职责应清楚。SafeArea 组件适合处理平台安全矩形,但具体微信设备的顶栏、胶囊与输入边界仍需运行环境验证。不要因为编辑器里没有遮挡就宣称适配全部手机。

排查界面死锁与重入​

“按钮看得见但点不到”先检查上方透明节点、遮罩尺寸和按钮 interactable;“关闭弹窗后无法移动”检查暂停原因是否未移除;“打开两次就触发两次”检查 onEnable 是否注册、onDisable 是否对应解绑;“快速返回后弹窗又出现”检查异步打开请求是否过期。显示导航栈与暂停原因,比只观察画面更直接。

导航动画也要有中断策略。快速打开再关闭时,旧 tween 完成不能重新设置 active;为每次过渡记录编号或取消旧动作。界面状态应先提交,再按状态驱动动画;退出动画结束后销毁或回收视图,但不能让视图的存在决定导航真相。这与玩法状态和动画分离遵循同一原则。

返回与退出需要保护上下文​

确认退出弹窗应说明将失去什么,例如当前局进度是否保存;取消后回到原层并保留选中项,不应重新创建整局。退出成功时统一释放局内输入、暂停原因和模型订阅,再进入菜单。若存在未完成保存,应显示实际状态或按既定策略处理失败,不能让返回键直接绕过资产提交。为这条流程保留一个集成检查,能够同时发现导航、存档与生命周期之间的缝隙。

给 AI 的任务与验收​

任务示例:“实现菜单、局内、结果三个页面及暂停、设置、退出确认覆盖层。使用显式栈,最上层拥有输入;暂停采用原因集合,切后台清空按住输入。Creator 3.8.8 使用现有组件,不引入路由库。提供导航栈调试文本和快速操作复现步骤。”同时说明返回键在栈空时的行为。

验收按“战斗→暂停→设置→返回→返回”确认逐层恢复;测试隐藏期间关闭设置仍保持隐藏暂停;连续点击重试只创建一局;遮罩触摸不会攻击;取消触摸不会留下方向状态。再按多个纵横比检查文本和按钮,没有实际真机验证时明确记录。继续阅读HUD 数据绑定让界面准确反映模型。

来源与核查范围​