时间与离线:分清游戏时钟和现实时间
一款游戏需要不止一种时间
攻击前摇、无敌窗口、生产周期、每日重置和限时活动都与时间有关,但它们不应共用同一个 Date.now。游戏时间在暂停时停止,现实时间继续前进;性能测量需要单调时钟,日历规则需要时区和日期;可信活动截止时间可能需要服务端权威。先给每个规则指定时钟来源,才能避免暂停还掉血、改手机时间就刷奖励等问题。
对实时战斗,使用逻辑步长或累计游戏时间。页面隐藏时停止推进,恢复后不要把整个后台间隔作为一帧 dt 交给战斗。可限制异常帧步长并控制补步上限,但要知道这意味着丢弃部分现实时间,适合允许暂停的本地玩法;竞技联机可能需要完全不同的同步与权威策略。不能把一个单机暂停方案推广为所有游戏的正确做法。
对离线经营,需要现实时间差来计算补偿。Date.now 便于持久化,但受设备时钟调整影响;会话内的单调时钟适合计时,却不能独自跨重启恢复。可以注入 Clock 接口,分别暴露 wallNow 与 gameNow,测试时使用假时钟推进。任何计时器回调都只是执行机会,不能假定它恰好在指定时刻运行。
用截止时刻替代反复减一
type Clock = { wallNow(): number };
type OfflineState = { settledUntilMs: number; coins: number };
function settle(s: OfflineState, nowMs: number, ratePerSecond: number) {
const capMs = 8 * 60 * 60 * 1000; // 本教学方案的离线上限。
const elapsed = Math.min(capMs, Math.max(0, nowMs - s.settledUntilMs));
const reward = Math.floor(elapsed / 1000) * ratePerSecond;
return {
next: { settledUntilMs: Math.max(s.settledUntilMs, nowMs), coins: s.coins + reward },
reward,
};
}
示例适合整数每秒速率、整秒结算且不保留余数的简单规则,必须事先校验输入有限、速率非负且结果安全。完整生产系统若要求保留不足一秒的进度,应把余数纳入状态,或按最后实际结算边界推进水位,不能每次短间隔恢复都丢掉小数。负时间只得到零收益,水位不倒退,避免同一区间随后被重复计算。
本地时间被调到遥远未来后,简单 max 水位会使后续很久没有收益。因此本地单机要选择明确策略:检测异常后提示并重建基准、限制可接受跳变,或使用在线校时;每种选择都可能在合法旅行和时钟修正时误判。重要资产应使用服务端时间和权威结算,不要声称靠一个时间上限就能彻底防作弊。
离线时间轴需要分段
恒定产率可以乘时间,遇到增益到期、容量填满、升级完成或资源耗尽,就需要按事件切段。比如前两小时有双倍产率,后六小时恢复普通,不能用恢复时的产率追溯整段离线。输入资源的生产链更复杂,可能需要离散事件模拟。模拟必须有事件次数上限和退化策略,不能按每帧或每毫秒补算数天。
结算水位、资源增加和任务进度应作为同一次状态提交。恢复事件可能重复触发,玩家也可能多次打开领取面板,所以需要幂等操作编号或可靠水位。弹窗展示的是已经结算的结果,关闭或重开不会再发基础收益。若有广告加倍,把额外奖励绑定到本次结算编号,满足条件后只发一次,并清楚区分取消、失败和完成。
前后台事件用于协调保存、暂停与恢复,但不能假定应用一定会优雅退出。关键交易应及时保存,隐藏时再尽力补存。微信官方类型定义提供 onHide、onShow 等接口,具体运行环境与基础库仍需验证。Cocos 适配层和平台事件若同时监听同一个生命周期,要避免一次隐藏重复保存、一次恢复重复结算。
每日重置是日历规则
“每天零点”必须说明哪个时区。以本地时区计算,玩家旅行或修改设置可能重复领取;固定服务端时区便于统一,但界面要解释重置时间。夏令时意味着一天不总是固定二十四小时,跨日计算应采用明确日历规则,而不是简单除以毫秒常量。若产品只服务一个固定时区,也应在规格中写明,避免未来扩展时靠猜测兼容。
活动倒计时可以用服务端给出的截止时间与校时偏移显示,但客户端显示归零并不决定服务端是否接受领取。网络延迟与时钟误差需要清楚的最终裁决。离线状态下可以展示估计时间或要求联网确认,不能在本地先承诺成功再等待服务器否认。对有价值的奖励,最终以可信服务端结果更新状态。
常见错误与诊断
“后台回来瞬间死亡”检查战斗 dt 是否包含隐藏时长;“倒计时越走越慢”检查是否每次回调简单减一;“重复上线多领”检查结算水位与奖励是否分开保存;“短时间多次上线没收益”检查舍入余数;“跨天签到重复”检查时区和领取日期身份。日志应包含时间来源、原始时间差、截断后时间差、旧水位和新水位。
不要把所有异常都判为作弊。设备休眠、系统校时、网络延迟和基础库行为也可能造成时间跳变。先保护状态不变成负数或无穷,再记录可解释的异常,按照产品规则恢复。没有可信服务器的教学游戏应诚实说明时间可被修改,而不是引入一堆本地混淆逻辑假装安全。
给时间规则建立明确精度
如果生产只精确到秒,保存毫秒余数仍有价值;如果战斗按逻辑步裁决,就不要承诺任意毫秒的精确反应窗口。界面倒计时、规则截止点和日志应采用相容单位,边界测试分别取截止前一步、恰好截止和截止后一步。精度约定能避免浮点比较和显示舍入混在一起,也让 AI 生成的测试真正检查规则边界,而不是偶然通过某一个小数样例。
给 AI 的任务与验收
任务示例:“抽取游戏时钟与现实时间,战斗暂停不推进,离线产出使用注入时钟和八小时教学上限。基础奖励、水位与存档一起提交,保留毫秒余数;同一次恢复重复执行不重复奖励。提供时间倒退、未来跳变、增益到期三类策略说明,不连接真实服务端。”先让 AI 列出各字段的单位与可信程度。
验收覆盖零时间、负时间、超过上限、跨整秒边界、多次短间隔结算、重复恢复与保存失败。把同一时间段分成多段推进,除明确容量规则外应得到一致结果。战斗隐藏一分钟后恢复仍保留原前摇剩余时间。实际微信环境的生命周期测试另记报告,本页不虚构执行结果。
来源与核查范围
- 微信官方小游戏 API 类型定义,核查日期:2026-11-17。核对前后台接口,未核定所有基础库和设备行为。
- Cocos 3.8 用户数据存储,核查日期:2026-11-17。用于持久化边界;本文时间水位和离线公式是教学方案。