腾讯云Web前端工程师
小游戏联机对战引擎(Mini Game Online Battle Engine,MGOBE)为游戏提供房间管理、在线匹配、帧同步、状态同步等网络通信服务,帮助开发者快速搭建多人交互游戏。本次课程将介绍 MGOBE 的主要接口,并以一个双人对战游戏为例,讲解如何使用 MGOBE 快速开发帧同步游戏。
课程收益:
1、了解MGOBE帧同步概念及应用
2、实现猪猪对战开发案例
课程内容:
1、小游戏联机对战引擎 MGOBE 简介
2、用帧同步构建实时对战游戏-猪猪对战demo实践
适用棋牌、回合制/策略、实时会话类的游戏。创建一个房间,将房间 ID 生成到邀请链接,发送给朋友,朋友加入一起玩,加入房间即可。游戏不同客户端的通信可以使用帧同步,也可以直接按需发送信息。例如棋牌创建一个私有房间,可以设置邀请码、牌局总数、以及其他参数等,然后邀请好友进来玩。
例如欢乐斗地主,可以加入一个初级、中级、高级牌局,快速匹配队友。初级、中级、高级等类型由房间类型定义,使用在线匹配,可以匹配到合适的队友。例如王者荣耀、球球大作战等。
猪猪对战demo是一款1V1的双人对战帧同步游戏,玩家可以通过邀请好友或者快速加房组成对局,然后使用帧同步实现不同玩家之间游戏逻辑的同步。demo包含四个页面,分别是授权页、首页、房间页、对战页。玩家进入首页后,点击“快速开始”或者“邀请好友”按钮进入房间页;双方点击房间页“准备按钮”后可以进入对战页面开始游戏。
涉及到的MGOBE接口有房间匹配(matchRoom)、创建房间(createRoom)、加入房间(joinRoom)、查询房间信息(getRoomDetail)、退出房间(leaveRoom)、修改玩家状态(changeCustomPlayerStatus)、开始帧同步(startFrameSync)、帧同步广播(onRecvFrame)。
小游戏联机对战引擎(Mini Game Online Battle Engine,MGOBE)主要为小游戏提供多人联机对战服务,帮助开发者快速搭建多人交互小游戏。依托腾讯云强大的网络、硬件资源,开发者无需关注游戏底层网络架构、网络通信、服务器扩缩容、运维,只需要通过 SDK 调用 MGOBE 后台服务,即可获得就近接入、低延迟、实时扩容的高性能联机对战服务。
目前 MGOBE 具备了房间管理、玩家匹配、房间消息、帧同步、状态同步、实时服务器等服务能力,开发者只需要在小游戏中调用 SDK 接口,就能轻松接入联机对战,让玩家在网络上互通、对战、自由畅玩。
MGOBE 客户端 SDK 的接口可以分为五类,包括房间管理、匹配、消息发送、帧同步、广播接口。
房间管理类的接口主要是用于将不同玩家组成一个对局,这个过程中可以通过创建房间、邀请他人加入房间等方式将玩家聚合在一起。此外,还提供了如踢人、修改房间属性、查询房间信息等基本的房间管理方法。
匹配类的接口主要是用于将不同玩家通过匹配的方式组成对局,开发者可以根据需要定制匹配规则,实现根据玩家等级、积分进行匹配。
帧同步和消息发送接口可以用于玩家消息的交互,通过帧同步、状态同步方式实现玩家游戏逻辑的同步。
广播类接口主要是用于处理上述接口调用产生的广播事件,比如玩家加房、退房广播、帧消息广播等等。
客户端在使用SDK时的主要流程有4步,可以参考官网文档:
// 使用 import/from
import * as MGOBE from "./js/libs/MGOBE.js";
const { Room, Listener, ErrCode, ENUM, DebuggerLog } = MGOBE;
// 使用 require
const MGOBE = require("./js/libs/MGOBE.js");
const { Room, Listener, ErrCode, ENUM, DebuggerLog } = MGOBE;
const gameInfo = {
openId: 'xxxxxx',
gameId: "xxxxxx",// 替换为控制台上的“游戏ID”
secretKey: 'xxxxxx',// 替换为控制台上的“密钥”
};
const config = {
url: 'xxx.wxlagame.com',// 替换为控制台上的“域名”
reconnectMaxTimes: 5,
reconnectInterval: 1000,
resendInterval: 1000,
resendTimeout: 10000,
};
Listener.init(gameInfo, config, event => {
if (event.code === 0) {
// 初始化成功
// 继续在此添加代码
// ...
}
});
const room = new Room();
// 监听
Listener.add(room);
// 创建房间
room.createRoom(para, callback);
// 监听加房广播
room.onJoinRoom = event => console.log("有玩家加入");
在将各个玩家加到同一个房间形成对局的过程中,需要用到创建房间、踢人、修改房间信息等操作。以微信小戏平台**邀请玩家**为例,整个流程如下:
其中,“生成邀请链接”、“分享”都是使用微信的接口实现,“创建房间”、“加入房间”使用 MGOBE 相应接口实现。在这个过程中,房间信息可能会由于多次操作引起多次更新,比如玩家进房、退房、修改状态等。为了方便管理房间信息更新,可以使用 onUpdate 接口:
const room = new Room();
room.onUpdate = () => {
console.log("房间信息已更新", room.roomInfo);
// 渲染画面
// ...
};
在处理应用重启的场景时,需要在打开应用时检查玩家是否在房间中、是否在游戏中等信息,可以通过 getRoomDetail 接口查询:
// 查询玩家自己的房间
room.initRoom();
room.getRoomDetail(event => {
if (event.code === 0) {
console.log("玩家已在房间内:", event.data.roomInfo.name);
// 继续判断玩家是否在游戏中
// ...
return;
}
if (event.code === 20011) {
console.log("玩家不在房间内");
return;
}
});
MGOBE 为开发者提供了两种匹配方式:matchRoom 和 matchPlayers,分别表示房间匹配和玩家匹配。在两次分享课程中分别以猪猪对战和答题游戏为例介绍了这两种匹配方式的用法。
房间匹配是以 maxPlayers 和 roomType 为参数,寻找 maxPlayers、roomType 属性值一致的房间,如果存在这种房间,则将玩家加入,否为为玩家创建一个新房间。适合需要快速加房的场景,用法如下:
const playerInfo = {
name: "Tom",
customPlayerStatus: 1,
customProfile: "https://xxx.com/icon.png",
};
const matchRoomPara = {
playerInfo,
maxPlayers: 5,
roomType: "1",
};
room.matchRoom(matchRoomPara, event => {
if (event.code !== 0) {
console.log("匹配失败", event.code);
}
});
玩家匹配更加灵活,开发者需要在控制台上创建匹配规则,得到匹配Code作为该接口参数。玩家触发该接口后会与其他玩家进行匹配,满足匹配规则的玩家会被匹配在一起。
{
"version": "V1.0",
"teams": [
{
"name": "4人房间",
"maxPlayers": 4,
"minPlayers": 4,
"number": 1
}
]
}
{
"version": "V1.0",
"teams": [
{
"name": "3v3",
"maxPlayers": 3,
"minPlayers": 3,
"number": 2
}
],
"playerAttributes": [
{
"name": "level",
"type": "number"
}
],
"rules": [
{
"type": "segment",
"expression": "teams[i].players.level",
"value": [
[
1,
100
]
]
}
]
}
客户端 SDK 调用方法:
const playerInfo = {
name: "Tom",
customPlayerStatus: 1,
customProfile: "https://xxx.com/icon.png",
matchAttributes: [{
name: "level",
value: 99,
}]
};
const matchPlayersPara = {
playerInfo,
// 匹配Code 需要从控制台配置获取
matchCode: "match-xxx",
};
// 发起匹配
room.matchPlayers(matchPlayersPara, event => {
if (event.code === 0) {
console.log("匹配成功", room.roomInfo);
} else {
console.log("匹配失败", event.code);
}
});
帧同步需要使用 sendFrame、onRecvFrame 进行发帧、处理帧广播。客户端逻辑依靠于 onRecvFrame 进行更新,游戏状态计算也是在客户端完成。在帧同步之前需要调用 startFrameSync 触发开始帧同步:
// 开始帧同步
room.startFrameSync({}, event => {
if (event.code === 0) {
console.log("开始帧同步成功");
}
});
// 开始帧同步广播回调
room.onStartFrameSync = event => console.log("开始帧同步");
开始帧同步成功之后玩家可以向 MGOBE 后台发送帧消息指令。以猪猪对战为例,玩家点击屏幕后会向后台发送一条 jump 指令。MGOBE 后台会将全部玩家的消息指令组成一个帧广播,并且定时下发(如每秒15次):
const frame = {cmd: "jump"};
room.sendFrame({ data: frame }, event => console.log(event));
// 处理帧广播
room.onRecvFrame = event => {
console.log("帧广播", event.data.frame);
// 计算游戏逻辑状态
// ...
};
开发者在游戏中往往会有同步随机数的需求,比如”炸弹“的位置需要随机出现、“伤害值”存在随机性等。MGOBE 的每个帧广播都带上了一个随机种子,可以结合 SDK 提供的随机数工具来生成随机数,并且可以确保在不同客户端生成的随机数序列是一致的:
room.onRecvFrame = event => {
console.log("帧广播", event.data.frame);
// 使用帧广播随机种子和帧ID组成新的随机种子
const seed = event.data.frame.ext.seed + event.data.frame.id;
// 收到帧广播后初始化随机出工具
MGOBE.RandomUtil.init(seed);
// 生成随机数
const r1 = MGOBE.RandomUtil.random();
const r2 = MGOBE.RandomUtil.random();
const r3 = MGOBE.RandomUtil.random();
// 利用随机数执行相应逻辑
// ...
};
MGOBE 能为开发者快速实现游戏房间管理、在线匹配、联网对战等功能,大家可以到腾讯云官网产品页中搜索“MGOBE”进一步了解。也欢迎大家扫码加入开发者群交流。