游戏引擎 / 系统课时

管理暂停与恢复流程

管理暂停与恢复流程

玩家打开暂停菜单后,角色应停止移动,战斗和倒计时不能继续推进,但恢复按钮仍要能够操作。本课使用 Cocos Creator 3.8 实现一个可交互的暂停层,通过统一暂停状态、局部时间缩放和输入屏蔽,让游戏能够安全地暂停与恢复。

学习目标

  • 区分暂停菜单、玩法逻辑和输入系统的暂停责任。
  • 使用统一状态和时间缩放控制角色运动,并阻止暂停期间的玩法输入。
  • 完成暂停与恢复按钮接线,验证状态恢复和输入清理是否正确。

暂停不只是显示一个面板

最容易出现的错误,是点击暂停按钮后仅显示一个半透明面板。界面看起来已经暂停,底层角色却还在移动,敌人仍然攻击,倒计时继续减少。这是因为显示状态和游戏运行状态没有建立联系。

一个可靠的暂停流程需要分别处理三类行为:

系统 暂停期间的预期行为 控制方式
玩法逻辑 停止角色移动、战斗结算和关卡计时 读取统一暂停状态或玩法时间缩放
玩法输入 不接受移动、攻击、交互等指令 在输入消费前检查暂停状态
暂停 UI 遮罩可见,恢复按钮保持可点击 保持 UI 响应并阻挡底层触控

暂停菜单本身不能跟着玩法逻辑一起停止,否则恢复按钮、菜单交互和部分界面动画可能无法正常工作。因此,要区分游戏时间和界面时间。

本课采用局部暂停策略:游戏逻辑使用自定义时间缩放系数,暂停时设置为 0,恢复时设置为 1;暂停界面继续使用正常的引擎更新与输入事件。这不是修改 Cocos Creator 的全局时间。

建立暂停状态与输入流转

暂停和恢复应当是两个明确的状态转换,而不是由不同脚本分别修改节点、速度和按钮。统一状态之后,所有依赖玩法时间的逻辑都能查询同一个暂停标记。

暂停与恢复的玩法时钟、UI 输入及状态迁移图

这里的关键是两条独立规则:

  • 时间推进规则:玩法系统使用 dt * gameplayScale 计算时间增量。暂停期间系数为 0,依赖该增量的运动不再推进。
  • 输入消费规则:暂停期间拒绝玩法动作,但保留暂停与恢复命令。松开按键的事件仍需处理,避免恢复后遗留按住状态。

另外,UI 遮罩上的 BlockInputEvents 只能阻挡节点范围内的鼠标和触控事件向下层 UI 穿透。通过全局 input 注册的键盘监听,以及其他玩法逻辑,仍然需要显式判断暂停状态。

编写可运行的暂停控制组件

在 Cocos Creator 3.8 的 TypeScript 项目中,新建 PauseFlow.ts。下面的主示例提供一个可验证的最小流程:按住 D 键使角色向右移动,通过暂停和恢复按钮控制玩法时间,同时阻止暂停期间重新接收移动输入。

ts
import {
  _decorator, Button, Component, EventKeyboard,
  input, Input, KeyCode, Node
} from 'cc';

const { ccclass, property } = _decorator;

// 统一保存当前关卡的暂停状态,其他玩法组件也可读取。
export class GameplayClock {
  static paused = false;

  static get scale(): number {
    return GameplayClock.paused ? 0 : 1;
  }
}

@ccclass('PauseFlow')
export class PauseFlow extends Component {
  @property(Node)
  player: Node | null = null;

  @property(Node)
  pauseLayer: Node | null = null;

  @property(Button)
  pauseButton: Button | null = null;

  @property(Button)
  resumeButton: Button | null = null;

  private movingRight = false;

  protected onLoad(): void {
    GameplayClock.paused = false;
    if (this.pauseLayer) this.pauseLayer.active = false;
  }

  protected onEnable(): void {
    input.on(Input.EventType.KEY_DOWN, this.onKeyDown, this);
    input.on(Input.EventType.KEY_UP, this.onKeyUp, this);
    this.pauseButton?.node.on(Button.EventType.CLICK, this.pauseGame, this);
    this.resumeButton?.node.on(Button.EventType.CLICK, this.resumeGame, this);
  }

  protected onDisable(): void {
    input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
    input.off(Input.EventType.KEY_UP, this.onKeyUp, this);
    this.pauseButton?.node.off(Button.EventType.CLICK, this.pauseGame, this);
    this.resumeButton?.node.off(Button.EventType.CLICK, this.resumeGame, this);
  }

  private onKeyDown(event: EventKeyboard): void {
    // P 键属于流程输入,暂停时仍可切换状态。
    if (event.keyCode === KeyCode.KEY_P) {
      GameplayClock.paused ? this.resumeGame() : this.pauseGame();
      return;
    }

    // 暂停时不允许产生新的玩法移动意图。
    if (GameplayClock.paused) return;
    if (event.keyCode === KeyCode.KEY_D) this.movingRight = true;
  }

  private onKeyUp(event: EventKeyboard): void {
    // 即使处于暂停中,也要清理已释放按键。
    if (event.keyCode === KeyCode.KEY_D) this.movingRight = false;
  }

  protected update(dt: number): void {
    if (!this.player || !this.movingRight) return;

    // 只缩放玩法时间,不影响暂停菜单的交互。
    const deltaX = 160 * dt * GameplayClock.scale;
    const p = this.player.position;
    this.player.setPosition(p.x + deltaX, p.y, p.z);
  }

  public pauseGame(): void {
    if (GameplayClock.paused) return;

    GameplayClock.paused = true;
    this.movingRight = false;
    if (this.pauseLayer) this.pauseLayer.active = true;
  }

  public resumeGame(): void {
    if (!GameplayClock.paused) return;

    GameplayClock.paused = false;
    if (this.pauseLayer) this.pauseLayer.active = false;
  }
}

GameplayClock.scale 是本项目定义的玩法时间系数,并非引擎提供的全局 timeScale 属性。它只影响明确使用该系数的逻辑。其他玩法组件可以导入 GameplayClock,在执行移动、攻击或交互前检查 paused,并使用 scale 计算需要暂停的时间增量。

这里没有直接调用 game.pause(),因为该方法面向更全面的游戏暂停,不适合作为需要继续操作 UI 的暂停菜单的默认实现。director.pause() 也具有不同的全局逻辑暂停范围,不能与本例的局部时间缩放混为一谈。

在场景中接通暂停与恢复

准备一个包含二维角色和 UI 的测试场景,按以下顺序配置:

  1. 在 Canvas 下创建 Player 节点,为它添加可见的精灵,确保移动效果能够观察。
  2. 创建 PauseButton 节点并添加 Button,作为正常游戏界面的暂停入口。
  3. 创建覆盖整个游戏画面的 PauseLayer,加入半透明背景、暂停标题和作为子节点的 ResumeButton。
  4. 确保 PauseLayer 的 UITransform 覆盖需要拦截的区域,在遮罩节点上添加 BlockInputEvents,并将它放在需要遮挡的游戏 UI 上层。
  5. 创建始终保持激活的 FlowRoot 节点,挂载 PauseFlow,将四个对应节点或按钮组件拖入 Player、PauseLayer、PauseButton 和 ResumeButton 属性。

本示例在 onEnable 中通过代码注册两个按钮的点击事件,因此无需再在 Button 的 Click Events 列表里重复绑定相同方法。否则一次点击可能导致重复调用。

PauseFlow 不能挂在会被关闭的 PauseLayer 上。暂停层一旦隐藏,挂在其下的控制组件也会停用,恢复按钮可能失去原本需要的流程控制对象。

验证暂停边界与其他系统

在浏览器预览中执行以下操作,观察页面可见结果:

  1. 按住 D 键,角色持续向右移动;点击暂停按钮后,遮罩显示,角色位置立即停止变化。
  2. 暂停期间重新按 D 键,角色仍然不能移动;点击底层游戏按钮的位置,不应触发被遮罩覆盖的节点交互。
  3. 点击恢复按钮,遮罩消失;再次按 D 键,角色从暂停前的位置继续移动。
  4. 按 P 键反复切换暂停与恢复,确认没有发生重复移动、按钮失效或者残留输入状态。

预期结果:正常运行时移动速度为每秒约 160 个场景坐标单位;暂停时使用的玩法时间增量为 0;恢复后继续按正常速度移动,不会把暂停期间经过的真实时间一次性补算成额外位移。

实际项目中,敌人 AI、技能冷却和关卡计时应共同遵循玩法暂停状态;暂停菜单 UI、必要的系统通知与网络连接管理则可以保持运行。对于需要暂停的动画和定时任务,应保存必要状态并在恢复时继续,而不是简单地全部销毁后重新创建。

还要区分主动暂停与应用进入后台。后台切换可能中断输入或影响音频,恢复前应清理旧按键状态并确认界面与游戏状态一致。只有把状态切换、时间推进和输入消费同时管理起来,暂停流程才不会出现表面停止、底层继续运行的问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理暂停与恢复流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通