活动、远程配置、灰度与事故处置
适用:一般游戏持续运营与后端协作,客户端目标 Cocos Creator 3.8.8 + TypeScript。资料核查:2026-11-17。示例不依赖特定运营平台;远程配置能力不能替代微信当前审核与合规要求,本文未执行真实发布。
运营变更也要走软件工程流程
活动表、关卡数值、奖励和资源路径虽然不是 TypeScript,也能制造线上事故。配置把金币数量写错、活动引用尚未发布的敌人、结束时间使用不同的时区,影响可能超过一次代码错误。把配置视为版本化输入:有结构校验、语义校验、预览、测试、发布记录和回退,而不是让后台随意编辑一段 JSON。
配置边界先明确。适合参数化的已有行为可由配置控制;客户端未实现的新逻辑、未知资源类型和任意脚本不应通过配置“临时实现”。客户端校验 schemaVersion、适用版本与内容依赖,失败时使用经过验证的兼容默认值或停用相关活动,不能整个游戏黑屏。哪些内容变更需要重新审核,按当前平台规则核验。
生效时机决定一局是否公平
新配置到达后马上替换所有数值,会让同一局前后规则不同,也难解释成绩和奖励。常见策略是在大厅拉取并验证配置,开局时冻结规则版本,整局使用该版本;结束后再考虑新配置。联机房间由服务端指定版本,不能让各端自行选择。紧急停用能力是另一条受控路径,应定义它是否会中止进行中操作。
type EventConfig = {
schemaVersion: 1;
contentVersion: string;
startsAt: string;
endsAt: string;
minClient: string;
rewardTableId: string;
};
// 服务端确认活动时窗与资格;客户端倒计时仅用于展示。
// 开局记录 contentVersion,结算使用对应规则而非“当前最新表”。
活动时间应有明确时区和统一的服务端判断。客户端系统时间可被调整,倒计时不应成为发奖权威。跨日、延期和提前关闭都需要定义已参与玩家的资格;“结束前开局、结束后结算”究竟有效与否必须先写规则。测试覆盖边界前后,而不只在活动中间打开一次。
灰度是降低风险,实验是回答问题
逐步放量用于观察稳定性与兼容性;A/B 实验用于比较有明确假设的方案。两者可以配合,但不是同一种结论。灰度没有出事故不证明玩法更好;某个组收入较高也不证明应该立即全量,可能有样本、渠道或设备差异。先定义主指标、保护指标、观察窗口与停止条件,再开始变更。
分组应稳定,同一玩家不应每次打开在不同难度间跳动;多人同房时更要防止规则分组冲突。选择适当单位:玩家、账号、会话或房间,明确跨设备关系。客户端传来的组别不能决定有价值奖励资格,服务端按可信分组与配置裁决。新旧客户端支持范围也要进入受众条件。
配置发布与资源发布保持一致
先准备不可变版本资源并校验,再发布引用它的配置。客户端缓存配置与资源时保存匹配版本,不能把新清单配旧文件。回退配置之前确认旧资源仍存在;清理历史内容时考虑仍在运行的旧局与旧客户端。配置平台提供版本历史是有帮助的工具,但项目自己的兼容契约仍然需要设计。
远程请求失败时,区分没有任何可用配置与已有可信缓存。前者使用最小可运行默认内容,后者按过期策略继续或关闭非关键活动。不能无限使用过期经济规则,也不能每次拉取失败都阻止玩家进入普通关卡。配置签名、可信通道与访问控制根据威胁模型选择,服务端秘密始终不下发客户端。
运营奖励通过账本发放
补偿、邮件、兑换与活动领奖都使用明确业务键和服务器计算结果。批量发奖先预览受众、数量和总额,在测试环境演练,再按既定授权执行。发放任务要可断点继续并幂等,避免中途失败后全量重跑造成重复。撤回或补偿也要有规则和审计,不能直接手工改余额掩盖历史。
客户端展示“有奖励”与实际资格可能因状态变化不同,领取时再验证并返回可理解结果。邮件过期、背包容量、重复领取和账户限制都需要终态。补偿修复的是玩家影响,不替代根因修复;先停止继续损害,再确定受影响范围与恢复方案,不能盲目给全部玩家相同资产。
事故按影响与证据推进
首要动作是判断影响范围、冻结相关变更并选择可逆止损:关闭故障活动、停止有问题的发奖、回退配置或发布兼容修复。不要在未知状态下同时删除缓存、改表和重启全部服务。保存构建、配置版本、时间线与账本证据,让处理后仍能解释发生了什么。谁负责决策、执行与沟通,应在平时确定。
监控至少覆盖启动、可玩、崩溃或异常、关键请求、奖励与订单一致性。按版本、设备与配置分层,避免总体平均掩盖特定群体故障。恢复后执行核心路径和受影响边界,继续观察错误是否下降。事后复盘记录触发、放大因素、发现延迟与防复发措施,不用“操作失误”结束分析。
交给 AI 的任务与验收
可复制任务:“为七日活动设计版本化配置、服务端资格、开局冻结规则与幂等领奖。列出跨日、延期、结束后结算、旧客户端和资源缺失的行为;给灰度设保护指标与停止条件,提供配置回退和影响核对清单。不执行真实发布或批量发奖,不编造平台审核豁免。”
验收同一局规则不被中途更新;改客户端时间不能领奖;重复批次不重复发;缺资源时只关闭相关内容;回退能读取仍有效状态;事故记录可关联到具体版本与账本。实际运营授权、平台要求与玩家沟通另按项目责任流程完成。
官方来源与适用边界
- Firebase Remote Config 版本管理与灰度概念:第一方系统中的版本与放量机制示例;不表示本课程已选用该服务,也不推断其微信 SDK 可用性。
- GitLab Resource groups:串行化变更的工具机制参考。
- 微信小游戏官方产品入口:本次不可抓取,远程内容变更的当前审核边界须人工核对。