游戏联机对战引擎（腾讯云）快速入门

停服通知

游戏联机对战引擎将于2022年4月15日从Cocos Service下架。如果您需要自动化集成的功能，可以参考$HOME/.CocosCreator/services/mgobe中的代码，制作编译器插件。欢迎您将做好的插件发布到Cocos Store。感谢您一直以来的支持。

介绍

游戏联机对战引擎（Mobile Game Online Battle Engine，MGOBE） 为游戏提供房间管理、在线匹配、帧同步、状态同步等网络通信服务，帮助开发者快速搭建多人交互游戏。开发者无需关注底层网络架构、网络通信、服务器扩缩容、运维等，即可获得就近接入、低延迟、实时扩容的高性能联机对战服务，让玩家在网络上互通、对战、自由畅玩。游戏联机对战引擎适用于回合制、策略类、实时会话（休闲对战、MOBA、FPS）等游戏。

特性

实时云：依托腾讯云强大的网络和硬件资源，在国内多个地区部署云服务，使用多线 BGP 网络，并提供地域就近接入，确保更低延迟。
高可扩展性：自动伸缩的云服务，承接业务爆发式增长，从几十并发用户到上百万并发用户，页面一键扩容，无需购买服务器，无需服务器运维。
匹配机制：支持分数、模式、房间、地域多种匹配模式，还支持开发者自定义匹配机制，满足更多使用场景。
网络通信能力：支持帧同步和状态同步，快速、稳定实现客户端与其他客户端的通信。
快速接入：接口简单方便，只需要调用 JS 接口，即可快速实现房间管理、在线匹配、联网对战功能。
无忧定价：支持按量计费（每日最高在线、流量收费）和按套餐付费两种。从免费计划开始，随时调整配额。
实时服务器：房间管理会自动分配实时服务器，在实时服务器中运行实时对战和回合制游戏的逻辑，开发者无需购买服务器和运维，只需要填写游戏逻辑。
网络状态监控：实时网络监控，快速实现玩家掉线通知、弱网络通知和断线重连等功能。帮助开发者告知玩家所有玩家的网络状态，并在网络出现异常的情况下，及时作出相应处理。

应用场景

帧同步应用场景

适用场景：实时会话游戏 10 人以内，棋牌、策略类回合制游戏。
优点：开发效率高，客户端同步指令给其他客户端。业务逻辑由客户端计算处理。

状态同步应用场景

适用场景：实时会话游戏大于 10 人，棋牌、策略回合制游戏。
优点：容易防外挂，当人数比较多，客户端渲染压力大时，可以由服务端来处理。

计费

游戏联机对战引擎服务使用 预付费 模式，当你的服务使用超过服务商的免费部分，且账户余额不足时，会停止服务。这时候你需要在 Cocos 开发者账户中心进行 预充值。具体内容可参考计费说明。
若需购买资源包套餐，请参考腾讯云套餐购买方式。
Cocos 用户开通服务，并通过 Cocos 账户预付充值，即可享受优惠政策。

说明

在 Cocos Service 中开通的腾讯云账号，为 Cocos 主账号下的子账号，后台操作时可能会看到个别页面提示：您暂无当前操作权限，请添加下述权限后继续操作，但一般不影响使用，请尽量在小游戏云服务 - 控制台页面进行后台操作。可参考为什么我登录腾讯云控制台想查看一下费用中心时，会提示没有权限？。

一键接入游戏联机对战引擎服务

开通服务

使用 Cocos Creator 打开需要接入游戏联机对战引擎服务的项目工程。
点击菜单栏的 面板 -> 服务，打开服务面板，选择 游戏联机对战引擎，进入服务详情页。然后点击右上方的启用按钮即可开通服务。详情可参考服务面板操作指南。

开通服务后，Cocos Service 将自动开通游戏联机对战引擎服务、联通腾讯云账号，并集成游戏联机对战引擎 SDK 到游戏工程中。

若之前没有在 Cocos Service 服务面板开通过腾讯云服务，那么在跳转后登录的腾讯云控制台子账号的账号名，是开发者的 Cocos 账号邮箱，初始密码会发到该邮箱和 Cocos 后台站内信。建议登录后，将该子账号与微信绑定，之后便可使用微信扫码登录。

验证服务是否接入成功

游戏联机对战引擎服务接入完成后，我们可以通过在脚本中添加简单的代码，来验证接入是否成功。

点击游戏联机对战引擎服务设置面板中的 前往控制台，跳转到游戏联机对战引擎后台，获取接入参数 游戏 ID、游戏 key 和域名：

在脚本中调用游戏联机对战引擎的初始化，填入之前从游戏联机对战引擎后台获取的 游戏 ID、游戏 key 和域名：

  const gameInfo = {
      gameId: '从游戏联机对战引擎后台获取的游戏 ID',
      secretKey: '从游戏联机对战引擎后台获取的游戏 key',
      openId: '玩家 ID，可自定义',
  };

  const config = {
      url: '从游戏联机对战引擎后台获取的域名',
      reconnectMaxTimes: 5,
      reconnectInterval: 1000,
      resendInterval: 1000,
      resendTimeout: 10000,
  };

  // 实例化 Room 对象
  const room = new MGOBE.Room();
  MGOBE.Listener.init(gameInfo, config, event => {
      if (event.code === 0) {
          console.log("初始化成功");
          // 初始化成功之后才能调用其他 API
          // 查询玩家自己的房间
          room.getRoomDetail(event => {
              if (event.code !== 0 && event.code !== 20011) {
                  return console.log(event);
              }
              console.log("查询成功");
              if (event.code === 20011) {
                  console.log("玩家不在房间内");
              } else {
                  // 玩家已在房间内
                  console.log("房间名", event.data.roomInfo.name);
              }
          });
      }
  });

脚本修改完成并保存后，回到编辑器。在编辑器上方选择 浏览器，然后点击预览按钮，若能在控制台中看到初始化和登录日志，即为接入成功。

Sample 工程

点击游戏联机对战引擎服务面板中的 Sample 工程 按钮，Clone 或下载，并在 Cocos Creator 中打开。
在服务面板中开通游戏联机对战引擎服务。
脚本修改完成并保存后，回到编辑器。点击编辑器窗口正上方的预览按钮，即可在浏览器中调试该项目工程。

游戏联机对战引擎还提供了 TypeScript 版本的 Demo，展示了更多功能，具体请参考腾讯云官方文档 Cocos 引擎案例。

另外，我们还开发了一个斗兽棋对战游戏开心鼠吃象，后端使用腾讯云的 MGOBE 游戏联机对战引擎 和 TCB 云开发 两个游戏云服务，实现了 Serverless 架构，使小游戏能够轻后端、免运维、代码自动部署，可点击链接在 Cocos Store 中购买下载。

实时服务器面板使用说明

若需要使用实时服务器，创建服务后，请在游戏联机对战引擎服务面板下方，点击 初始化框架 按钮，选择 JavaScript 或者 TypeScript 语言版本，进行本地框架代码初始化操作。
游戏联机对战引擎 与 云开发 共用 云函数 面板，若初始化框架后没有出现云函数面板，可以在 菜单 -> 面板 -> 云函数 中重新打开。
以 TS 版本为例，初始化后，在云函数面板中会出现 mgobe-server，该文件夹为游戏联机对战引擎的实时服务器框架。src/mgobexs/index.ts 为实时服务器主文件。
修改主文件后，可以在云函数任意层级点击右键，选择 立即发布，即可上传代码进行调试。
调试与服务端日志获取可参考：实时服务器日志。