如何将匹配功能集成到您的MMORPG多人游戏中

-> 本文基于 匹配文档。如果您遇到问题或差异，请确保参考 原始指南，因为它们更经常保持最新。

以下示例将帮助您测试核心 匹配 玩家流程，即：

• 在共享 托管集群上创建匹配器实例，

• 在您的匹配器 配置中定义规则和设置，

• 最后，测试玩家流程并通过我们的 API 管理 玩家票。

实施我们的匹配器到您的游戏需要 五个步骤：

1. 第一步是 创建一个账户 并使用我们的MMORPG游戏示例。Voilà，您（从技术上讲）已经完成了一半！您只需要在您的游戏中集成匹配器（见第5步）。

2. 现在，您绝不要盲目跟随您在网上找到的JSON示例，因此强烈建议将上述规则调整为您的回合制游戏。第二步（“探索配置”）是我们“如何阅读”，深入到每个 匹配规则函数的功能（“探索配置”）。

3. 第三步（“审查实例详情”）涵盖您的个人特定 匹配器 以确保它已部署并与您游戏的设计相匹配。

4. 第四步，顾名思义（“4. 测试票据API”），完全是关于测试玩家的匹配请求是否被匹配器接收，称为 票据。

5. 第五步（“将匹配功能集成到您的游戏”）强调如何将匹配器集成到您引擎的项目中。

如果您有故障排除的挑战，我们的深入 学习中心 提供额外的故障排除技巧。

1. 设置免费层

注册您的免费Edgegap账户，并导航至 匹配器仪表板页面。

从那里，首先单击 创建匹配器 ，然后输入：

• 为您的匹配器命名 - 这纯粹是为了您自己的参考，例如 quickstart-dev，

• 然后，将以下简单示例作为您MMORPG游戏的JSON配置上传：

{
  "version": "2.1.0",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "ticket_expiration_period": "5m",
  "ticket_removal_period": "1m",
  "profiles": {
    "custom-lobby-example": {
      "application": {
        "name": "my-game-server",
        "version": "2024.01.30-16.23.00-UTC"
      },
      "rules": {
        "initial": {
          "match_size": {
            "type": "player_count",
            "attributes": {
              "team_count": 1,
              "team_size": 4
            }
          },
          "lobby_id": {
            "type": "string_equality"
          }
        },
        "expansions": {}
      }
    }
  }
}

(温馨提示，请确保更改应用程序 名称 和 版本 以匹配您的 应用程序和版本!)

如果没有验证错误出现，点击 创建并启动 ，并等待该过程完成。这将导致一个新的免费集群启动，配有您的简单示例匹配器。

您现在可以继续到下一步。

2. 探索配置​

独特的多人MMORPG游戏规则

自定义大厅（私人大厅、沙盒关卡）是沙发多人游戏非常流行的选择，但也是在进入主要游戏模式之前测试竞争或合作游戏中新功能的选项。这些游戏通常需要最少的限制，但旨在确保玩家可以 作为小组加入。

补位票据可以使用自定义大厅配置文件来支持可靠地邀请朋友，只要补位票据是有效的。

• 提示: 将 custom-lobby-example 配置文件添加到您的配置中 以补充您的其他配置文件 以支持自定义大厅。

语义版本控制

随着我们向匹配器发布更新，每个新版本使用 语义版本控制 清楚地传达更改的影响，通过解释格式 major.minor.patch：

• major 版本包括破坏性更改并需要集成审核，

• minor 版本包括大量向后兼容的改进，

• patch 版本包括错误修复和小改进。

一些 部署可能会导致错误。我们尝试通过自动重试部署最多 max_deployment_retry_count 次来解决此问题（无需客户确认）。

为了确保意外的客户端崩溃或被放弃的票据不会停留并占用您的匹配器资源，票据将在 ticket_expiration_period 后被取消，状态将更改为 CANCELLED ，然后在 ticket_removal_period 后被永久删除。

我们匹配逻辑的核心配置在 匹配配置文件中。每个配置文件都是一个完全独立的匹配队列，指向具有预定义的所需CPU和内存（RAM）资源的 应用版本。

匹配规则 在初始规则集中，必须满足以便于玩家聚集在一起，每个规则由三个属性定义：

• 您选择的名称，例如 - 匹配大小，

• 规则类型，也称为运算符，例如 - 玩家数量，

• 最后是运算符属性，例如 团队数量 或 团队大小。

玩家数量规则

这是一个特殊规则，定义多少个玩家需要匹配以启动分配：

• 团队数量 指的是队伍数量，1个队伍可以用于合作或全自由模式，

• 团队大小 指的是每队的 玩家数量。

我们的简单示例展示了一个有2名玩家的合作游戏。

请注意，“玩家数量”规则 是必需的，并且只能在您的初始配置规则中定义一次。

延迟规则

使用此规则为所有玩家提供最低的可能延迟。一旦客户端测量并提交其往返时间（延迟）与所有可用信标的值，Gen2将只考虑在特定的 差异 延迟值范围内进行匹配，以便与 延迟信标进行比较。这为分割玩家基础提供了一种“软”解决方案，能够与邻近区域的匹配，尤其是改善人口较少区域的匹配速度。使用 max_latency来防止与遥远玩家的匹配。

您现在可以继续到下一步。

我们的示例 信标 上面的规则为 "difference": 50, "max_latency": 200 最初：

• Alice和Bob将匹配，因为北京被丢弃（>200），其余在 | A-B | < 50内：

  • Alice {Montreal: 12.3, Newark: 45.6, Dallas: 59.9, Beijing: 264.4}; 和

  • Bob {Montreal: 27.3, Newark: 32.4, Dallas: 23.1, Beijing: 252.2}。

• Charlie和Dave不会匹配，因为| C-D | > 50对于达拉斯信标：

  • Alice {Montreal: 5.7 Newark: 44.2, Dallas: 59.5, Beijing: 263.2}; 和

  • Bob {Montreal: 57.8, Newark: 32.0, Dallas: 24.2, Beijing: 272.3}。

请注意，“延迟规则” 只能在您的初始配置规则中定义一次。

3. 审查实例详情​

在仪表板中查看您的新匹配器的详细信息，一旦其初始化：

状态 指示服务状态，可能是在线、离线或错误。

• 标识符 可以帮助Edgegap员工快速找到您的匹配器，如果您需要故障排除的帮助。

• 开始于 可以用于跟踪最新的更新时间。

• 规模 对应于我们的一种 定价层。

• API URL 将被游戏客户端和游戏服务器用于与Gen2通信。

• Swagger URL 是我们提供的一个便利开放API规范GUI，用于探索API架构。

• Auth Token 是一个独特的秘密令牌，用于游戏客户端和游戏服务器进行身份验证。

要使用API测试您的新匹配器， 您将需要Swagger URL、API URL和Auth Token。

您现在可以继续到下一步。

4. 测试票据API

首先, 打开您的Swagger URL 以检查您的openAPI架构在swagger GUI中

单击“匹配器”标题下方的 /...swagger.json URL以打开原始JSON架构：

将此页面保存为您驱动器上的文件 (CTRL/CMD+S)。

打开您的 Postman应用程序 并登录到您的免费账户。

从上一步导入您的 swagger.json 文件：

• 保持 Postman集合 被选中，

• 选择 查看导入设置 并将设置 参数生成 更改为 示例。

确认导入，这将导致在左侧集合列表中出现一个新的集合，标题为匹配器。

查看更多操作，打开选项卡 授权 并选择：

• Auth类型 - API密钥,

• 键 - “授权”

• 值 - 在此插入您的 AuthToken 值，

• 添加到 - 头部。

按下(CTRL/CMD+S) 或保存图标来 保存更改。您Postman标签中的橙点应消失。

在您的匹配器集合中，选择 票据 并 创建一个匹配票据，打开一个新标签。

选择选项卡 主体 以预览您的 玩家票请求：

注意 player_ip 设置为 null - 这将导致使用自动添加到请求中的IP地址（请参阅 服务器到服务器集成 以获取替代方案），

• profile 指的是您的 匹配配置文件，

• attributes 包括您匹配器规则的值，在本例中为 延迟 规则，

  • 规则 player_count 是唯一一条不需要任何属性的玩家票。

注意: 请确保参考示例的 Swagger的导入配置. 

单击 发送 并查看对您的玩家票请求的响应：

• id 是您的独特匹配票ID，请保持此信息以稍后检查您的票，

• profile 确认所选择的 匹配配置文件，

• group_id 是发给每个票的独特组ID，单个玩家表示为1组，

  • 见 作为小组加入 以与您的朋友或大厅进行匹配，

• player_ip 是玩家解析后的公共IP地址，无论使用的识别方法如何，

• assignment 设置为 null 以指示票尚未匹配或分配到服务器，

• created_at 提供有关玩家票创建时间的信息，以便游戏UI使用，

• status 指示票的当前状态，所有票起始于 SEARCHING （有关详细信息，请参阅 匹配过程）。

通过再次点击 发送 创建第二张票，以使我们的两名玩家匹配并启动服务器。

在您的匹配器集合中，选择 {ticketId} 并 读取匹配票。

输入前一步响应中的票ID并单击 发送。

查看您的玩家票的更新分配：

• 状态首先更改为 MATCH_FOUND ，同时保持 assignment 设置为 null 以指示玩家已匹配并正在分配服务器，

再次单击 发送 以检查您的票，并查看您的玩家票的更新分配：

• 状态更改为 HOST_ASSIGNED ， assignment 包含分配服务器的详细信息。

 检查您在仪表板中的新部署：

• 注意每个部署都带有所有票ID和配置文件的标记，以增加可追溯性。

尝试从您的游戏客户端连接到分配的服务器。

一旦您验证能够无问题地连接到您的部署并完成测试， 停止您的部署 以腾出您账户中下一个构建的容量。

您现在可以继续到下一步。

5. 在您的游戏中集成匹配器​

Edgegap的匹配功能集成：

• 与 游戏客户端，管理 玩家票，

• 与 游戏服务器，以：

  • 处理通过他们票据传递来的玩家偏好，

  • 可选地支持 补位 以在启动后添加或替换玩家。

在 游戏客户端中，我们建议在整个 匹配过程 中向玩家提供票状态更新，使用游戏中的UI以获得最佳的玩家体验。见：

• Edgegap - Unity Gen2匹配SDK,

  • 导入简单示例 并根据您的需求自定义，

• Betide Studio - 虚幻引擎Edgegap集成工具包,

  • 下载示例项目 并根据您的需求自定义。

在 游戏客户端中，确保您处理不可重试的错误：

• HTTP 404 Not Found - 票据已被删除，

• HTTP 500 Internal Server Error - 暂时服务中断。

在 游戏服务器中，处理玩家偏好和初始服务器上下文。无需API集成：

1. 读取 注入环境变量（Gen2） 以检索初始玩家的匹配数据。

2. 读取 注入环境变量（应用版本） 以获取版本特定的参数、设置（玩家容量）和秘密。

3. 读取 注入环境变量（部署） 以获取部署信息，例如IP地址、位置等。

一旦玩家连接， 游戏服务器和游戏客户端 启动加载场景以执行同步步骤（例如选择和加载地图/场景/级别）。我们建议制作一个完整的3D场景、像大厅一样的社交UI，或一个带有进度条的加载屏幕，以指示初始化正在进行中。

一旦 游戏客户端 完全加载，玩家将加载/前往主游戏场景。

可选地， 游戏服务器 可以创建和管理 补位 和玩家容量（添加或替换离开的玩家）。

确保您的 部署将正确停止 使用 注入的DELETE_URL，如果：

• 没有玩家加入比赛，

• 所有玩家已离开比赛，

• 比赛正确结束。

恭喜您，已完成Edgegap匹配器集成！如果您想了解更多，请在我们的学习中心阅读更多内容。