项目要交付,AI 也想跟上?
在「花椒技术部」,看一线团队怎样用 AI 写代码、做 Agent、推进真实项目。技术群还会分享精选 AI 日报,也欢迎带着工具选型和工程实现中的问题来交流。
关注公众号「花椒技术部」,回复「技术群」获取入群入口。
一个确认请求晚到了半秒。对客户端来说,玩家刚点了棋盘;对服务端来说,这一手可能已经超时落下,对手甚至已经开始选下一手。花椒语音房接入联机五子棋时,我们得保证一件事:不管请求按什么顺序到,棋盘上这一回合只增加一颗子。

联网五子棋对局演示
先把「改选」和「确认」分开
玩家已经选了 A,第一次点 B,只把预选位置挪到 B;再点一次 B,才立刻落子。如果玩家不再点,改选会重新启动一秒的自动确认。回合截止时间照旧。改选时只剩半秒,最多就等这半秒。
这种边界交给 AI 列用例很合适。我们让它按「玩家操作、当时状态、预期反馈」列清楚。遇到会改变胜负的分支,团队先定规则。比如第三次托管恰好连成五子,先判五连或满盘,两个条件都没满足才判托管逃跑。

AI 负责整理场景和回归用例,产品和研发一起定会影响玩法的规则。
确认请求和超时调度,共用一把房间事务锁
Cocos 客户端提交落子意图,Go 服务端决定这步棋是否生效。客户端收到服务端快照才更新棋盘。对手和观战页面也按这份状态显示。

Cocos 接收触控与展示快照,Go 服务推进对局,MySQL 保存结果和成长记录。
我们把手动确认和超时调度放进同一把房间事务锁。拿到锁后,服务端在同一个事务里先检查哪些计时已到期,再核对请求指的是不是当前回合、当前这一次预选。预选和回合哪个先到期,就按哪个处理。
假设调度器已经落了子,确认请求这时才拿到锁。服务端会拒绝这次迟到的确认,把当前状态返回去。客户端只要照着快照更新,对手无需猜这条消息是不是重复落子。
我们回归时换了几种顺序:确认先到、调度先到、同一请求重复提交、断线重连后旧请求才到。每种都对照服务端状态和棋盘,检查同一回合是否只落了一颗子。
五连以后,结算也要经得起重试
如果胜利动画还没播完,玩家就退了房,终局仍要能查回来。我们把终局结果和待结算任务一起写入数据库,再按对局和账号生成唯一凭证。任务可以重试。验收时,我们重复查询、重跑任务,再看数据库里同一笔奖励有没有多记。
把两个玩家和一个观战页面都打开
首轮联调在两个 H5 窗口里做。黑白双方分别入座、准备,队长开局,浏览器通过 WebSocket 连到服务端,后端用本地 MySQL。第九手黑方五连,两个窗口都收到结果。加上观战页后,我们还检查了白方能不能抢走黑方的回合,以及玩家重连回来时,三方看到的棋盘和胜负能否对上。

本地 H5 双人联调。左图是黑方落下第一手,右图是第九手黑方五连。
首轮本地验证通过了 20 个顶层测试和 3 个子用例。导出到手机端还有单独的检查:Cocos Creator 导出后,原本用展开语法复制的音源集合被当成了一个元素。我们改为把集合转成数组,再拿导出文件测两件事------已经响起来的声音能否被静音,之后落子和结算会不会又响。先在开局前按静音,只能测到后一件。
你做过回合制游戏吗?玩家确认和超时落子撞在一起时,你会怎么测?欢迎带着用例来交流。关注公众号「花椒技术部」,回复「技术群」获取入群入口。