cocos creator 3.x使用官方帧同步服务开发实时对战微信小游戏教程（一）

实时对战是联机游戏的核心，微信小游戏的官方服务有个自带的帧同步服务，以及配套的房间服务和对局匹配功能，目前这些功能都是免费的，对于心疼服务器资源的个人开发者而言是个不错的选择，但文档坑太多，本人也是调试了很久才在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匹配