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

  • Post author:
  • Post category:其他


实时对战是联机游戏的核心,微信小游戏的官方服务有个自带的

帧同步服务

,以及配套的

房间服务



对局匹配

功能,目前这些功能都是免费的,对于心疼服务器资源的个人开发者而言是个不错的选择,但文档坑太多,本人也是调试了很久才在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匹配



版权声明:本文为hangsky1990原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。