免责声明：我们已经通过免费且简易的 SDK 更新了我们的 Unity 集成。请确保按照我们的专属 Unity 對局配對 SDK集成指南进行操作。

我们将涵盖设置 Edgegap 免代码對局配對的每一个步骤，该功能同时支持 Unity 引擎和 Unreal 引擎。Edgegap 的對局配對能够以简便的方式即时配对玩家并启动游戏。Edgegap 的对局配对器是完全托管的，可进行无限自定义，以在全球范围内以最佳方式对玩家进行分组。
让我们开始吧！

第 1 部分 - 设置

首先，注册 Edgegap 平台的免费账户，并为您的游戏创建一个服务器应用程序。

如果您还没有看过，我们为 Unreal 和 Unity 提供了视频教程，同时还支持 Mirror 和 Unity 的 Game Objects 网卡（Netcode for Game Objects）等主流网络代码。我们还提供了示例来帮助您入门，以及详细的文档。

将应用程序版本上传到平台后，前往“Matchmaker”（对局配对器）页面。

第 2 部分 - 创建对局配对器

点击“Create a Matchmaker”（创建对局配对器）并输入一个名称。

选择适合您游戏类型的示例，例如针对第一人称射击游戏的“Competitive”（竞技）。在今天的视频中，我们将使用简单示例。

您的最新应用程序版本及其详细信息已预先填好。

然后，点击“Create & Start”（创建并启动），这会将对局配对器推送到我们的免费集群并使其可供访问。忽略缓存警告，因为这主要是针对有实时流量的游戏。

就是这样，对局配对器正在我们的平台上启动。

在等待该过程完成时，让我们探索一下配置。

每个新版本都使用语义化版本控制。由于某些部署可能会导致错误，因此“max deployment retry count”（最大部署重试次数）配置通过将您的部署重试至该最大次数来解决此问题。

“Ticker expiration period”（票据过期时间）和“removal period”（移除时间）可确保意外的客户端崩溃或放弃對局配對的客户端不会影响您的票据队列。

“Profiles”（配置文件）是定义您的多人游戏對局配對规则的地方。换句话说，它是将玩家配对在一起的逻辑。

每当玩家在游戏中选择對局配對时，他们都会创建一个票据，并根据这些特定规则将他们分配到这些队列中的一个。

如果两个或更多票据匹配，或者换句话说，如果两个或更多玩家在同一个队列中，对局配对器就会释放他们，并允许他们一起玩。他们会被部署到在“application”（应用程序）部分下设置的应用程序版本。 

接下来的部分是“rules”（规则）。

例如，您可能允许玩家选择特定的地图，如果您有足够的玩家，对局配对器会发送部署游戏服务器的请求，从而允许玩家加入并一起玩。

每条规则有三个字段需要输入：

• 第一，您选择的名称，例如“match size”（对局大小），

• 第二，规则类型，也被称为操作符，例如“player count”（玩家数量），

• 第三是操作符的属性，例如“target”（目标）。在这里，我们希望该对局中有 2 名玩家。

每个配置文件都是一个变量，可以包含不同的属性来对玩家进行分组，例如技能水平、位置或游戏模式。这意味着每个配置文件都会在您的游戏中产生一个完全独立的队列。

在这个例子中，我们还使用了一个基于延迟的规则。这是 Edgegap 对局配对器的一个独特功能，旨在确保对局中所有玩家的 Ping 值尽可能低。

我们的对局配对器现在准备好了！让我们看一看，然后通过发布票据来进行测试。

第 3 部分 - 对局配对器详情（配置和规则）

初始化对局配对器后，您可以查看该实例的详细信息。

“Status”（状态）表示服务的健康状况。

“Identifier”（标识符）突出显示了对局配对器的唯一标识符，这有助于 Edgegap 在您需要支持时快速排除故障。

“API URL”用于游戏客户端向游戏服务器进行部署的所有请求。

“Swagger URL”是一个方便的、用于开放 API 规范的图形化 Web 界面，您可以在其中导出、检查和测试 API 模式。

 “Authentication Token”（身份验证令牌）是游戏客户端和游戏服务器发出的所有身份验证请求所必需的。

值得注意的是，您可以重新生成身份验证令牌。特别推荐在您怀疑存在安全漏洞的情况下这样做。

第 4 部分 - 对局配对器测试

现在，要测试您的 API，我们将首先复制“Auth Token”（身份验证令牌），然后通过点击“link out”（外部链接）图标跳转到 swagger URL。

加载 Swagger 平台后，选择“Authorize”（授权）并将之前的“Auth Token”（身份验证令牌）粘贴到值字段中。然后点击“Authorize”（授权）并关闭菜单。

为了确认这是否起作用，向下滚动到“Ticket” API 部分，然后选择“Create a Matchmaking Ticket”（创建對局配對票据）字段。点击“Try it out”（试一下）。

首先，查看示例。请注意，这里的“Player IP”（玩家 IP）被设置为 null，这意味着它将使用您本机的 IP。还要注意，正在使用的配置文件是之前创建的“simple example”（简单示例）。延迟优化规则被自动分配了虚拟值。

为了模拟玩家票据请求對局配對，点击“execute”（执行）。这将创建一个票据，使我们能够评估响应。

向下滚动到“Response Body”（响应主体），这能让我们看到票据的 ID。请务必复制此字符串，以便在几秒钟内查看该票据。

此外，您可以注意到分配是“null”，因为票据刚刚发布，根据我们在部署游戏服务器之前设置的规则，它还缺少第二个玩家。

因此，我们向上滚动，通过点击“execute”（执行）来创建第二个票据。这模拟了对局配对器与之分组的第二个玩家。

完成后，我们将滚动回顶部并打开获取票据以查看我们的测试。粘贴原始票据 ID 并选择“execute”（执行）。

返回到响应主体，我们看到状态现在已更改为“Match Found”（已找到对局），这意味着这两个票据被判定为匹配。

刷新后，状态将更改为“Host Assigned”（已分配主机），这意味着服务器是自动部署的。

在“assignment”（分配）下，我们看到已经分配了一个主机，它还列出了一个可用的 URL，并突出了服务器的公网 IP，以及游戏客户端使用的外部和内部端口。 

返回 Edgegap 平台，我们可以看到部署的详细信息标有票据 ID。我们可以很方便地看到相同的 URL 和端口映射。我们还可以通过绿色勾选图标看到服务器已准备就绪。

在浏览器中打开服务器，您会看到您已连接到玩家。恭喜，您的对局配对器现在可以正常运行了。

对局配对器后续步骤

简单示例可能已经足够满足您的需求。

对于拥有多种游戏模式的游戏，或者想要探索规则扩展以优化其对局配对器从而缩短队列时间的游戏开发者，我们建议您研究我们的文档。

请务必订阅我们的频道，因为我们会添加新的教程视频。

您也可以加入我们在 Discord 上的社区，向我们的开发团队和其他工作室询问关于如何最佳优化您的对局配对器的建议。