腾讯云大学大咖分享 | 小游戏联机对战引擎实践

腾讯云大学本期直播课程邀请到了腾讯云Web前端工程师通过两个小游戏demo,讲解了小游戏联机对战引擎中帧同步和状态同步两种应用场景。「腾讯云大学」联合「云加社区」为大家整理了课程精彩干货!

  • 《猪猪对战》教学课程点击观看完整课程
  • 《答题游戏》教学课程点击观看完整课程

实践案例背景

  • 帧同步游戏 - 猪猪对战

猪猪对战demo是一款1V1的双人对战帧同步游戏,玩家可以通过邀请好友或者快速加房组成对局,然后使用帧同步实现不同玩家之间游戏逻辑的同步。demo包含四个页面,分别是授权页、首页、房间页、对战页。玩家进入首页后,点击“快速开始”或者“邀请好友”按钮进入房间页;双方点击房间页“准备按钮”后可以进入对战页面开始游戏。

涉及到的MGOBE接口有房间匹配(matchRoom)、创建房间(createRoom)、加入房间(joinRoom)、查询房间信息(getRoomDetail)、退出房间(leaveRoom)、修改玩家状态(changeCustomPlayerStatus)、开始帧同步(startFrameSync)、帧同步广播(onRecvFrame)。

  • 状态同步游戏 - 答题游戏

答题游戏是一款使用MGOBE实时服务器实现的状态同步的组队答题类游戏。玩家通过随机匹配组成对局,然后与实时服务器进行交互,获取游戏状态(题目信息、玩家信息)。demo包含六个页面:授权页、首页、匹配页、房间页、答题页、结算页。玩家在首页通过三种匹配方式(1V1、2V2、3V3)进入房间,玩家向实时服务器发送准备指令后会进入答题页。选择答案后提交到实时服务器,由实时服务器的逻辑判断答案的正误,并且下发新的游戏状态给每个玩家。

涉及到的MGOBE接口有玩家匹配(matchPlayers)、查询指定房间信息(getRoomByRoomId)、退出房间(leaveRoom)、发送实时服务器消息(sendToGameSvr)、实时服务器广播(onRecvFromGameSvr)。

MGOBE 简介

小游戏联机对战引擎(Mini Game Online Battle Engine,MGOBE)主要为小游戏提供多人联机对战服务,帮助开发者快速搭建多人交互小游戏。依托腾讯云强大的网络、硬件资源,开发者无需关注游戏底层网络架构、网络通信、服务器扩缩容、运维,只需要通过 SDK 调用 MGOBE 后台服务,即可获得就近接入、低延迟、实时扩容的高性能联机对战服务。

目前 MGOBE 具备了房间管理、玩家匹配、房间消息、帧同步、状态同步、实时服务器等服务能力,开发者只需要在小游戏中调用 SDK 接口,就能轻松接入联机对战,让玩家在网络上互通、对战、自由畅玩。

接口概览

MGOBE 客户端 SDK 的接口可以分为五类,包括房间管理、匹配、消息发送、帧同步、广播接口。

房间管理类的接口主要是用于将不同玩家组成一个对局,这个过程中可以通过创建房间、邀请他人加入房间等方式将玩家聚合在一起。此外,还提供了如踢人、修改房间属性、查询房间信息等基本的房间管理方法。

匹配类的接口主要是用于将不同玩家通过匹配的方式组成对局,开发者可以根据需要定制匹配规则,实现根据玩家等级、积分进行匹配。

帧同步和消息发送接口可以用于玩家消息的交互,通过帧同步、状态同步方式实现玩家游戏逻辑的同步。

广播类接口主要是用于处理上述接口调用产生的广播事件,比如玩家加房、退房广播、帧消息广播等等。

客户端 SDK 使用流程

客户端在使用SDK时的主要流程有4步,可以参考官网文档:

  • 导入SDK,在微信小游戏环境中可以使用 import 或者 require 语法。
代码语言:txt
复制
// 使用 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;
  • 初始化 Listener 对象。
代码语言:txt
复制
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) {
        // 初始化成功
        // 继续在此添加代码
        // ...
    }
});
  • 实例化 Room 对象,加入到监听。
代码语言:txt
复制
const room = new Room();
// 监听
Listener.add(room);
  • 通过 room 实例调用方法,并处理广播回调。
代码语言:txt
复制
// 创建房间
room.createRoom(para, callback);
// 监听加房广播
room.onJoinRoom = event => console.log("有玩家加入");

房间管理

在将各个玩家加到同一个房间形成对局的过程中,需要用到创建房间、踢人、修改房间信息等操作。以微信小戏平台**邀请玩家**为例,整个流程如下:

其中,“生成邀请链接”、“分享”都是使用微信的接口实现,“创建房间”、“加入房间”使用 MGOBE 相应接口实现。在这个过程中,房间信息可能会由于多次操作引起多次更新,比如玩家进房、退房、修改状态等。为了方便管理房间信息更新,可以使用 onUpdate 接口:

代码语言:txt
复制
const room = new Room();
room.onUpdate = () => {
    console.log("房间信息已更新", room.roomInfo);
    // 渲染画面
    // ...
};

在处理应用重启的场景时,需要在打开应用时检查玩家是否在房间中、是否在游戏中等信息,可以通过 getRoomDetail 接口查询:

代码语言:txt
复制
// 查询玩家自己的房间
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,分别表示房间匹配和玩家匹配。在两次分享课程中分别以猪猪对战和答题游戏为例介绍了这两种匹配方式的用法。

  • matchRoom

房间匹配是以 maxPlayers 和 roomType 为参数,寻找 maxPlayers、roomType 属性值一致的房间,如果存在这种房间,则将玩家加入,否为为玩家创建一个新房间。适合需要快速加房的场景,用法如下:

代码语言:txt
复制
 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);
        }
    });
  • matchPlayers

玩家匹配更加灵活,开发者需要在控制台上创建匹配规则,得到匹配Code作为该接口参数。玩家触发该接口后会与其他玩家进行匹配,满足匹配规则的玩家会被匹配在一起。

  • 示例1。四人随机匹配:
代码语言:txt
复制
{
    "version": "V1.0",
    "teams": [
        {
            "name": "4人房间",
            "maxPlayers": 4,
            "minPlayers": 4,
            "number": 1
        }
    ]
}
  • 示例2。3V3 根据玩家段位(level)进行匹配,并且玩家 level 属性值在 1 ~ 100 内的不同玩家才能匹配在一起,规则如下:
代码语言:txt
复制
{
    "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 调用方法:

代码语言:txt
复制
    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 触发开始帧同步:

代码语言:txt
复制
// 开始帧同步
    room.startFrameSync({}, event => {
        if (event.code === 0) {
            console.log("开始帧同步成功");
        }
    });
    // 开始帧同步广播回调
    room.onStartFrameSync = event => console.log("开始帧同步");

开始帧同步成功之后玩家可以向 MGOBE 后台发送帧消息指令。以猪猪对战为例,玩家点击屏幕后会向后台发送一条 jump 指令。MGOBE 后台会将全部玩家的消息指令组成一个帧广播,并且定时下发(如每秒15次):

代码语言:txt
复制
 const frame = {cmd: "jump"};
    room.sendFrame({ data: frame }, event => console.log(event));
    // 处理帧广播
    room.onRecvFrame = event => {
        console.log("帧广播", event.data.frame);
        // 计算游戏逻辑状态
        // ...
    };

开发者在游戏中往往会有同步随机数的需求,比如”炸弹“的位置需要随机出现、“伤害值”存在随机性等。MGOBE 的每个帧广播都带上了一个随机种子,可以结合 SDK 提供的随机数工具来生成随机数,并且可以确保在不同客户端生成的随机数序列是一致的:

代码语言:txt
复制
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();

    // 利用随机数执行相应逻辑

    // ...

};</code></pre></div></div><h3 id="6cf3r" name="%E7%8A%B6%E6%80%81%E5%90%8C%E6%AD%A5%E5%BA%94%E7%94%A8">状态同步应用</h3><p>状态同步类型联机游戏的特点是游戏逻辑状态在服务端计算。为了实现状态同步,MGOBE 为开发者提供了实时服务器功能,开发者可以上传代码部署到实时服务器上,并且与客户端 SDK、房间服务进行交互。</p><figure class=""><div class="rno-markdown-img-url" style="text-align:center"><div class="rno-markdown-img-url-inner" style="width:100%"><div style="width:100%"><img src="https://cdn.static.attains.cn/app/developer-bbs/upload/1722938801016148483.png" /></div></div></div></figure><p>实时服务器实现了对客户端游戏逻辑的扩展。玩家进入房间之后,对房间进行的任何操作,都会通过房间服务器同步给实时服务器,那这样实时服务器上也能拿到最新的房间状态,比如玩家进房、退房、掉线、开始帧同步等等。</p><p>客户端可以通过 sendToGameSvr请求接口、onRecvFromGameSvr广播接口实现和实时服务器进行交互。</p><ul class="ul-level-0"><li>客户端代码</li></ul><div class="rno-markdown-code"><div class="rno-markdown-code-toolbar"><div class="rno-markdown-code-toolbar-info"><div class="rno-markdown-code-toolbar-item is-type"><span class="is-m-hidden">代码语言:</span>txt</div></div><div class="rno-markdown-code-toolbar-opt"><div class="rno-markdown-code-toolbar-copy"><i class="icon-copy"></i><span class="is-m-hidden">复制</span></div></div></div><div class="developer-code-block"><pre class="prism-token token line-numbers language-txt"><code class="language-txt" style="margin-left:0">// 发送消息给实时服务器

room.sendToGameSvr({data: { cmd: 1 }}, event => console.log(event));
// 接收实时服务器广播
room.onRecvFromGameSvr = event => {
console.log("新自定义服务消息", event);
// 更新游戏画面
// ...
}

  • 实时服务器代码
代码语言:txt
复制
// 接收客户端消息
onRecvFromClient = args => {
// 客户端消息
const data = args.actionData;
// 计算游戏状态 gameData
// ...
// 发送游戏状态给客户端
args.SDK.sendData({ playerIdList: [], data: { gameData } });
args.SDK.exitAction();
};

通过这种方式,开发者可以把玩家的游戏输入全部发送给实时服务器,然后由实时服务器计算游戏状态,并且广播给每个客户端,实现游戏状态同步。

常见问题

Q:createRoom、matchRoom、matchPlayers接口主要区别是什么?

A:createRoom 创建房间并且加入到该房间。matchRoom 根据参数匹配到一样的房间,并且进入。如果没有合适的房间,按照该参数创建新房间。matchPlayers 需要在控制台上配置匹配规则,拿到匹配code,以此为参数进行匹配。匹配成功后进入房间。

Q:创建房间后需要调用joinRoom吗?

A:不需要,调用 createRoom 后玩家会自动进入房间。不需要,匹配成功玩家会自动进入房间。开发者可能开通了实时服务器,但是没有正常运行,比如没有发布代码。新版本即将支持 H5原生环境,可以直接在浏览器中运行。检查 room 实例是否加入到 Listener。

Q:匹配成功后需要创建房间吗?

A:创建房间或匹配的时候出现40010、40011错误

Q:如何在浏览器中进行调试?

A:SDK 没有收到广播

结语

MGOBE 能为开发者快速实现游戏房间管理、在线匹配、联网对战等功能,大家可以到腾讯云官网产品页中搜索“MGOBE”进一步了解。也欢迎大家扫码加入开发者群交流。

关注“腾讯云大学”公众号,回复【加群】进入交流群

腾讯云大学是腾讯云旗下面向云生态用户的一站式学习成长平台。腾讯云大学大咖分享邀请行业技术大咖,为你提供免费、专业、行业最新技术动态分享。