游戏引擎 / 系统课时
处理暂停与继续游戏
处理暂停与继续游戏
玩家打开暂停菜单后,角色、敌人和关卡计时应停止推进,但“继续游戏”仍必须能够点击。本课以 Cocos Creator 3.8 的 director.pause() 管理场景更新,配合输入过滤和背景音乐控制,实现从运行到暂停再到恢复的完整闭环。
学习目标
- 区分暂停场景逻辑和停止整个游戏主循环。
- 让玩法输入、动画、物理与关卡计时在暂停期间保持一致。
- 通过按钮和 Esc 恢复游戏,并验证状态不会丢失。
确定哪些系统应暂停
暂停不是简单地把菜单设为可见。应该先明确谁停止、谁继续:游戏世界不再模拟,暂停 UI 仍接受输入,背景音乐依据产品需求单独处理。
| 对象 | 运行中 | 暂停时 |
|---|---|---|
角色与敌人 update、引擎调度计时 |
正常推进 | 停止推进 |
| 场景动画、物理模拟 | 按帧更新 | 随场景逻辑暂停 |
| 攻击、移动等玩法输入 | 可执行 | 收到事件也不执行 |
| 暂停菜单按钮 | 可点击 | 仍可点击 |
| 背景音乐 | 播放 | 由代码显式暂停 |
director.pause() 暂停 Director 的逻辑更新,但保留渲染和事件分发;game.pause() 会停止更大范围的主循环,不适合依赖场景按钮恢复的菜单。这里把 director.isPaused() 当作统一的暂停判断,避免另设一个可能不同步的布尔值。
状态如何切换

最重要的顺序是:先显示暂停面板,再暂停逻辑;恢复时先恢复逻辑,再隐藏面板。这样暂停菜单不会因为被当成游戏世界的一部分而失去恢复入口。单纯靠 update 停止还不够,键盘、网络回调或原生定时器仍可能触发操作,需要在动作入口检查暂停状态。
配置暂停菜单
在场景的 Canvas 下建立 PauseButton 和 PausePanel,面板内放置 ResumeButton。让 PausePanel 默认隐藏,角色与战斗场景保持在另一个节点分组中,避免误关 UI 根节点。
给常驻节点挂载下面的 GamePause 组件,并在属性检查器中绑定 PausePanel;如果已有背景音乐 AudioSource,也绑定 Bgm。分别在两个 Button 的 Click Events 中选取此组件的 pauseGame 与 resumeGame 方法。项目若含返回主菜单按钮,切换场景前应先调用 resumeGame,防止 Director 的暂停状态带到下一场景。
编写暂停控制器
将以下完整脚本保存为 GamePause.ts 并挂到常驻于当前场景的节点。示例用每秒日志模拟关卡计时,使用 J 键验证玩法输入是否被过滤;正式项目中的攻击、移动入口也必须使用同一检查。
import {
_decorator, AudioSource, Component, director,
EventKeyboard, Input, input, KeyCode, log, Node,
} from 'cc';
const { ccclass, property } = _decorator;
@ccclass('GamePause')
export class GamePause extends Component {
@property(Node) pausePanel: Node | null = null;
@property(AudioSource) bgm: AudioSource | null = null;
private worldSeconds = 0;
private bgmWasPlaying = false;
onLoad(): void {
if (this.pausePanel) this.pausePanel.active = false;
}
onEnable(): void {
input.on(Input.EventType.KEY_UP, this.onKeyUp, this);
}
onDisable(): void {
input.off(Input.EventType.KEY_UP, this.onKeyUp, this);
}
private onKeyUp(event: EventKeyboard): void {
// 键盘事件在 Director 暂停时仍可能抵达。
if (event.keyCode === KeyCode.ESCAPE) {
director.isPaused() ? this.resumeGame() : this.pauseGame();
return;
}
if (director.isPaused()) return;
if (event.keyCode === KeyCode.KEY_J) log('攻击输入有效');
}
update(dt: number): void {
this.worldSeconds += dt;
if (this.worldSeconds >= 1) {
this.worldSeconds -= 1;
log('游戏世界推进 1 秒');
}
}
public pauseGame(): void {
if (director.isPaused()) return;
this.bgmWasPlaying = this.bgm?.playing ?? false;
if (this.pausePanel) this.pausePanel.active = true;
if (this.bgmWasPlaying) this.bgm?.pause();
director.pause();
log('游戏已暂停');
}
public resumeGame(): void {
if (!director.isPaused()) return;
director.resume();
if (this.bgmWasPlaying) this.bgm?.play();
if (this.pausePanel) this.pausePanel.active = false;
this.bgmWasPlaying = false;
log('游戏已继续');
}
}预期结果:启动场景后控制台每约一秒出现一次世界推进日志;点击暂停,菜单显示且日志停止增长,按 J 不再触发攻击;点击继续或按 Esc 后日志恢复,J 重新生效。一次典型的关键日志顺序如下,世界推进日志的次数随操作时机变化:
游戏世界推进 1 秒
游戏已暂停
游戏已继续
攻击输入有效检查不受暂停控制的入口
director.pause() 不会替业务代码取消已经发出的网络请求,也不会冻结 JavaScript 的 setTimeout。异步回调如果会改血量、结算或跳转场景,应再检查当前游戏状态,或把数据放到恢复时处理。暂停面板本身的动画也可能因 Director 暂停而停止;若需要动态背景或持续播放的 UI 动画,应改用局部玩法状态门控,而不是全局暂停 Director。
验收时连续执行“暂停→继续→暂停”,观察计时是否接续而非重置、按钮是否可重复使用、音乐是否从原播放位置恢复。背景音乐原本未播放时也不应因为一次恢复而被意外启动。