了解Edgegap的工作原理

了解Edgegap的工作原理

如何为社交多人游戏添加配对功能

已发布

已发布

已发布

关键洞察

关键洞察

关键洞察

Edgegap 的 匹配器 是一个完全托管、可无限定制的匹配系统,能够最优地将全球玩家分组——在您开发社交多人游戏期间使用是免费的。

它也是我们所知道的唯一一个具有 基于延迟的匹配规则 的匹配系统,为您的游戏提供理想的在线多人体验,无论您使用何种引擎(Unity、Unreal 等)或游戏服务(EOS、UGS、PlayFab、Heroic Labs Nakama、Braincloud 等)。

由于我们的匹配器基于参数,因此无需编写代码。因此,集成非常简单,如有需要,我们的 入门指南 会在每一步中指导您。

当您的游戏上线时,由于我们的匹配系统是完全托管的,您无需处理基础设施、错误、停机、可扩展性或数据库管理。我们为您处理所有事务,使您的 DevOps 工作量减少到几乎为零。

如何将匹配集成到您的社交多人游戏中

-> 本文基于匹配文档。如果您遇到问题或出入,请务必参阅原始指南,因为其更新更为频繁。

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

将我们的匹配器实现到您的游戏共有五个步骤:

  1. 第一步是创建账户并使用我们的社交游戏示例。瞧,您(在技术上)已经完成一半了!您只需要将匹配器集成到您的游戏中(见第 5 步)。

  2. 现在,您绝不应该盲目遵循在网上找到的 JSON 示例,因此强烈建议根据您的回合制游戏调整上述规则。第 2 步(“浏览配置”)是我们的“使用说明”,详细介绍了每个匹配规则函数的功能(“浏览配置”)。

  3. 第 3 步(“检查实例详细信息”)涵盖您的个人专属匹配器,以确保其已部署并与您的游戏设计协同工作。

  4. 第 4 步正如其名(“4. 测试票证 API”),主要关于测试匹配器是否收到来自玩家的匹配请求,这些请求称为票证。

  5. 第 5 步(“在您的游戏中集成匹配”)重点介绍如何在引擎项目中集成匹配器。

如果您遇到故障排除难题,我们深入的学习中心提供了额外的排错技巧。

1. 设置免费层级

注册您的免费 Edgegap 账户,并导航至 Matchmaker 仪表板页面。

在页面中,先点击 Create Matchmaker,然后输入:

  • 您的匹配器名称——这纯粹供您自己参考,例如 quickstart-dev,

  • 然后,为您的社交多人游戏上传以下简单示例作为 JSON 配置:

{
  "version": "2.1.0",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "ticket_expiration_period": "5m",
  "ticket_removal_period": "1m",
  "profiles": {
    "social-example": {
      "application": {
        "name": "my-game-server==>CHANGE-THIS",
        "version": "2024.01.30-16.23.00-UTC==>CHANGE-THIS"
      },
      "rules": {
        "initial": {
          "match_size": {
            "attributes": {
              "team_count": 1,
              "team_size": 30
            },
            "type": "player_count"
          },
          "beacons": {
            "attributes": {
              "difference": 80,
              "max_latency": 80
            },
            "type": "latencies"
          },
          "selected_region": {
            "type": "string_equality",
            "attributes": {
              "overlap": 1
            }
          },
          "selected_mode": {
            "type": "intersection",
            "attributes": {
              "overlap": 1
            }
          }
        },
        "expansions": {
          "10": {
            "beacons": {
              "difference": 100,
              "max_latency": 100
            },
            "match_size": {
              "team_count": 1,
              "team_size": 20
            }
          },
          "15": {
            "beacons": {
              "difference": 120,
              "max_latency": 120
            },
            "match_size": {
              "team_count": 1,
              "team_size": 10
            }
          },
          "25": {
            "match_size": {
              "team_count": 1,
              "team_size": 4
            }
          },
          "30": {
            "match_size": {
              "team_count": 1,
              "team_size": 1
            }
          }
        }
      }
    }
  }
}

(温馨提示:请务必修改应用程序的 name 和 version,以匹配您的 应用程序和版本!)

如果没有出现验证错误,请点击 Create and Start 并等待该过程完成。这将启动一个新的免费集群,并运行您的简单示例匹配器。

您现在可以继续下一步。

2. 浏览配置​

独特的多人社交游戏规则

团队数量为 1,团队规模为 50,每场游戏需要 50 名玩家(所有玩家都在同一队)。

专门针对社交游戏,您可以为游戏模式特定的规则和设置定义匹配配置文件:

  • 让玩家提供他们的游戏模式偏好,并选择适合所有人的模式,

  • 以组队方式加入用于预设大厅或在不超过团队规模的情况下补满队伍,

  • 添加 🗺️ 区域选择 UI 以将对手限制在指定区域,

  • 允许更高的延迟以优先实现与更多玩家更快的匹配,

  • 当允许更多玩家时,使用不同的 🏷️ 应用版本分配更多的 CPU 或内存。

放宽限制以确保快速匹配:

  • 快速放宽延迟限制以找到更多玩家,

  • 缓慢减小队伍规模以减少所需玩家数并尽早开始游戏,

    • 或者,您可以让服务器用 AI 玩家填补空缺位置,

  • 如果未找到队友,则单人启动游戏并使用回填在后续添加玩家,

    • 这将允许玩家加入现有对局而不是新对局,以最大化社交互动。

语义化版本控制

在我们发布 Matchmaker 更新时,每个新版本都采用 语义化版本控制,通过解释格式 major.minor.patch 来清晰传达更改的影响:

  • major 版本包含重大破坏性变更,需要重新审查集成,

  • minor 版本包含大量向后兼容的改进,

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

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

为确保意外的客户端崩溃或被放弃的票证不会一直滞留并占用您的匹配器资源,票证将在 ticket_expiration_period 后被取消,导致其状态更改为 CANCELLED,然后在 ticket_removal_period 后永久删除。

我们匹配逻辑的核心在 匹配配置文件中进行配置。每个配置文件都是一个完全隔离的匹配队列,指向具有预定义所需 CPU 和内存 (RAM) 资源量的 应用版本。

初始规则集中的匹配规则必须满足才能将玩家分组在一起,每条规则由三个属性定义:

  • 您选择的名称,例如 - match size,

  • 规则类型,也称为操作符,例如 - player_count,

  • 最后是操作符属性,例如 team_count 或 team_size。

玩家数量规则

这是一条特殊规则,定义了需要匹配多少名玩家才能发起分配:

  • team_count 指团队数量,1 个团队可用于合作或混战模式,

  • team_size 指每个团队的玩家人数。

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

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

延迟规则

使用此规则为所有玩家提供尽可能低的延迟(ping)。一旦客户端测量并提交针对所有可用信标的往返时间 (ping),Gen2 将仅考虑根据 Ping 信标测得的在特定 ping 值 difference 范围内的匹配。这提供了一种“柔性”解决方案来划分玩家群,支持与邻近区域进行匹配,特别是提高了人口较少区域的匹配速度。使用 max_latency 可防止与距离较远的玩家进行匹配。

您现在可以继续下一步。

我们上面最初带有 "difference": 50, "max_latency": 200 的示例 beacons 规则:

  • Alice 和 Bob 将会匹配,因为北京被丢弃(>200),其余部分在 | A-B | < 50 范围内:

    • Alice {蒙特利尔: 12.3, 纽瓦克: 45.6, 达拉斯: 59.9, 北京: 264.4};以及

    • Bob {蒙特利尔: 27.3, 纽瓦克: 32.4, 达拉斯: 23.1, 北京: 252.2}。

  • Charlie 和 Dave 将不会匹配,因为达拉斯信标的 | C-D | > 50:

    • Alice {蒙特利尔: 5.7, 纽瓦克: 44.2, 达拉斯: 59.5, 北京: 263.2};以及

    • Bob {蒙特利尔: 57.8, 纽瓦克: 32.0, 达拉斯: 24.2, 北京: 272.3}。

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

3. 检查实例详细信息​

新匹配器初始化完成后,在我们的仪表板中查看其详细信息:

Status 指示服务运行状况,可能为 ONLINE、OFFLINE 或 ERROR。

  • Identifier 可帮助 Edgegap 工作人员在您需要排障帮助时快速找到您的匹配器。

  • Started at 可用于追踪最新的更新时间。

  • Size 对应于我们的某个 定价层级。

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

  • Swagger URL 是我们提供的便捷 openAPI 规范 GUI,用于浏览 API 模式。

  • Auth Token 是游戏客户端和游戏服务器用于身份验证的唯一秘密令牌。

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

您现在可以继续下一步。

4. 测试票证 API

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

点击“Matchmaker”标题下方的 /...swagger.json URL 打开原始 JSON 模式:

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

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

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

  • 保持选择 Postman Collection,

  • 选择 View Import Settings 并将设置 Parameter generation 更改为 Example。

确认导入,这将在左侧的集合列表中显示一个标题为 Matchmaker 的新集合。

点击 View more actions,打开选项卡 Authorization 并选择:

  • Auth Type - API Key,

  • Key - “Authorization”

  • Value - 在此处插入您的 AuthToken 值,

  • Add to - Header。

按 (CTRL/CMD+S) 或点击保存图标以保存更改。Postman 选项卡中的橙色圆点应该会消失。

在您的 Matchmaker 集合中,选择 tickets 和 Create a matchmaking ticket,打开一个新选项卡。

选择选项卡 Body 以预览您的 玩家票证请求:

注意 player_ip 设置为 null——这将使用自动添加到您请求中的 IP 地址(替代方案请参见 服务器到服务器集成),

  • profile 指您的 匹配配置文件,

  • attributes 包括您的匹配器规则的值,在此示例中为 latencies 规则,

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

注意:请务必参考示例的 Swagger 导入配置。 

点击 Send 并查看对玩家票证请求的响应:

  • id 是您的唯一匹配票证 ID,请保存此 ID 以便稍后检查您的票证,

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

  • group_id 是发给每张票证的唯一组 ID,单人玩家表示为 1 人的组,

  • player_ip 是解析出的玩家公共 IP 地址,无论使用何种识别方法,

  • assignment 设置为 null,表示票证尚未匹配或分配给服务器,

  • created_at 提供有关玩家票证何时创建的信息,供游戏 UI 使用,

  • status 指示票证的当前状态,所有票证均以 SEARCHING 开始(详细信息请参阅 匹配流程)。

再次点击 Send 创建第二张票证,以便我们的两名玩家进行匹配并启动服务器。

在您的 Matchmaker 集合中,选择 {ticketId} 和 Read a matchmaking ticket。

输入上一步响应中的票证 ID,然后点击 Send。

查看玩家票证的更新分配情况:

  • 状态首先变为 MATCH_FOUND,同时保持 assignment 设置为 null,表示玩家已匹配且正在分配服务器,

再次点击 Send 检查您的票证,并查看玩家票证的更新分配情况:

  • 状态变为 HOST_ASSIGNED,并且 assignment 包含已分配服务器的详细信息。

 在我们的仪表板中检查您的新部署:

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

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

在您验证能够顺利连接到部署并完成测试后,停止您的部署以释放账户中的容量用于下一个构建版本。

您现在可以继续下一步。

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

Edgegap 的匹配集成了:

  • 与游戏客户端,用于管理玩家票证,

  • 与游戏服务器,用于:

    • 处理通过其票证传递的玩家偏好,

    • 可选择支持回填以在启动后添加或替换玩家。

对于游戏客户端,我们建议在整个匹配流程中通过游戏内 UI 向玩家提供票证状态更新,以获得最佳玩家体验。请参阅:

在游戏客户端中,确保您处理了不可重试的错误:

  • HTTP 404 Not Found - 票证已被删除,

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

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

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

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

  3. 读取 注入的环境变量 (Deployment) 以获取部署信息,例如 IP 地址、位置等。

玩家连接后,游戏服务器和游戏客户端启动加载场景以执行同步步骤(例如选择并加载地图/场景/关卡)。我们建议使用功能齐全的 3D 场景、类似大厅的社交 UI 或带有进度条的加载屏幕,以指示初始化正在进行中。

一旦游戏客户端完全加载,玩家就会加载/移动到主游戏场景。

可选地,游戏服务器可以创建和管理回填和玩家容量(添加或替换离开的玩家)。

在以下情况下,请确保使用 注入的 DELETE_URL 正确停止您的部署:

  • 没有玩家加入对局,

  • 所有玩家均已离开对局,

  • 对局正常结束。

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

如何将匹配集成到您的社交多人游戏中

-> 本文基于匹配文档。如果您遇到问题或出入,请务必参阅原始指南,因为其更新更为频繁。

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

将我们的匹配器实现到您的游戏共有五个步骤:

  1. 第一步是创建账户并使用我们的社交游戏示例。瞧,您(在技术上)已经完成一半了!您只需要将匹配器集成到您的游戏中(见第 5 步)。

  2. 现在,您绝不应该盲目遵循在网上找到的 JSON 示例,因此强烈建议根据您的回合制游戏调整上述规则。第 2 步(“浏览配置”)是我们的“使用说明”,详细介绍了每个匹配规则函数的功能(“浏览配置”)。

  3. 第 3 步(“检查实例详细信息”)涵盖您的个人专属匹配器,以确保其已部署并与您的游戏设计协同工作。

  4. 第 4 步正如其名(“4. 测试票证 API”),主要关于测试匹配器是否收到来自玩家的匹配请求,这些请求称为票证。

  5. 第 5 步(“在您的游戏中集成匹配”)重点介绍如何在引擎项目中集成匹配器。

如果您遇到故障排除难题,我们深入的学习中心提供了额外的排错技巧。

1. 设置免费层级

注册您的免费 Edgegap 账户,并导航至 Matchmaker 仪表板页面。

在页面中,先点击 Create Matchmaker,然后输入:

  • 您的匹配器名称——这纯粹供您自己参考,例如 quickstart-dev,

  • 然后,为您的社交多人游戏上传以下简单示例作为 JSON 配置:

{
  "version": "2.1.0",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "ticket_expiration_period": "5m",
  "ticket_removal_period": "1m",
  "profiles": {
    "social-example": {
      "application": {
        "name": "my-game-server==>CHANGE-THIS",
        "version": "2024.01.30-16.23.00-UTC==>CHANGE-THIS"
      },
      "rules": {
        "initial": {
          "match_size": {
            "attributes": {
              "team_count": 1,
              "team_size": 30
            },
            "type": "player_count"
          },
          "beacons": {
            "attributes": {
              "difference": 80,
              "max_latency": 80
            },
            "type": "latencies"
          },
          "selected_region": {
            "type": "string_equality",
            "attributes": {
              "overlap": 1
            }
          },
          "selected_mode": {
            "type": "intersection",
            "attributes": {
              "overlap": 1
            }
          }
        },
        "expansions": {
          "10": {
            "beacons": {
              "difference": 100,
              "max_latency": 100
            },
            "match_size": {
              "team_count": 1,
              "team_size": 20
            }
          },
          "15": {
            "beacons": {
              "difference": 120,
              "max_latency": 120
            },
            "match_size": {
              "team_count": 1,
              "team_size": 10
            }
          },
          "25": {
            "match_size": {
              "team_count": 1,
              "team_size": 4
            }
          },
          "30": {
            "match_size": {
              "team_count": 1,
              "team_size": 1
            }
          }
        }
      }
    }
  }
}

(温馨提示:请务必修改应用程序的 name 和 version,以匹配您的 应用程序和版本!)

如果没有出现验证错误,请点击 Create and Start 并等待该过程完成。这将启动一个新的免费集群,并运行您的简单示例匹配器。

您现在可以继续下一步。

2. 浏览配置​

独特的多人社交游戏规则

团队数量为 1,团队规模为 50,每场游戏需要 50 名玩家(所有玩家都在同一队)。

专门针对社交游戏,您可以为游戏模式特定的规则和设置定义匹配配置文件:

  • 让玩家提供他们的游戏模式偏好,并选择适合所有人的模式,

  • 以组队方式加入用于预设大厅或在不超过团队规模的情况下补满队伍,

  • 添加 🗺️ 区域选择 UI 以将对手限制在指定区域,

  • 允许更高的延迟以优先实现与更多玩家更快的匹配,

  • 当允许更多玩家时,使用不同的 🏷️ 应用版本分配更多的 CPU 或内存。

放宽限制以确保快速匹配:

  • 快速放宽延迟限制以找到更多玩家,

  • 缓慢减小队伍规模以减少所需玩家数并尽早开始游戏,

    • 或者,您可以让服务器用 AI 玩家填补空缺位置,

  • 如果未找到队友,则单人启动游戏并使用回填在后续添加玩家,

    • 这将允许玩家加入现有对局而不是新对局,以最大化社交互动。

语义化版本控制

在我们发布 Matchmaker 更新时,每个新版本都采用 语义化版本控制,通过解释格式 major.minor.patch 来清晰传达更改的影响:

  • major 版本包含重大破坏性变更,需要重新审查集成,

  • minor 版本包含大量向后兼容的改进,

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

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

为确保意外的客户端崩溃或被放弃的票证不会一直滞留并占用您的匹配器资源,票证将在 ticket_expiration_period 后被取消,导致其状态更改为 CANCELLED,然后在 ticket_removal_period 后永久删除。

我们匹配逻辑的核心在 匹配配置文件中进行配置。每个配置文件都是一个完全隔离的匹配队列,指向具有预定义所需 CPU 和内存 (RAM) 资源量的 应用版本。

初始规则集中的匹配规则必须满足才能将玩家分组在一起,每条规则由三个属性定义:

  • 您选择的名称,例如 - match size,

  • 规则类型,也称为操作符,例如 - player_count,

  • 最后是操作符属性,例如 team_count 或 team_size。

玩家数量规则

这是一条特殊规则,定义了需要匹配多少名玩家才能发起分配:

  • team_count 指团队数量,1 个团队可用于合作或混战模式,

  • team_size 指每个团队的玩家人数。

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

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

延迟规则

使用此规则为所有玩家提供尽可能低的延迟(ping)。一旦客户端测量并提交针对所有可用信标的往返时间 (ping),Gen2 将仅考虑根据 Ping 信标测得的在特定 ping 值 difference 范围内的匹配。这提供了一种“柔性”解决方案来划分玩家群,支持与邻近区域进行匹配,特别是提高了人口较少区域的匹配速度。使用 max_latency 可防止与距离较远的玩家进行匹配。

您现在可以继续下一步。

我们上面最初带有 "difference": 50, "max_latency": 200 的示例 beacons 规则:

  • Alice 和 Bob 将会匹配,因为北京被丢弃(>200),其余部分在 | A-B | < 50 范围内:

    • Alice {蒙特利尔: 12.3, 纽瓦克: 45.6, 达拉斯: 59.9, 北京: 264.4};以及

    • Bob {蒙特利尔: 27.3, 纽瓦克: 32.4, 达拉斯: 23.1, 北京: 252.2}。

  • Charlie 和 Dave 将不会匹配,因为达拉斯信标的 | C-D | > 50:

    • Alice {蒙特利尔: 5.7, 纽瓦克: 44.2, 达拉斯: 59.5, 北京: 263.2};以及

    • Bob {蒙特利尔: 57.8, 纽瓦克: 32.0, 达拉斯: 24.2, 北京: 272.3}。

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

3. 检查实例详细信息​

新匹配器初始化完成后,在我们的仪表板中查看其详细信息:

Status 指示服务运行状况,可能为 ONLINE、OFFLINE 或 ERROR。

  • Identifier 可帮助 Edgegap 工作人员在您需要排障帮助时快速找到您的匹配器。

  • Started at 可用于追踪最新的更新时间。

  • Size 对应于我们的某个 定价层级。

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

  • Swagger URL 是我们提供的便捷 openAPI 规范 GUI,用于浏览 API 模式。

  • Auth Token 是游戏客户端和游戏服务器用于身份验证的唯一秘密令牌。

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

您现在可以继续下一步。

4. 测试票证 API

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

点击“Matchmaker”标题下方的 /...swagger.json URL 打开原始 JSON 模式:

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

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

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

  • 保持选择 Postman Collection,

  • 选择 View Import Settings 并将设置 Parameter generation 更改为 Example。

确认导入,这将在左侧的集合列表中显示一个标题为 Matchmaker 的新集合。

点击 View more actions,打开选项卡 Authorization 并选择:

  • Auth Type - API Key,

  • Key - “Authorization”

  • Value - 在此处插入您的 AuthToken 值,

  • Add to - Header。

按 (CTRL/CMD+S) 或点击保存图标以保存更改。Postman 选项卡中的橙色圆点应该会消失。

在您的 Matchmaker 集合中,选择 tickets 和 Create a matchmaking ticket,打开一个新选项卡。

选择选项卡 Body 以预览您的 玩家票证请求:

注意 player_ip 设置为 null——这将使用自动添加到您请求中的 IP 地址(替代方案请参见 服务器到服务器集成),

  • profile 指您的 匹配配置文件,

  • attributes 包括您的匹配器规则的值,在此示例中为 latencies 规则,

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

注意:请务必参考示例的 Swagger 导入配置。 

点击 Send 并查看对玩家票证请求的响应:

  • id 是您的唯一匹配票证 ID,请保存此 ID 以便稍后检查您的票证,

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

  • group_id 是发给每张票证的唯一组 ID,单人玩家表示为 1 人的组,

  • player_ip 是解析出的玩家公共 IP 地址,无论使用何种识别方法,

  • assignment 设置为 null,表示票证尚未匹配或分配给服务器,

  • created_at 提供有关玩家票证何时创建的信息,供游戏 UI 使用,

  • status 指示票证的当前状态,所有票证均以 SEARCHING 开始(详细信息请参阅 匹配流程)。

再次点击 Send 创建第二张票证,以便我们的两名玩家进行匹配并启动服务器。

在您的 Matchmaker 集合中,选择 {ticketId} 和 Read a matchmaking ticket。

输入上一步响应中的票证 ID,然后点击 Send。

查看玩家票证的更新分配情况:

  • 状态首先变为 MATCH_FOUND,同时保持 assignment 设置为 null,表示玩家已匹配且正在分配服务器,

再次点击 Send 检查您的票证,并查看玩家票证的更新分配情况:

  • 状态变为 HOST_ASSIGNED,并且 assignment 包含已分配服务器的详细信息。

 在我们的仪表板中检查您的新部署:

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

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

在您验证能够顺利连接到部署并完成测试后,停止您的部署以释放账户中的容量用于下一个构建版本。

您现在可以继续下一步。

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

Edgegap 的匹配集成了:

  • 与游戏客户端,用于管理玩家票证,

  • 与游戏服务器,用于:

    • 处理通过其票证传递的玩家偏好,

    • 可选择支持回填以在启动后添加或替换玩家。

对于游戏客户端,我们建议在整个匹配流程中通过游戏内 UI 向玩家提供票证状态更新,以获得最佳玩家体验。请参阅:

在游戏客户端中,确保您处理了不可重试的错误:

  • HTTP 404 Not Found - 票证已被删除,

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

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

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

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

  3. 读取 注入的环境变量 (Deployment) 以获取部署信息,例如 IP 地址、位置等。

玩家连接后,游戏服务器和游戏客户端启动加载场景以执行同步步骤(例如选择并加载地图/场景/关卡)。我们建议使用功能齐全的 3D 场景、类似大厅的社交 UI 或带有进度条的加载屏幕,以指示初始化正在进行中。

一旦游戏客户端完全加载,玩家就会加载/移动到主游戏场景。

可选地,游戏服务器可以创建和管理回填和玩家容量(添加或替换离开的玩家)。

在以下情况下,请确保使用 注入的 DELETE_URL 正确停止您的部署:

  • 没有玩家加入对局,

  • 所有玩家均已离开对局,

  • 对局正常结束。

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

如何将匹配集成到您的社交多人游戏中

-> 本文基于匹配文档。如果您遇到问题或出入,请务必参阅原始指南,因为其更新更为频繁。

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

将我们的匹配器实现到您的游戏共有五个步骤:

  1. 第一步是创建账户并使用我们的社交游戏示例。瞧,您(在技术上)已经完成一半了!您只需要将匹配器集成到您的游戏中(见第 5 步)。

  2. 现在,您绝不应该盲目遵循在网上找到的 JSON 示例,因此强烈建议根据您的回合制游戏调整上述规则。第 2 步(“浏览配置”)是我们的“使用说明”,详细介绍了每个匹配规则函数的功能(“浏览配置”)。

  3. 第 3 步(“检查实例详细信息”)涵盖您的个人专属匹配器,以确保其已部署并与您的游戏设计协同工作。

  4. 第 4 步正如其名(“4. 测试票证 API”),主要关于测试匹配器是否收到来自玩家的匹配请求,这些请求称为票证。

  5. 第 5 步(“在您的游戏中集成匹配”)重点介绍如何在引擎项目中集成匹配器。

如果您遇到故障排除难题,我们深入的学习中心提供了额外的排错技巧。

1. 设置免费层级

注册您的免费 Edgegap 账户,并导航至 Matchmaker 仪表板页面。

在页面中,先点击 Create Matchmaker,然后输入:

  • 您的匹配器名称——这纯粹供您自己参考,例如 quickstart-dev,

  • 然后,为您的社交多人游戏上传以下简单示例作为 JSON 配置:

{
  "version": "2.1.0",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "ticket_expiration_period": "5m",
  "ticket_removal_period": "1m",
  "profiles": {
    "social-example": {
      "application": {
        "name": "my-game-server==>CHANGE-THIS",
        "version": "2024.01.30-16.23.00-UTC==>CHANGE-THIS"
      },
      "rules": {
        "initial": {
          "match_size": {
            "attributes": {
              "team_count": 1,
              "team_size": 30
            },
            "type": "player_count"
          },
          "beacons": {
            "attributes": {
              "difference": 80,
              "max_latency": 80
            },
            "type": "latencies"
          },
          "selected_region": {
            "type": "string_equality",
            "attributes": {
              "overlap": 1
            }
          },
          "selected_mode": {
            "type": "intersection",
            "attributes": {
              "overlap": 1
            }
          }
        },
        "expansions": {
          "10": {
            "beacons": {
              "difference": 100,
              "max_latency": 100
            },
            "match_size": {
              "team_count": 1,
              "team_size": 20
            }
          },
          "15": {
            "beacons": {
              "difference": 120,
              "max_latency": 120
            },
            "match_size": {
              "team_count": 1,
              "team_size": 10
            }
          },
          "25": {
            "match_size": {
              "team_count": 1,
              "team_size": 4
            }
          },
          "30": {
            "match_size": {
              "team_count": 1,
              "team_size": 1
            }
          }
        }
      }
    }
  }
}

(温馨提示:请务必修改应用程序的 name 和 version,以匹配您的 应用程序和版本!)

如果没有出现验证错误,请点击 Create and Start 并等待该过程完成。这将启动一个新的免费集群,并运行您的简单示例匹配器。

您现在可以继续下一步。

2. 浏览配置​

独特的多人社交游戏规则

团队数量为 1,团队规模为 50,每场游戏需要 50 名玩家(所有玩家都在同一队)。

专门针对社交游戏,您可以为游戏模式特定的规则和设置定义匹配配置文件:

  • 让玩家提供他们的游戏模式偏好,并选择适合所有人的模式,

  • 以组队方式加入用于预设大厅或在不超过团队规模的情况下补满队伍,

  • 添加 🗺️ 区域选择 UI 以将对手限制在指定区域,

  • 允许更高的延迟以优先实现与更多玩家更快的匹配,

  • 当允许更多玩家时,使用不同的 🏷️ 应用版本分配更多的 CPU 或内存。

放宽限制以确保快速匹配:

  • 快速放宽延迟限制以找到更多玩家,

  • 缓慢减小队伍规模以减少所需玩家数并尽早开始游戏,

    • 或者,您可以让服务器用 AI 玩家填补空缺位置,

  • 如果未找到队友,则单人启动游戏并使用回填在后续添加玩家,

    • 这将允许玩家加入现有对局而不是新对局,以最大化社交互动。

语义化版本控制

在我们发布 Matchmaker 更新时,每个新版本都采用 语义化版本控制,通过解释格式 major.minor.patch 来清晰传达更改的影响:

  • major 版本包含重大破坏性变更,需要重新审查集成,

  • minor 版本包含大量向后兼容的改进,

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

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

为确保意外的客户端崩溃或被放弃的票证不会一直滞留并占用您的匹配器资源,票证将在 ticket_expiration_period 后被取消,导致其状态更改为 CANCELLED,然后在 ticket_removal_period 后永久删除。

我们匹配逻辑的核心在 匹配配置文件中进行配置。每个配置文件都是一个完全隔离的匹配队列,指向具有预定义所需 CPU 和内存 (RAM) 资源量的 应用版本。

初始规则集中的匹配规则必须满足才能将玩家分组在一起,每条规则由三个属性定义:

  • 您选择的名称,例如 - match size,

  • 规则类型,也称为操作符,例如 - player_count,

  • 最后是操作符属性,例如 team_count 或 team_size。

玩家数量规则

这是一条特殊规则,定义了需要匹配多少名玩家才能发起分配:

  • team_count 指团队数量,1 个团队可用于合作或混战模式,

  • team_size 指每个团队的玩家人数。

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

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

延迟规则

使用此规则为所有玩家提供尽可能低的延迟(ping)。一旦客户端测量并提交针对所有可用信标的往返时间 (ping),Gen2 将仅考虑根据 Ping 信标测得的在特定 ping 值 difference 范围内的匹配。这提供了一种“柔性”解决方案来划分玩家群,支持与邻近区域进行匹配,特别是提高了人口较少区域的匹配速度。使用 max_latency 可防止与距离较远的玩家进行匹配。

您现在可以继续下一步。

我们上面最初带有 "difference": 50, "max_latency": 200 的示例 beacons 规则:

  • Alice 和 Bob 将会匹配,因为北京被丢弃(>200),其余部分在 | A-B | < 50 范围内:

    • Alice {蒙特利尔: 12.3, 纽瓦克: 45.6, 达拉斯: 59.9, 北京: 264.4};以及

    • Bob {蒙特利尔: 27.3, 纽瓦克: 32.4, 达拉斯: 23.1, 北京: 252.2}。

  • Charlie 和 Dave 将不会匹配,因为达拉斯信标的 | C-D | > 50:

    • Alice {蒙特利尔: 5.7, 纽瓦克: 44.2, 达拉斯: 59.5, 北京: 263.2};以及

    • Bob {蒙特利尔: 57.8, 纽瓦克: 32.0, 达拉斯: 24.2, 北京: 272.3}。

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

3. 检查实例详细信息​

新匹配器初始化完成后,在我们的仪表板中查看其详细信息:

Status 指示服务运行状况,可能为 ONLINE、OFFLINE 或 ERROR。

  • Identifier 可帮助 Edgegap 工作人员在您需要排障帮助时快速找到您的匹配器。

  • Started at 可用于追踪最新的更新时间。

  • Size 对应于我们的某个 定价层级。

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

  • Swagger URL 是我们提供的便捷 openAPI 规范 GUI,用于浏览 API 模式。

  • Auth Token 是游戏客户端和游戏服务器用于身份验证的唯一秘密令牌。

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

您现在可以继续下一步。

4. 测试票证 API

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

点击“Matchmaker”标题下方的 /...swagger.json URL 打开原始 JSON 模式:

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

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

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

  • 保持选择 Postman Collection,

  • 选择 View Import Settings 并将设置 Parameter generation 更改为 Example。

确认导入,这将在左侧的集合列表中显示一个标题为 Matchmaker 的新集合。

点击 View more actions,打开选项卡 Authorization 并选择:

  • Auth Type - API Key,

  • Key - “Authorization”

  • Value - 在此处插入您的 AuthToken 值,

  • Add to - Header。

按 (CTRL/CMD+S) 或点击保存图标以保存更改。Postman 选项卡中的橙色圆点应该会消失。

在您的 Matchmaker 集合中,选择 tickets 和 Create a matchmaking ticket,打开一个新选项卡。

选择选项卡 Body 以预览您的 玩家票证请求:

注意 player_ip 设置为 null——这将使用自动添加到您请求中的 IP 地址(替代方案请参见 服务器到服务器集成),

  • profile 指您的 匹配配置文件,

  • attributes 包括您的匹配器规则的值,在此示例中为 latencies 规则,

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

注意:请务必参考示例的 Swagger 导入配置。 

点击 Send 并查看对玩家票证请求的响应:

  • id 是您的唯一匹配票证 ID,请保存此 ID 以便稍后检查您的票证,

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

  • group_id 是发给每张票证的唯一组 ID,单人玩家表示为 1 人的组,

  • player_ip 是解析出的玩家公共 IP 地址,无论使用何种识别方法,

  • assignment 设置为 null,表示票证尚未匹配或分配给服务器,

  • created_at 提供有关玩家票证何时创建的信息,供游戏 UI 使用,

  • status 指示票证的当前状态,所有票证均以 SEARCHING 开始(详细信息请参阅 匹配流程)。

再次点击 Send 创建第二张票证,以便我们的两名玩家进行匹配并启动服务器。

在您的 Matchmaker 集合中,选择 {ticketId} 和 Read a matchmaking ticket。

输入上一步响应中的票证 ID,然后点击 Send。

查看玩家票证的更新分配情况:

  • 状态首先变为 MATCH_FOUND,同时保持 assignment 设置为 null,表示玩家已匹配且正在分配服务器,

再次点击 Send 检查您的票证,并查看玩家票证的更新分配情况:

  • 状态变为 HOST_ASSIGNED,并且 assignment 包含已分配服务器的详细信息。

 在我们的仪表板中检查您的新部署:

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

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

在您验证能够顺利连接到部署并完成测试后,停止您的部署以释放账户中的容量用于下一个构建版本。

您现在可以继续下一步。

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

Edgegap 的匹配集成了:

  • 与游戏客户端,用于管理玩家票证,

  • 与游戏服务器,用于:

    • 处理通过其票证传递的玩家偏好,

    • 可选择支持回填以在启动后添加或替换玩家。

对于游戏客户端,我们建议在整个匹配流程中通过游戏内 UI 向玩家提供票证状态更新,以获得最佳玩家体验。请参阅:

在游戏客户端中,确保您处理了不可重试的错误:

  • HTTP 404 Not Found - 票证已被删除,

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

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

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

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

  3. 读取 注入的环境变量 (Deployment) 以获取部署信息,例如 IP 地址、位置等。

玩家连接后,游戏服务器和游戏客户端启动加载场景以执行同步步骤(例如选择并加载地图/场景/关卡)。我们建议使用功能齐全的 3D 场景、类似大厅的社交 UI 或带有进度条的加载屏幕,以指示初始化正在进行中。

一旦游戏客户端完全加载,玩家就会加载/移动到主游戏场景。

可选地,游戏服务器可以创建和管理回填和玩家容量(添加或替换离开的玩家)。

在以下情况下,请确保使用 注入的 DELETE_URL 正确停止您的部署:

  • 没有玩家加入对局,

  • 所有玩家均已离开对局,

  • 对局正常结束。

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

如何将匹配集成到您的社交多人游戏中

-> 本文基于匹配文档。如果您遇到问题或出入,请务必参阅原始指南,因为其更新更为频繁。

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

将我们的匹配器实现到您的游戏共有五个步骤:

  1. 第一步是创建账户并使用我们的社交游戏示例。瞧,您(在技术上)已经完成一半了!您只需要将匹配器集成到您的游戏中(见第 5 步)。

  2. 现在,您绝不应该盲目遵循在网上找到的 JSON 示例,因此强烈建议根据您的回合制游戏调整上述规则。第 2 步(“浏览配置”)是我们的“使用说明”,详细介绍了每个匹配规则函数的功能(“浏览配置”)。

  3. 第 3 步(“检查实例详细信息”)涵盖您的个人专属匹配器,以确保其已部署并与您的游戏设计协同工作。

  4. 第 4 步正如其名(“4. 测试票证 API”),主要关于测试匹配器是否收到来自玩家的匹配请求,这些请求称为票证。

  5. 第 5 步(“在您的游戏中集成匹配”)重点介绍如何在引擎项目中集成匹配器。

如果您遇到故障排除难题,我们深入的学习中心提供了额外的排错技巧。

1. 设置免费层级

注册您的免费 Edgegap 账户,并导航至 Matchmaker 仪表板页面。

在页面中,先点击 Create Matchmaker,然后输入:

  • 您的匹配器名称——这纯粹供您自己参考,例如 quickstart-dev,

  • 然后,为您的社交多人游戏上传以下简单示例作为 JSON 配置:

{
  "version": "2.1.0",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "ticket_expiration_period": "5m",
  "ticket_removal_period": "1m",
  "profiles": {
    "social-example": {
      "application": {
        "name": "my-game-server==>CHANGE-THIS",
        "version": "2024.01.30-16.23.00-UTC==>CHANGE-THIS"
      },
      "rules": {
        "initial": {
          "match_size": {
            "attributes": {
              "team_count": 1,
              "team_size": 30
            },
            "type": "player_count"
          },
          "beacons": {
            "attributes": {
              "difference": 80,
              "max_latency": 80
            },
            "type": "latencies"
          },
          "selected_region": {
            "type": "string_equality",
            "attributes": {
              "overlap": 1
            }
          },
          "selected_mode": {
            "type": "intersection",
            "attributes": {
              "overlap": 1
            }
          }
        },
        "expansions": {
          "10": {
            "beacons": {
              "difference": 100,
              "max_latency": 100
            },
            "match_size": {
              "team_count": 1,
              "team_size": 20
            }
          },
          "15": {
            "beacons": {
              "difference": 120,
              "max_latency": 120
            },
            "match_size": {
              "team_count": 1,
              "team_size": 10
            }
          },
          "25": {
            "match_size": {
              "team_count": 1,
              "team_size": 4
            }
          },
          "30": {
            "match_size": {
              "team_count": 1,
              "team_size": 1
            }
          }
        }
      }
    }
  }
}

(温馨提示:请务必修改应用程序的 name 和 version,以匹配您的 应用程序和版本!)

如果没有出现验证错误,请点击 Create and Start 并等待该过程完成。这将启动一个新的免费集群,并运行您的简单示例匹配器。

您现在可以继续下一步。

2. 浏览配置​

独特的多人社交游戏规则

团队数量为 1,团队规模为 50,每场游戏需要 50 名玩家(所有玩家都在同一队)。

专门针对社交游戏,您可以为游戏模式特定的规则和设置定义匹配配置文件:

  • 让玩家提供他们的游戏模式偏好,并选择适合所有人的模式,

  • 以组队方式加入用于预设大厅或在不超过团队规模的情况下补满队伍,

  • 添加 🗺️ 区域选择 UI 以将对手限制在指定区域,

  • 允许更高的延迟以优先实现与更多玩家更快的匹配,

  • 当允许更多玩家时,使用不同的 🏷️ 应用版本分配更多的 CPU 或内存。

放宽限制以确保快速匹配:

  • 快速放宽延迟限制以找到更多玩家,

  • 缓慢减小队伍规模以减少所需玩家数并尽早开始游戏,

    • 或者,您可以让服务器用 AI 玩家填补空缺位置,

  • 如果未找到队友,则单人启动游戏并使用回填在后续添加玩家,

    • 这将允许玩家加入现有对局而不是新对局,以最大化社交互动。

语义化版本控制

在我们发布 Matchmaker 更新时,每个新版本都采用 语义化版本控制,通过解释格式 major.minor.patch 来清晰传达更改的影响:

  • major 版本包含重大破坏性变更,需要重新审查集成,

  • minor 版本包含大量向后兼容的改进,

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

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

为确保意外的客户端崩溃或被放弃的票证不会一直滞留并占用您的匹配器资源,票证将在 ticket_expiration_period 后被取消,导致其状态更改为 CANCELLED,然后在 ticket_removal_period 后永久删除。

我们匹配逻辑的核心在 匹配配置文件中进行配置。每个配置文件都是一个完全隔离的匹配队列,指向具有预定义所需 CPU 和内存 (RAM) 资源量的 应用版本。

初始规则集中的匹配规则必须满足才能将玩家分组在一起,每条规则由三个属性定义:

  • 您选择的名称,例如 - match size,

  • 规则类型,也称为操作符,例如 - player_count,

  • 最后是操作符属性,例如 team_count 或 team_size。

玩家数量规则

这是一条特殊规则,定义了需要匹配多少名玩家才能发起分配:

  • team_count 指团队数量,1 个团队可用于合作或混战模式,

  • team_size 指每个团队的玩家人数。

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

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

延迟规则

使用此规则为所有玩家提供尽可能低的延迟(ping)。一旦客户端测量并提交针对所有可用信标的往返时间 (ping),Gen2 将仅考虑根据 Ping 信标测得的在特定 ping 值 difference 范围内的匹配。这提供了一种“柔性”解决方案来划分玩家群,支持与邻近区域进行匹配,特别是提高了人口较少区域的匹配速度。使用 max_latency 可防止与距离较远的玩家进行匹配。

您现在可以继续下一步。

我们上面最初带有 "difference": 50, "max_latency": 200 的示例 beacons 规则:

  • Alice 和 Bob 将会匹配,因为北京被丢弃(>200),其余部分在 | A-B | < 50 范围内:

    • Alice {蒙特利尔: 12.3, 纽瓦克: 45.6, 达拉斯: 59.9, 北京: 264.4};以及

    • Bob {蒙特利尔: 27.3, 纽瓦克: 32.4, 达拉斯: 23.1, 北京: 252.2}。

  • Charlie 和 Dave 将不会匹配,因为达拉斯信标的 | C-D | > 50:

    • Alice {蒙特利尔: 5.7, 纽瓦克: 44.2, 达拉斯: 59.5, 北京: 263.2};以及

    • Bob {蒙特利尔: 57.8, 纽瓦克: 32.0, 达拉斯: 24.2, 北京: 272.3}。

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

3. 检查实例详细信息​

新匹配器初始化完成后,在我们的仪表板中查看其详细信息:

Status 指示服务运行状况,可能为 ONLINE、OFFLINE 或 ERROR。

  • Identifier 可帮助 Edgegap 工作人员在您需要排障帮助时快速找到您的匹配器。

  • Started at 可用于追踪最新的更新时间。

  • Size 对应于我们的某个 定价层级。

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

  • Swagger URL 是我们提供的便捷 openAPI 规范 GUI,用于浏览 API 模式。

  • Auth Token 是游戏客户端和游戏服务器用于身份验证的唯一秘密令牌。

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

您现在可以继续下一步。

4. 测试票证 API

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

点击“Matchmaker”标题下方的 /...swagger.json URL 打开原始 JSON 模式:

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

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

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

  • 保持选择 Postman Collection,

  • 选择 View Import Settings 并将设置 Parameter generation 更改为 Example。

确认导入,这将在左侧的集合列表中显示一个标题为 Matchmaker 的新集合。

点击 View more actions,打开选项卡 Authorization 并选择:

  • Auth Type - API Key,

  • Key - “Authorization”

  • Value - 在此处插入您的 AuthToken 值,

  • Add to - Header。

按 (CTRL/CMD+S) 或点击保存图标以保存更改。Postman 选项卡中的橙色圆点应该会消失。

在您的 Matchmaker 集合中,选择 tickets 和 Create a matchmaking ticket,打开一个新选项卡。

选择选项卡 Body 以预览您的 玩家票证请求:

注意 player_ip 设置为 null——这将使用自动添加到您请求中的 IP 地址(替代方案请参见 服务器到服务器集成),

  • profile 指您的 匹配配置文件,

  • attributes 包括您的匹配器规则的值,在此示例中为 latencies 规则,

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

注意:请务必参考示例的 Swagger 导入配置。 

点击 Send 并查看对玩家票证请求的响应:

  • id 是您的唯一匹配票证 ID,请保存此 ID 以便稍后检查您的票证,

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

  • group_id 是发给每张票证的唯一组 ID,单人玩家表示为 1 人的组,

  • player_ip 是解析出的玩家公共 IP 地址,无论使用何种识别方法,

  • assignment 设置为 null,表示票证尚未匹配或分配给服务器,

  • created_at 提供有关玩家票证何时创建的信息,供游戏 UI 使用,

  • status 指示票证的当前状态,所有票证均以 SEARCHING 开始(详细信息请参阅 匹配流程)。

再次点击 Send 创建第二张票证,以便我们的两名玩家进行匹配并启动服务器。

在您的 Matchmaker 集合中,选择 {ticketId} 和 Read a matchmaking ticket。

输入上一步响应中的票证 ID,然后点击 Send。

查看玩家票证的更新分配情况:

  • 状态首先变为 MATCH_FOUND,同时保持 assignment 设置为 null,表示玩家已匹配且正在分配服务器,

再次点击 Send 检查您的票证,并查看玩家票证的更新分配情况:

  • 状态变为 HOST_ASSIGNED,并且 assignment 包含已分配服务器的详细信息。

 在我们的仪表板中检查您的新部署:

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

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

在您验证能够顺利连接到部署并完成测试后,停止您的部署以释放账户中的容量用于下一个构建版本。

您现在可以继续下一步。

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

Edgegap 的匹配集成了:

  • 与游戏客户端,用于管理玩家票证,

  • 与游戏服务器,用于:

    • 处理通过其票证传递的玩家偏好,

    • 可选择支持回填以在启动后添加或替换玩家。

对于游戏客户端,我们建议在整个匹配流程中通过游戏内 UI 向玩家提供票证状态更新,以获得最佳玩家体验。请参阅:

在游戏客户端中,确保您处理了不可重试的错误:

  • HTTP 404 Not Found - 票证已被删除,

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

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

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

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

  3. 读取 注入的环境变量 (Deployment) 以获取部署信息,例如 IP 地址、位置等。

玩家连接后,游戏服务器和游戏客户端启动加载场景以执行同步步骤(例如选择并加载地图/场景/关卡)。我们建议使用功能齐全的 3D 场景、类似大厅的社交 UI 或带有进度条的加载屏幕,以指示初始化正在进行中。

一旦游戏客户端完全加载,玩家就会加载/移动到主游戏场景。

可选地,游戏服务器可以创建和管理回填和玩家容量(添加或替换离开的玩家)。

在以下情况下,请确保使用 注入的 DELETE_URL 正确停止您的部署:

  • 没有玩家加入对局,

  • 所有玩家均已离开对局,

  • 对局正常结束。

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

书写者

Edgegap团队

Get your Game Online Easily & in Minutes

立即开始集成!

轻松在线游戏
且在几分钟内