实时对战是联机游戏的核心,微信小游戏的官方服务有个自带的
帧同步服务
,以及配套的
房间服务
和
对局匹配
功能,目前这些功能都是免费的,对于心疼服务器资源的个人开发者而言是个不错的选择,但文档坑太多,本人也是调试了很久才在cocos creator里面跑通,写个文章记录一下。
本系列文章主要实现的流程是:
玩家点击在线匹配按钮进行匹配,满足人数条件后开始游戏,帧同步服务启动同步玩家操作,满足游戏结束条件时结束帧同步,进入结算页面。
以下链接是官方的帧同步服务说明:https://developers.weixin.qq.com/minigame/dev/guide/open-ability/lock-step.html,文章中使用
后台创建房间
的方式创建匹配规则,也就是说要有自己的服务器。
大致的流程是这样的:
1.在后台创建一个匹配规则(比如1V1,或者2V2等,官方帧同步服务目前最大支持5V5),保存matchId
2.玩家点击匹配按钮,调用自己的后端服务器,获得步骤1生成的matchId,使用这个matchId调用小游戏服务
3.当有多个玩家使用同一个matchId匹配时,微信服务器会自动创建房间并把这些玩家放入房间,所有(按匹配规则的设定)玩家确认开始游戏后,帧同步正式开启,帧同步服务便会按照匹配规则中设定的周期下发游戏帧
官方有个JS写的小例子(https://github.com/wechat-miniprogram/minigame-lockstep-demo)中间比较有价值的是
GameServer
这个脚本,官方给大家封装了一些方法,如果是用TS开发的小游戏,可以把该脚本转换成TS的(有些语法需要换下),引入项目中直接用。
下面开始详细说明流程中的三个步骤
1.在后台创建一个匹配规则(比如1V1,或者2V2等,官方帧同步服务目前最大支持5V5),保存matchId
接口说明(https://developers.weixin.qq.com/minigame/dev/api-backend/open-api/gamematch/gamematch.createMatchRule.html)
matchId(匹配规则)是什么?
初次接触的开发者可能会疑问,这个匹配规则是什么东西,它和房间有什么关系,createMatchRule和createGameRoom有关系吗?这个匹配规则我们可以理解成游戏的匹配模式,比如1V1,2V2,5V5,如果你的游戏支持这三种匹配模式,那么matchId只需要三个就行了,房间只是基于这个matchId创建的。
matchId可以在游戏上线前就生成好保存到数据库里,然后就不用去管了,正常情况不需要改也不需要定时刷新
获得matchId的方法
POST https://api.weixin.qq.com/wxa/business/gamematch/creatematchrule?access_token=ACCESS_TOKEN
参数说明:
team_count = 2;//队伍的数量,一般是2队,混战的话就按队伍数量来
team_member_count = 2;//每队的人数,如果是5V5就写5
need_room_service_info = 1;//是否需要房间服务,1表示开启,自动匹配开始游戏的话建议开启,这样满足匹配条件后会自动创建房间,省去了很多步骤
game_room_info={}//开启房间服务后需要设置的参数
//game_room_info的参数
game_tick = 33;//下发的周期,越小就越快
start_percent = 100;//玩家确认开始的比例,100表示房间内所有玩家都确认开始后才会开启帧同步,如果设置50表示50%,即1V1的话只要有一个玩家确认开始,另一个玩家没确认,帧同步也会自动开启
udp_reliability_strategy = 3;//不懂,默认值吧
need_user_info = false;
game_last_time = 180; //游戏时间,到达3分钟后自动结束游戏,不填的话默认20分钟,对局中设置了倒计时功能的话这边可以填,建议设置的长一点,这个参数设置了并不是说一定要打满3分钟,只是最大时间而已
need_game_seed = false;
发送给微信服务器后,会收到如下结果
{
"errcode": 0,
"errmsg":"ok",
"match_id":"FD0PT4rKguEdK-L83RaJgdbchUCW8wjhSwgCku4CLQk"
}
需要注意的是,获得了matchId并不是直接就能用的,需要调用setMatchIdOpenState接口把这个matchId的open_state状态设置为1才能用!!!
(https://developers.weixin.qq.com/minigame/dev/api-backend/open-api/gamematch/gamematch.setMatchIdOpenState.html)
设置状态后,把这个matchId保存到数据库里,当玩家匹配2V2时,就返回这个matchId给前端。
然后依葫芦画瓢,把1V1,5V5等其他匹配模式的matchId也申请好,open_state设为1,记到数据库里,前端匹配哪种就返回哪个matchId,至此匹配规则创建就完成了。
接下来一章,将展示如何使用这个matchId在cocos creator 3.x开发的小游戏中进行匹配。
简单的线上样例:
微信小游戏《精英坦克手》1V1匹配