> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong/matchmaker-in-depth.md).

# 深入了解

深入了解 Edgegap 的无代码匹配器概念，并按需自定义。

{% hint style="info" %}
如果你需要帮助， [请通过 Discord 联系我们](https://discord.gg/MmJf8fWjnt)。关于实时游戏支持，请查看我们的 [工单系统](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

## ✔️ 介绍

基于对战的游戏中的匹配系统通常旨在：

* **找到其他玩家** 基于诸如区域、延迟、技术水平或游戏参数等条件；
* **搜索服务器** 根据可用容量\[或延迟、区域、技术水平、地图、模式]加入；
* **启动新服务器** 如果现有服务器已满或不满足玩家条件。

玩家体验至上，定义我们的核心目标：

* 高对局填充率和社交功能整合（与好友组队游戏），
* 快速匹配且控制匹配质量（低延迟、共享偏好），
* 可靠且可预测的匹配流程并具有全球可用性。

{% hint style="success" %}
或者，让玩家 **从列表中选择一个持久的（始终在线）服务器** 带有 [服务器浏览器](https://docs.edgegap.com/zh/learn/fu-wu-qi-liu-lan-qi.md).
{% endhint %}

**5 分钟内即可开始，并免费测试所有功能，无需信用卡。**

在您准备好升级到更强大、私有（专用）集群时进行升级。与 Edgegap 原生集成 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md) 无论玩家身在何处，都能提供一流的 ping。

{% hint style="info" %}
免费层在每次重启后可运行 3 小时。您的匹配器将在共享基础设施上运行，资源有限，适合测试。 **在公开发布后，匹配器需要 24/7 运行。**
{% endhint %}

每个 Matchmaker 都有三个核心概念：

* [#hosting-cluster](#hosting-cluster "mention") - 底层服务器基础设施，由 Edgegap 全面管理和运营。
* [#configuration](#configuration "mention") - 定义匹配器如何运行的一组规则和设置。
* 🌐 服务实例 **-** 在集群上 24/7 运行的实时匹配服务，使用配置将玩家匹配在一起并生成部署（服务器）分配。

{% hint style="success" %}
[频繁更新您的匹配器版本](#changelog) 以 **利用新功能和错误修复。**
{% endhint %}

## ▶️ 开始匹配

**快速入门 - 将我们的 SDK 添加到您的游戏中**:

* 虚幻引擎 [开发者工具](https://docs.edgegap.com/zh/unreal-engine/developer-tools.md#integration-kit):
  * [阅读文档](https://egik.betide.studio/) 由 Betide Studios 制作，
  * [从 Fab Marketplace 安装](https://www.fab.com/listings/ff17ad88-12a1-49cf-9a41-31695ed11e16) （个人用途免费使用）。
* Unity [开发者工具](https://docs.edgegap.com/zh/unity/developer-tools.md#software-development-kit):
  * [免费使用 Unity Package Manager 安装软件包](https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser),
  * [浏览我们的入门指南和完整示例](https://docs.edgegap.com/zh/unity/matchmaking.md).

了解匹配流程，以便自定义、排查和优化您的游戏集成：

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fm4U4bgwucX6iGEieMISU%2Fimage.png?alt=media&amp;token=39b97619-700b-4062-9dd9-73fa08fb96c2" alt=""><figcaption><p>匹配序列</p></figcaption></figure>

1. [验证玩家](#authenticate) - 防止盗版拷贝进行联机，
2. [创建大厅](#create-group) - 与好友组队并共享玩家/匹配偏好，
3. [**组队**](#group-up) **- 将您的大厅注册为一个匹配组，**
4. [**查找匹配**](#find-match) **- 准备就绪并开始寻找匹配（新的或已有的），**
   1. 分配服务器并注入票据 - 服务器会在几秒后自动分配，
5. [**连接并验证**](#connect-to-server) **- 尝试与游戏服务器建立安全连接，**
   1. 确认身份 - 服务器使用第三方令牌验证游戏客户端身份，
   2. 接受玩家或踢出玩家 - 服务器决定是否允许该玩家加入。

### 验证

所有请求都必须发送一个 `Authorization`  带有你的密钥的 HTTP 标头 **认证令牌：**

<pre><code>Authorization： <a data-footnote-ref href="#user-content-fn-1">xxxxxxxx-e458-4592-b607-c2c28afd8b62</a>
</code></pre>

{% hint style="warning" %}
**请妥善保管你的令牌，切勿泄露！Edgegap 工作人员绝不会向你索要令牌。**
{% endhint %}

{% hint style="info" %}
Matchmaker 令牌和 Server Browser 令牌与 Edgegap API 令牌是分开的。
{% endhint %}

{% hint style="success" %}
**此令牌可以安全地包含在您的游戏客户端中，因为它不会授予访问 Edgegap API 的权限。**
{% endhint %}

单个玩家可通过其票据 ID 识别，该 ID 在客户端和服务器上均可用。可选地，您还可以使用自定义代理通过 [#server-to-server-api](#server-to-server-api "mention") API。

### 组队

创建组可确保玩家与好友一起加入同一队伍和服务器。

{% hint style="success" %}
创建一个标记为就绪的组以 [#find-match](#find-match "mention") 快速地作为一个 **没有组成员的单人玩家**.
{% endhint %}

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FO79XVv9r9uZQ7ZI1kbFv%2FUntitled-2024-12-04-1155.png?alt=media&amp;token=9cf9caab-236d-4127-bb0f-4d50e1915f47" alt=""><figcaption><p>组生命周期活动图</p></figcaption></figure>

#### 大厅和组

大厅和组是相似但略有不同的术语，涉及 [玩家会话](https://docs.edgegap.com/zh/learn/bian-pai/wan-jia-hui-hua.md).

如果您的游戏设计需要设置由玩家控制的匹配偏好（例如角色选择、难度、地图等），请使用大厅服务。随着玩家加入和离开大厅，他们也会更新匹配组，以便稍后准备寻找匹配。

{% hint style="success" %}
**没有时间搭建大厅服务？** 引导玩家通过 Discord 或私信分享组 ID。
{% endhint %}

<table data-search="false"><thead><tr><th width="390">游戏设计 - 功能 / 需求</th><th>赛前大厅</th><th>匹配器组</th></tr></thead><tbody><tr><td><a data-footnote-ref href="#user-content-fn-2">邀请好友和我一起玩</a></td><td>✅</td><td>✅</td></tr><tr><td>修改我的玩家/匹配偏好</td><td>✅</td><td>❌</td></tr><tr><td>查看其他大厅成员偏好</td><td>✅</td><td>❌</td></tr><tr><td>存储和管理自定义键值数据</td><td>✅</td><td>❌</td></tr><tr><td>通知组成员我已准备好开始游戏</td><td>❌</td><td>✅</td></tr><tr><td>显示匹配进度并查找匹配</td><td>❌</td><td>✅</td></tr><tr><td>获取玩家/组的队伍分配</td><td>❌</td><td>✅</td></tr><tr><td>检索游戏服务器连接详情</td><td>❌</td><td>✅</td></tr></tbody></table>

我们的跨平台匹配器支持所有商业和自定义大厅服务：

<table data-search="false"><thead><tr><th width="414">游戏后端（包括第三方大厅服务）</th><th width="120" data-type="checkbox">虚幻引擎</th><th width="75" data-type="checkbox">Unity</th><th data-type="checkbox">Godot</th></tr></thead><tbody><tr><td><a href="https://dev.epicgames.com/docs/game-services/lobbies-and-sessions/lobbies/lobbies-intro">Epic Online Services 大厅</a><br>（Epic Games）</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="https://partner.steamgames.com/doc/features/multiplayer/matchmaking#friends">Steamworks 大厅</a><br>（Valve 公司）</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="https://heroiclabs.com/docs/nakama/concepts/groups/">Nakama 组</a><br>（Heroic Labs）</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="https://learn.microsoft.com/en-us/gaming/playfab/community/associations/groups/quickstart">PlayFab 大厅</a><br>（微软）</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="https://docs.braincloudservers.com/learn/key-concepts/multiplayer/lobbies/#lobby-experience">brainCloud 大厅</a><br>（bitHeads）</td><td>true</td><td>true</td><td>true</td></tr><tr><td><a href="https://github.com/foxssake/noray">noray</a><br>（Netfox）</td><td>false</td><td>false</td><td>true</td></tr><tr><td><a href="https://developer.apple.com/documentation/gamekit/connecting-players-with-their-friends-in-your-game">Gamekit 好友</a><br>（苹果）</td><td>true</td><td>true</td><td>false</td></tr><tr><td>自定义大厅<br>（你的公司）</td><td>true</td><td>true</td><td>true</td></tr></tbody></table>

大厅拥有者（发送邀请的玩家）也必须创建匹配组。

**将您组的 ID 存储在共享大厅数据中**，这样其他大厅成员就能轻松找到并加入与第三方大厅关联的匹配组。被邀请加入该组的玩家使用组 ID 来 **创建其成员关系（加入）**，并 **安全地存储其** [**匹配属性**](#matchmaking-rules)**.**

{% hint style="warning" %}
**一旦组开始匹配，就无法再加入。** [#abandon-queue](#abandon-queue "mention") 并创建一个新的。
{% endhint %}

#### Ping 优化

如果 [#configuration](#configuration "mention") 包含 [`延迟` 规则](#rule-example-elo_rating) 所有组成员发送他们的 [Ping 信标](https://docs.edgegap.com/zh/learn/bian-pai/ping-beacons.md) 测量值到 **防止将来自遥远地区的玩家匹配在一起** 或 ping（延迟）高得多/低得多。

{% code title="示例游戏客户端 Ping 测量值（毫秒）" %}

```json
{
  "Chicago": 224.4,
  "Frankfurt": 23.2,
  "Tokyo": 167.4
}
```

{% endcode %}

#### **离开队列**

组拥有者可以删除该组，系统会自动删除所有组成员关系。匹配开始后删除该组将取消所有成员关系，并在稍后将其删除。

组成员（除拥有者外）可以在之前的任何时间删除其成员关系（离开组） [#find-match](#find-match "mention")。之后删除成员关系将取消整个组的匹配。

{% hint style="info" %}
一旦匹配被取消，成员将 [自动从匹配中移除](#matchmaking-profiles) 并通过成员关系收到通知 `status:CANCELLED`  在其下一次状态轮询响应中。
{% endhint %}

一旦取消，如果组希望重新开始匹配，组拥有者必须重新创建该组，将新的组 ID 分享给成员，并让他们重新创建其成员关系。

**一旦找到匹配，就不能删除组** (`409 冲突`），并将 [自动移除](#connect-to-server)。您的服务器应留出一些时间（例如 60 秒）让玩家连接，然后再假定玩家已离开。

如果您的服务器将某玩家标记为离开，您可以：

* 用 AI 角色替代离开者，以立即开始比赛，
* 或创建一个 [回填](#backfill-match) 来寻找新玩家替代离开者，
* 或者在游戏设计允许可变玩家数量时，不替换离开者直接继续。

### 查找匹配

要开始寻找匹配，所有成员和拥有者都必须将自己标记为就绪。

{% hint style="success" %}
为了让组拥有者 **立即开始匹配，在创建时将成员标记为就绪**。一旦拥有者将自己标记为就绪，匹配将开始，因为所有人都已准备好。
{% endhint %}

{% hint style="info" %}
为了获得最佳体验， **通过游戏内 UI 向玩家提供状态更新**.
{% endhint %}

**所有玩家必须定期轮询其成员关系** （建议 1-5 秒）以检测匹配何时开始，并通过游戏内 UI 传达匹配进度。

玩家应当 **持久保存其成员关系和组 ID**，以便在游戏客户端崩溃时重新启动游戏并恢复，而不会丢失匹配进度。

在此阶段删除成员关系将导致所有组成员关系被取消，并且所有其他分配到同一队伍的组将返回到 `status:SEARCHING` .

玩家使用其组之间重叠的值（如果是 `number_difference` ）来寻找匹配，直到组建足够的玩家和队伍。成员关系会通过响应  `status:MATCH_FOUND` ，这意味着您的 [部署正在启动](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-1.-start-a-deployment).

玩家可以从 `status:MATCH_FOUND`  回退到 `status:SEARCHING`  ，如果所有（已配置的）部署重试都已用尽且仍未成功。

#### 部分匹配

如果您的匹配器配置允许动态队伍大小（不同的最小和最大设置），某些玩家最终可能会获得部分匹配——即玩家数量少于定义的最大值。&#x20;

**匹配器不会生成少于定义的最小队伍大小的匹配。**

允许部分匹配的唯一场景是：

1. 队列中的一个或多个玩家达到 [#rule-expansion](#rule-expansion "mention") （如果已定义），
2. 队列中的一个或多个玩家达到票据过期时间。

部分匹配只尝试一次。未匹配的玩家将收到 `status:CANCELLED`.

{% hint style="info" %}
在测试期间，或当玩家位于不太热门的区域时，是否遇到很长的排队时间？将更短的票据过期时间（例如 30 秒）并在过期后在客户端重新创建组（或票据）。
{% endhint %}

{% hint style="success" %}
存储 `team_id`  和 `match_id` 在您的游戏后端中，以便在游戏内显示队伍成员信息。
{% endhint %}

每个玩家都会收到一个 **唯一的票据 ID，可用于** [#authenticate](#authenticate "mention") **与游戏服务器。**

如果玩家已被匹配并分配到游戏服务器，其票据会自动删除。在之后离开队列的玩家 `status:HOST_ASSIGNED`  可以被替换为 [回填](#backfill-match).

一旦玩家收到 `status:HOST_ASSIGNED`  他们就继续进行 [#connect-to-server](#connect-to-server "mention").

### 连接到服务器

在找到匹配后几秒，成员资格将继续进入 `状态：HOST_ASSIGNED`  这表明你的 [部署现已就绪，游戏服务器正在初始化](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-3.-deployment-ready).

每位玩家读取其 `ticket_id`  和  `分配`  并尝试使用以下方式连接 [**FQDN**](#user-content-fn-3)[^3] **（部署 URL）** 以及 **外部端口**。此时你的游戏服务器可能仍在初始化，因此 **玩家必须多次重试连接**，直到超过你通常的服务器初始化时间：

{% tabs %}
{% tab title="Unreal Engine" %}
为了 **从 PIE（编辑器）连接** 在开发和测试期间，按波浪号键 `~`  并输入 `open {URL}:{port}`  并等待编辑器加载地图。

为了 **从游戏客户端构建连接** （在正式生产环境中）尝试

* Unreal Engine [⚡ 集成套件](https://docs.edgegap.com/learn/unreal-engine-games/developer-tools#integration-kit):
  * [从 Fab Marketplace 安装](https://www.fab.com/listings/ff17ad88-12a1-49cf-9a41-31695ed11e16) （个人使用免费），
  * [导入简单示例蓝图](https://blueprintue.com/blueprint/m33u1okj/) 并根据你的需要进行自定义。

{% hint style="success" %}
如果连接失败或出现黑屏，请查阅我们的 [故障排除指南](https://docs.edgegap.com/zh/unreal-engine.md#troubleshooting-and-faq).
{% endhint %}
{% endtab %}

{% tab title="Unity" %}
为了 **连接你的 Unity 编辑器** 或 **游戏客户端** 到你的云部署，请输入：

* **部署** **URL** 指向服务器 IP，通常在 `NetworkManager` 组件中。
* **外部端口** 映射到 [服务器的内部监听端口](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md#port-mapping)，通常在 Transport 组件中。

{% hint style="success" %}
如果连接超时或遇到其他问题，请查阅我们的 [故障排除指南](https://docs.edgegap.com/zh/unity.md#troubleshooting-and-faq-4).
{% endhint %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
我们不会要求玩家确认匹配，因为我们的目标是尽可能缩短进入游戏的时间、提高匹配填充率，并尽量减少排队逃避和匹配取消。
{% endhint %}

游戏客户端应 **在游戏重启之间持久保存其分配 ID**，以便在游戏客户端崩溃时能够检索连接详情并尝试重新连接。

### 回填匹配

可选地，一些游戏可能有特殊的匹配需求，例如：

* 允许新玩家加入进行中的游戏（好友或“随机玩家”），
* 在服务器启动后替换弃游的玩家（离开者），以避免重启对局，
* 允许观众加入并观看锦标赛或好友的比赛（电子竞技），
* 将玩家集中到更大的服务器中，以提供更多社交互动（MMO）。

回填是一种 **由服务器持有的票据，代表当前连接到服务器的玩家。** 这可确保新加入的玩家在与当前玩家匹配时遵守你的匹配规则。

{% hint style="warning" %}
[深入了解](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong/matchmaker-in-depth.md#backfill-match) 用于替换 Seat/Match 会话。匹配器仅支持 Default 会话。
{% endhint %}

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FJhdLAJYga4z2sjxLj6LM%2FUntitled-2024-10-29-1018.png?alt=media&amp;token=279136ba-a15e-46b0-a119-8419b8aca044" alt=""><figcaption><p>回填场景可视化</p></figcaption></figure>

{% hint style="success" %}
**回填会忽略** `player_count`  **规则，并且始终只匹配一个组**. `backfill_group_size`  通过轮询策略控制队伍容量，以受控方式均匀填充队伍。
{% endhint %}

**完成一次成功回填的步骤如下：**

1. 服务器应为每个缺少玩家的队伍创建一个回填，使用以下值：
   * 真实 `分配`  从以下来源获取的数据 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#injected-environment-variables) （部署）。
   * 当前连接玩家的 `票据`:
     * 来自 [深入了解](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong/matchmaker-in-depth.md#injected-variables) （匹配器）、先前回填的 `assigned_ticket` 响应，或经过调整以匹配特定玩家的模拟数据，
     * 替换 `backfill_group_size`  将值替换为可能的组大小 直到可用容量[^4],
2. 游戏客户端创建新的票据（成员资格）并包含 `backfill_group_size`  值：
   * `"1"`  如果玩家单独进行匹配。
   * [`"2"`  如果玩家属于一个总共 2x 名成员的匹配组](#user-content-fn-5)[^5].
   * `"new"`  如果玩家除了加入进行中的游戏外，还启用了开始新游戏。
3. 游戏客户端随后会 [深入了解](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong/matchmaker-in-depth.md#find-match) 并将玩家与匹配的回填进行配对。
4. 如果回填后的组未能完全填满队伍，服务器可以使用新回填玩家的票据重复此过程，以添加更多玩家并达到所需的队伍规模。

{% hint style="success" %}
回填会忽略队伍规模规则，并始终将 1 个回填与 1 个组进行匹配。 **若只与回填匹配并禁用与队列中其他玩家的匹配，请设置 `min_team_size: 999999` .**
{% endhint %}

<details>

<summary>🥛 回填示例（回填展示）</summary>

```json
{
  "profile": "backfill-example",
  "属性": {
    "assignment": {
      "request_id": "cd28e6c66554",
      "fqdn": "cd28e6c66554.pr.edgegap.net",
      "public_ip": "192.168.2.14",
      "ports": {
        "game": {
          "internal": 7777,
          "external": 56890,
          "link": "cd28e6c66554.pr.edgegap.net:56890",
          "protocol": "UDP"
        },
        "web": {
          "internal": 22,
          "external": 57440,
          "link": "cd28e6c66554.pr.edgegap.net:57440",
          "protocol": "TCP"
        },
        "server": {
          "internal": 80,
          "external": 50110,
          "link": "cd28e6c66554.pr.edgegap.net:50110",
          "protocol": "TCP"
        }
      },
      "location": {
        "city": "蒙特利尔",
        "country": "加拿大",
        "continent": "北美洲",
        "administrative_division": "魁北克",
        "timezone": "America/Toronto"
      }
    }
  },
  "tickets": {
    "c3d057h5h6f7j889fk43": {
      "player_ip": "174.25.48.238",
      "属性": {
        "信标": {
          "纽约": 12.2,
          "洛杉矶": 45.3,
          "巴黎": 78.3
        },
        "backfill_group_size": [
          "2",
          "1"
        ]
      },
      "group_id": "192bb97e-7fd6-4d86-8ce4-61c53c9fef16",
      "id": "c3d057h5h6f7j889fk43",
      "created_at": "2024-08-20T13:38:05.251393+00:00"
    },
    "cqg0bg9583s738h9dkf6": {
      "player_ip": "217.34.85.142",
      "属性": {
        "信标": {
          "纽约": 21.0,
          "洛杉矶": 30.2,
          "巴黎": 101.1
        },
        "backfill_group_size": [
          "2",
          "1"
        ]
      },
      "group_id": "aea7df3c-d391-4ea3-a3ec-dded422fe7c8",
      "id": "cqg0bg9583s738h9dkf6",
      "created_at": "2024-08-20T13:38:05.251393+00:00"
    }
  },
  "assigned_ticket": null
}
```

</details>

<details>

<summary>🥛 回填分配示例（回填展示）</summary>

```json
{
  "profile": "backfill-example",
  "属性": {
    "assignment": {
      "request_id": "cd28e6c66554",
      "fqdn": "cd28e6c66554.pr.edgegap.net",
      "public_ip": "192.168.2.14",
      "ports": {
        "game": {
          "internal": 7777,
          "external": 56890,
          "link": "cd28e6c66554.pr.edgegap.net:56890",
          "protocol": "UDP"
        },
        "web": {
          "internal": 22,
          "external": 57440,
          "link": "cd28e6c66554.pr.edgegap.net:57440",
          "protocol": "TCP"
        },
        "server": {
          "internal": 80,
          "external": 50110,
          "link": "cd28e6c66554.pr.edgegap.net:50110",
          "protocol": "TCP"
        }
      },
      "location": {
        "city": "蒙特利尔",
        "country": "加拿大",
        "continent": "北美洲",
        "administrative_division": "魁北克",
        "timezone": "America/Toronto"
      }
    }
  },
  "tickets": {
    "c3d057h5h6f7j889fk43": {
      "player_ip": "174.25.48.238",
      "属性": {
        "信标": {
          "纽约": 12.2,
          "洛杉矶": 45.3,
          "巴黎": 78.3
        },
        "backfill_group_size": [
          "2",
          "1"
        ]
      },
      "group_id": "192bb97e-7fd6-4d86-8ce4-61c53c9fef16",
      "id": "c3d057h5h6f7j889fk43",
      "created_at": "2024-08-20T13:38:05.251393+00:00"
    },
    "cqg0bg9583s738h9dkf6": {
      "player_ip": "217.34.85.142",
      "属性": {
        "信标": {
          "纽约": 21.0,
          "洛杉矶": 30.2,
          "巴黎": 101.1
        },
        "backfill_group_size": [
          "2",
          "1"
        ]
      },
      "group_id": "aea7df3c-d391-4ea3-a3ec-dded422fe7c8",
      "id": "cqg0bg9583s738h9dkf6",
      "created_at": "2024-08-20T13:38:05.251393+00:00"
    }
  },
  "assigned_ticket": {
    "profile": "backfill-example",
    "player_ip": "244.13.201.244",
    "属性": {
      "信标": {
        "纽约": 30.2,
        "洛杉矶": 10.5,
        "巴黎": 123.9
      },
      "backfill_group_size": [
        "new",
        "1"
      ]
    },
    "id": "cqg0bg550h7uujd77khg",
    "group_id": "e0cf41c0-f88f-456e-a032-03b1d6821a9a",
    "created_at": "2024-08-20T13:38:08.251393+00:00",
    "status": "HOST_ASSIGNED"
  }
}
```

</details>

{% hint style="info" %}
参见 [镜像座位管理](https://docs.edgegap.com/docs/sample-projects/mirror-on-edgegap#bonus-seat-sessions-management) 和 [FishNet 座位管理](https://docs.edgegap.com/docs/sample-projects/fishnet-on-edgegap#bonus-seat-sessions-management) 用于 **玩家连接监控**.
{% endhint %}

一旦游戏服务器初始化完成， **您的服务器应当**:

* **为每个新玩家启动离开计时器。** 我们建议通过加载场景/关卡向已连接玩家显示加载进度——可以是完整的 3D 场景、类似大厅的社交 UI，或带有进度条的加载界面。
* **跟踪新玩家连接或现有玩家随时间离开**:
  1. 新玩家必须向服务器声明票据 ID，以便进行验证并将其连接映射到匹配器 [#injected-variables](#injected-variables "mention") 或 `assigned_ticket` （如果已回填）。
  2. 在服务器生命周期内，为未使用的玩家容量（离开者）创建新的回填。
  3. 续订已过期的回填，它们会在之后被删除 `ticket_expiration_period`.
* **清理（删除）任何剩余的回填** 一旦 [/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-5.-deployment-stopped](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-5.-deployment-stopped "mention"):
  * Unity - [`OnApplicationQuit`](https://docs.unity3d.com/6000.0/Documentation/ScriptReference/MonoBehaviour.OnApplicationQuit.html) 回调或自定义游戏结束回调，
  * Unreal Engine - [`OnWorldDestroyed`](https://forums.unrealengine.com/t/call-function-before-quit-game/344954/2) , [`PreExit`](https://forums.unrealengine.com/t/event-on-close/298087/2) ，或自定义游戏结束回调。

{% hint style="info" %}
一旦就绪，部署会被分配一个 URL（ [服务器状态可能会丢失](https://learn.microsoft.com/en-us/dotnet/api/system.environment.getenvironmentvariable?view=net-8.0) 注入的变量（Injected Variables） [游戏服务器通常需要额外信息，例如服务器 IP、内部端口值等。注入只读环境变量是传递参数的一种可靠且与云无关的方式。](https://dev.epicgames.com/documentation/en-us/unreal-engine/API/Runtime/Core/GenericPlatform/FGenericPlatformMisc/GetEnvironmentVariable) 获取变量值。
{% endhint %}

只要提供有效的服务器分配且至少提供一个票据，任何配置文件都可用于回填。请参见 [匹配系统](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md#backfill-showcase) 了解最小示例。

## ⚙️ 配置

匹配器 API 是根据您创建新的（或快速重启）匹配器时指定的 JSON 配置生成的。您可以指定任意数量的配置文件，并具有不同的规则和扩展：

{% hint style="success" %}
请参见 [匹配系统](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md) 查看我们的 SDK 和详细示例场景。
{% endhint %}

<details>

<summary>🍀 简单示例（最小推荐配置）</summary>

<pre class="language-json"><code class="lang-json">{
  "版本": "3.3.3",
  "检查": true,
  "最大部署重试次数": 3,
  "配置文件": {
    "simple-example": {
      "票证过期时间": "5m",
      "票据移除时长": "1m",
      "组不活跃移除时长": "5m",
      "应用程序": {
        "name": "<a data-footnote-ref href="#user-content-fn-6">my-game-server</a>",
        "version": "<a data-footnote-ref href="#user-content-fn-7">2024.01.30-16.23.00-UTC</a>"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "类型": "玩家数量",
            "属性": {
              "队伍数量": 1,
              "min_team_size": 2,
              "max_team_size": 2
            }
          },
          "信标": {
            "类型": "延迟",
            "属性": {
              "difference": 100,
              "max_latency": 200
            }
          }
        },
        "expansions": {}
      }
    }
  }
}
</code></pre>

</details>

<details>

<summary>🏁 高级示例（完整示例配置）</summary>

```json
{
  "版本": "3.3.3",
  "检查": true,
  "最大部署重试次数": 3,
  "allowed_cors_origins": [
    "https://*.my-game-server.com"
  ],
  "配置文件": {
    "advanced-example": {
      "票证过期时间": "5m",
      "票据移除时长": "1m",
      "组不活动移除时间": "5m"
      "应用程序": {
        "名称": "my-game-server",
        "版本": "2024.01.30-16.23.00-UTC"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "类型": "玩家数量",
            "属性": {
              "队伍数量": 1,
              "min_team_size": 4,
              "max_team_size": 4
            }
          },
          "信标": {
            "类型": "延迟",
            "属性": {
              "差值": 125,
              "max_latency": 125
            }
          },
          "ELO 等级": {
            "类型": "数值差",
            "属性": {
              "最大差值": 50
            }
          },
          "selected_game_mode": {
            "type": "string_equality"
          },
          "selected_map": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          },
          "补位组大小": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          }
        },
        "扩展": {
          "30": {
            "ELO 等级": {
              "max_difference": 150
            },
            "信标": {
              "差值": 125,
              "最大延迟": 250
            }
          },
          "60": {
            "ELO 等级": {
              "max_difference": 200
            }
          },
          "180": {
            "匹配大小": {
              "队伍数量": 1,
              "最小队伍规模": 1,
              "max_team_size": 4
            },
            "信标": {
              "差值": 99999,
              "最大延迟": 99999
            }
          }
        }
      }
    }
  }
}
```

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f95b">🥛</span> 回填配置示例</summary>

```json
{
  "版本": "3.3.3",
  "检查": true,
  "最大部署重试次数": 3,
  "配置文件": {
    "backfill-example": {
      "ticket_expiration_period": "30s",
      "票据移除时长": "1m",
      "组不活跃移除时长": "5m",
      "应用程序": {
        "名称": "my-game-server",
        "版本": "2024.01.30-16.23.00-UTC"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "类型": "玩家数量",
            "属性": {
              "队伍数量": 1,
              "min_team_size": 4,
              "max_team_size": 4
            }
          },
          "信标": {
            "类型": "延迟",
            "属性": {
              "difference": 100,
              "max_latency": 200
            }
          },
          "补位组大小": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          }
        },
        "expansions": {}
      }
    }
  }
}
```

</details>

<details>

<summary>⚔️ 竞技游戏示例</summary>

```json
{
  "版本": "3.3.3",
  "检查": true,
  "最大部署重试次数": 3,
  "配置文件": {
    "休闲-示例": {
      "票证过期时间": "5m",
      "票证移除时间": "1m",
      "组不活动移除时间": "5m",
      "应用": {
        "名称": "我的游戏服务器",
        "版本": "2024.01.30-16.23.00-UTC"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "类型": "玩家数量",
            "属性": {
              "队伍数量": 2,
              "最小队伍人数": 5,
              "最大队伍人数": 5
            }
          },
          "信标": {
            "类型": "延迟",
            "属性": {
              "差值": 125,
              "最大延迟": 150
            }
          },
          "选择的地图": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          },
          "回填组大小": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          }
        },
        "扩展": {
          "30": {
            "信标": {
              "差值": 125,
              "最大延迟": 250
            }
          },
          "180": {
            "信标": {
              "差值": 99999,
              "最大延迟": 99999
            }
          }
        }
      }
    },
    "竞技-示例": {
      "票证过期时间": "5m",
      "票证移除时间": "1m",
      "组不活动移除时间": "5m"
      "应用": {
        "名称": "我的游戏服务器",
        "版本": "2024.01.30-16.23.00-UTC"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "类型": "玩家数量",
            "属性": {
              "队伍数量": 2,
              "最小队伍人数": 5,
              "最大队伍人数": 5
            }
          },
          "信标": {
            "类型": "延迟",
            "属性": {
              "差值": 125,
              "最大延迟": 150
            }
          },
          "对战段位": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          }
        },
        "扩展": {
          "120": {
            "信标": {
              "差值": 125,
              "最大延迟": 250
            }
          }
        }
      }
    },
    "挑战者-示例": {
      "票证过期时间": "5m",
      "票证移除时间": "1m",
      "组不活动移除时间": "5m"
      "应用": {
        "名称": "我的游戏服务器",
        "版本": "2024.01.30-16.23.00-UTC"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "类型": "玩家数量",
            "属性": {
              "队伍数量": 2,
              "最小队伍人数": 5,
              "最大队伍人数": 5
            }
          },
          "信标": {
            "类型": "延迟",
            "属性": {
              "差值": 125,
              "最大延迟": 150
            }
          },
          "ELO 等级": {
            "类型": "数值差",
            "属性": {
              "最大差值": 50
            }
          }
        },
        "扩展": {
          "120": {
            "信标": {
              "差值": 125,
              "最大延迟": 250
            }
          }
        }
      }
    }
  }
}
```

</details>

<details>

<summary>🤝 合作游戏示例</summary>

```json
{
  "版本": "3.3.3",
  "检查": true,
  "最大部署重试次数": 3,
  "配置文件": {
    "cooperative-example": {
      "票据过期时长": "3m",
      "票据移除时长": "1m",
      "组不活跃移除时长": "5m",
      "应用程序": {
        "名称": "my-game-server",
        "版本": "2024.01.30-16.23.00-UTC"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "类型": "玩家数量",
            "属性": {
              "队伍数量": 1,
              "min_team_size": 4,
              "max_team_size": 4
            }
          },
          "信标": {
            "类型": "延迟",
            "属性": {
              "差值": 125,
              "最大延迟": 150
            }
          },
          "selected_difficulty": {
            "type": "string_equality"
          },
          "selected_map": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          },
          "player_level": {
            "类型": "数值差",
            "属性": {
              "max_difference": 10
            }
          },
          "补位组大小": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          },
          "审核标志": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          }
        },
        "扩展": {
          "30": {
            "信标": {
              "差值": 125,
              "最大延迟": 250
            },
            "player_level": {
              "max_difference": 20
            }
          },
          "60": {
            "匹配大小": {
              "队伍数量": 1,
              "min_team_size": 2,
              "max_team_size": 4
            }
          },
          "150": {
            "匹配大小": {
              "队伍数量": 1,
              "最小队伍规模": 1,
              "max_team_size": 4
            }
          }
        }
      }
    }
  }
}
```

</details>

<details>

<summary>🎈 社交游戏示例</summary>

```json
{
  "版本": "3.3.3",
  "检查": true,
  "最大部署重试次数": 3,
  "配置文件": {
    "社交-示例": {
      "票据过期时长": "3m",
      "票据移除时长": "1m",
      "组不活跃移除时长": "5m",
      "应用程序": {
        "名称": "my-game-server",
        "版本": "2024.01.30-16.23.00-UTC"
      },
      "规则": {
        "初始": {
          "匹配大小": {
            "属性": {
              "队伍数量": 1,
              "最小队伍规模": 50,
              "最大队伍规模": 50
            },
            "类型": "玩家数量"
          },
          "信标": {
            "属性": {
              "差值": 125,
              "最大延迟": 150
            },
            "类型": "延迟"
          },
          "所选模式": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          },
          "补位组大小": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          },
          "审核标志": {
            "类型": "交集",
            "属性": {
              "重叠": 1
            }
          }
        },
        "扩展": {
          "15": {
            "信标": {
              "差值": 125,
              "最大延迟": 250
            },
            "匹配大小": {
              "队伍数量": 1,
              "最小队伍规模": 20,
              "最大队伍规模": 50
            }
          },
          "30": {
            "匹配大小": {
              "队伍数量": 1,
              "最小队伍规模": 10,
              "最大队伍规模": 50
            }
          },
          "150": {
            "匹配大小": {
              "队伍数量": 1,
              "最小队伍规模": 1,
              "最大队伍规模": 50
            }
          }
        }
      }
    }
  }
}
```

</details>

{% hint style="warning" %}
编辑正在运行的匹配器将 **触发快速重载**，删除所有票据并导致短暂停机。
{% endhint %}

<details>

<summary><code>应用配置对于配置文件 XYZ 无效。</code></summary>

* 我们找不到您的 [应用与版本](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md)，请验证 `应用`  值。

</details>

<details>

<summary><code>标签为 '2024.01.30-16.23.00-UTC' 的 Docker 镜像未被缓存。</code></summary>

[**🌟 升级到按需付费等级**](https://app.edgegap.com/user-settings?tab=memberships) **以解锁** [**具有缓存的即时部署**](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-1.-start-a-deployment)**.**

* 4GB 以上未缓存的镜像可能需要更长时间部署，导致 [/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-4.-deployment-error](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-4.-deployment-error "mention")。请考虑优化您的服务器镜像大小（[虚幻引擎](https://docs.edgegap.com/zh/unreal-engine.md#optimize-server-build-size) / [Unity](https://docs.edgegap.com/zh/unity.md#optimize-server-build-size)).
* 您仍然可以继续，但我们建议测试您的部署时间。

</details>

### 配置文件（队列） <a href="#matchmaking-profiles" id="matchmaking-profiles"></a>

配置文件表示完全分离的匹配队列，共享同一个匹配器版本。您可以 **为每个匹配器配置任意数量的配置文件。** 将玩家群体拆分到多个配置文件中可能会导致玩家排队时间更长。

每个匹配器配置文件都使用一个 [应用版本](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md) 作为启动新部署（服务器）的模板。

{% hint style="success" %}
某些游戏模式可能需要更多的 vCPU / RAM，尤其是当它们支持更多玩家时。每个 **匹配器可能包含多个配置文件**，每个都链接到具有调整后资源的应用版本。
{% endhint %}

### 规则 <a href="#matchmaking-rules" id="matchmaking-rules"></a>

每位玩家和组都会加入匹配队列，并使用  `初始` 规则起初进行匹配。

路径 `.rules.initial` 中的每个条目代表一条规则，其中：

* **键** 是一个字符串值，用于按您喜欢的方式命名规则；例如 `match_size` ，以及
* **值** 是一个定义规则类型和属性的对象，符合我们的标准规则集。

{% hint style="info" %}
所有规则必须同时满足，才能启动主机分配并开始或找到一个部署。
{% endhint %}

**运算符（规则类型）**

**`player_count`** 是一条特殊规则，定义需要多少玩家匹配才能启动分配。

{% hint style="warning" %}
规则 `player_count`  **是必需的，并且只能定义一次** 在您的初始配置规则中。
{% endhint %}

匹配器始终努力使匹配填充率最大化，直到指定的 `max_team_size` :

1. 如果达到最大队伍大小，匹配会立即生成，
2. 否则，玩家会在队列中等待填充匹配，直到 [扩展](#rule-expansion) （或过期）即将到来，
3. 在即将 [扩展](#rule-expansion) （或过期）前，如果允许部分匹配（≥ 最小队伍大小 且 < 最大队伍大小），则该匹配将由处于同一扩展阶段的所有玩家组成（假设其他规则通过）。

{% hint style="success" %}
对于合作、自由混战或非对称队伍大小的游戏模式，请将您的 `"team_count": 1` .
{% endhint %}

队伍数量可以配置为为竞技游戏组成多个平衡的队伍：

* **组属性按平均值/重叠值计算** 组的 **玩家属性，**
* **队伍属性按平均值/重叠值计算** 队伍的 **组属性。**

假设固定队伍规模为 4 名玩家：

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FSFEzBayk3XNEUTIynjNd%2Fimage.png?alt=media&amp;token=11a43fdf-3a99-4caa-8d2b-639e0f3cc06f" alt=""><figcaption><p>示例匹配场景</p></figcaption></figure>

{% hint style="info" %}
**组在队伍中匹配且不会超额填充，** 仅当队伍有足够容量容纳整个组时。
{% endhint %}

**`string_equality`** 与完全相同字符串值的玩家匹配。

<details>

<summary>规则示例： <code>selected_game_mode</code></summary>

`selected_game_mode`  规则会进行区分大小写的匹配：

:white\_check\_mark: Alice + Bob + Dave 可能匹配，

:x: Alice + Erin，或 Charlie + Frank 永远不会匹配。

| "Free For All" | "Capture The Flag" | "capture the flag" |
| -------------- | ------------------ | ------------------ |
| Alice          | Erin               | Frank              |
| Bob            | Charlie            |                    |
| Dave           |                    |                    |

</details>

**`number_difference`** 与彼此之间绝对数值差在范围内的玩家匹配。

<details>

<summary>规则示例： <code>elo_rating</code></summary>

`elo_rating`  上面的规则， `"max_difference": 50` 最初：

:white\_check\_mark: Alice + Bob 可能匹配，或 Bob + Charlie 可能匹配，

:x: Alice + Bob + Charlie 永远不会匹配。

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FxtTxZ7TPSa8a8WtnGNAE%2Fimage.png?alt=media&amp;token=c48b843b-c4e5-47bf-9154-07254a788067" alt=""><figcaption></figcaption></figure>

</details>

**`延迟`** 是一条特殊规则，用于优化玩家匹配的 ping：

* 通过移除延迟高（超过阈值）的区域来降低客户端-服务器延迟，
* 通过将延迟相近（差值低于指定值）的玩家分组来提高匹配公平性。

<details>

<summary>规则示例： <code>信标</code></summary>

`信标` 已配置为以下内容的规则 `"difference": 100, "max_latency": 200`  将匹配：

:white\_check\_mark: Alice 和 Bob 可能匹配：

* 东京被丢弃（>200 毫秒），
* 芝加哥的延迟绝对差在 100 毫秒以内。

<table><thead><tr><th width="180">信标城市</th><th width="80">匹配</th><th width="132">abs(A - B) [毫秒]</th><th width="164">Alice [毫秒]</th><th width="164">Bob [毫秒]</th></tr></thead><tbody><tr><td>芝加哥</td><td><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></td><td>75.0</td><td>12.3</td><td>87.3</td></tr><tr><td>洛杉矶</td><td><span data-gb-custom-inline data-tag="emoji" data-code="274c">❌</span></td><td><a data-footnote-ref href="#user-content-fn-8">113.2</a> <span data-gb-custom-inline data-tag="emoji" data-code="274c">❌</span></td><td>145.6</td><td>32.4</td></tr><tr><td><del>东京</del></td><td>不适用</td><td>不适用</td><td><a data-footnote-ref href="#user-content-fn-9"><del>233.2</del></a> <span data-gb-custom-inline data-tag="emoji" data-code="274c">❌</span></td><td><a data-footnote-ref href="#user-content-fn-9"><del>253.2</del></a> <span data-gb-custom-inline data-tag="emoji" data-code="274c">❌</span></td></tr></tbody></table>

:x: Alice 和 Charlie 永远不会匹配：

* 没有任何信标对两位玩家都具有 < 200 毫秒的延迟，
* Alice 住在北美 - 伊利诺伊州，
* Charlie 住在亚洲 - 日本。

<table><thead><tr><th width="180">信标城市</th><th width="80">匹配</th><th width="132">abs(A - B) [毫秒]</th><th width="164">Alice [毫秒]</th><th width="164">Charlie [毫秒]</th></tr></thead><tbody><tr><td><del>芝加哥</del></td><td>不适用</td><td>不适用</td><td>12.3</td><td><a data-footnote-ref href="#user-content-fn-9"><del>215.6</del></a> <span data-gb-custom-inline data-tag="emoji" data-code="274c">❌</span></td></tr><tr><td><del>洛杉矶</del></td><td>不适用</td><td>不适用</td><td>145.6</td><td><a data-footnote-ref href="#user-content-fn-9"><del>238.3</del></a> <span data-gb-custom-inline data-tag="emoji" data-code="274c">❌</span></td></tr><tr><td><del>东京</del></td><td>不适用</td><td>不适用</td><td><a data-footnote-ref href="#user-content-fn-9"><del>233.2</del></a> <span data-gb-custom-inline data-tag="emoji" data-code="274c">❌</span></td><td>24.2</td></tr></tbody></table>

</details>

{% hint style="warning" %}
规则 `延迟`  是 **可选，并且只能在你的初始配置中定义一次** 规则。
{% endhint %}

一些玩家对所有信标的网络延迟很高，原因是 互联网服务提供商[^10] 问题或连接较慢（例如无线/移动）可能导致延迟并降低其他人的游戏体验。为缓解此问题：

* 逐步扩大允许的最大延迟和差异（参见 [高级示例配置](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md#advanced-example)),
  * 延迟高的玩家可能需要比平时更长时间才能找到匹配。
* 或者，允许玩家通过手动区域选择来覆盖测量，只为玩家选择的区域发送伪造的延迟值（例如为快速匹配设置为25毫秒），
  * 这可能会对该玩家的队友和对手的游戏体验产生负面影响。

{% hint style="info" %}
**高信标延迟并不总是导致高服务器延迟**。部署点比信标地点更多。信标会实时编排以优先考虑全球覆盖和可靠性。
{% endhint %}

{% hint style="success" %}
参见 [匹配系统](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md) 用于 **使用我们的 SDK 进行自动化延迟测量**.
{% endhint %}

{% hint style="danger" %}
信标会在实时中自动重新调整规模——添加/移除/替换现有信标。您的客户端和后端应考虑到这一点并 **在每轮匹配之前重新加载信标列表**.
{% endhint %}

**`intersection`** 与具有一个或多个重叠字符串值的玩家匹配，区分大小写。

<details>

<summary>规则示例： <code>selected_map</code></summary>

`selected_map` 上面的规则， `"overlap": 1`  将匹配：

:white\_check\_mark: Alice + Bob + Charlie 可能匹配，或 Alice + Bob + Dave 可能匹配，

:x: Alice + Bob + Charlie + Dave 永远不会匹配。

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FcQSUAnRkZKVyuGjFWSYL%2Fimage.png?alt=media&amp;token=bf1a4e28-230a-4c9a-9ef6-a0dea4dbecdb" alt=""><figcaption></figcaption></figure>

</details>

#### 规则扩展

可选地， **`扩展`**  在队列中停留一段时间后修改规则属性，以放宽限制并扩大可匹配的玩家池， **从而更快地匹配**.

在配置中，扩展以相对于每个玩家票据创建时间的秒数进行键控。每次扩展都必须小于票据过期时间才能生效。

<details>

<summary>示例场景：扩展</summary>

[最初，我们需要 1 个由恰好 4 名玩家组成的队伍（可能分布在多个组中）](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md#advanced-example) 具有：

* 针对同一（任一）信标的最大 125 毫秒延迟，
* 同一信标的最低/最高值之间的延迟差不超过 125 毫秒，
* 最低和最高排名玩家之间的技能评级差不超过 50 分，
* 完全相同（区分大小写）的所选游戏模式，
* 玩家之间至少有一个匹配的地图选择（区分大小写），
* 至少一个匹配的 [回填组大小](#backfill-match) 玩家之间的值。

在上面的示例中，我们 **通过修改属性来扩展搜索** 在以下之后：

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td>30 秒后：</td><td><ul><li>4 名玩家</li><li><strong>150 分技能评级范围</strong></li><li><strong>最大 250 毫秒延迟</strong></li></ul></td></tr><tr><td>60 秒后：</td><td><ul><li>4 名玩家</li><li><strong>200 分技能评级范围</strong></li><li>最大 250 毫秒延迟</li></ul></td></tr><tr><td>3 分钟（180 秒）后：</td><td><ul><li><strong>1-4 名玩家</strong></li><li>200 分技能评级范围</li><li><strong>任意延迟</strong></li></ul></td></tr></tbody></table>

</details>

{% hint style="warning" %}
任何规则属性的扩展都将 **覆盖之前的值** 该属性的。
{% endhint %}

{% hint style="success" %}
[**了解常见错误**](https://edgegap.com/blog/how-session-fill-rate-affects-your-multiplayer-hosting-costs)**，以及** [**使用我们的指南优化您的匹配填充率**](https://edgegap.com/blog/how-to-optimize-session-fill-rate-in-your-matchmaker)**.**
{% endhint %}

## 📌 注入变量

您的服务器可能需要了解其玩家的详细信息。玩家属性、解析后的匹配值以及其他值会与通常的 [应用与版本](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md#injected-variables).

预览未格式化 **🏁 高级示例变量：**

```
MM_MATCH_PROFILE=advanced-example
MM_EXPANSION=initial
MM_TICKET_IDS=["cusfn10msflc73beiik0","cusfn18msflc73beiil0"]
MM_TICKET_cusfn10msflc73beiik0={"id":"cusfn10msflc73beiik0","created_at":"2025-02-21T22:17:42.3886970Z","player_ip":"174.93.233.25","group_id":"b2080c27-19c9-4fb0-8fe7-4bf1e5d285d1","team_id":"cusfn1gmsflc73beiim0","attributes":{"beacons":{"Chicago":12.3,"LosAngeles":145.6,"Tokyo":233.2},"elo_rating":1337,"selected_game_mode":"quickplay","selected_map":["DustII","Airport","BankVault"],"backfill_group_size":["new","1"]}}
MM_TICKET_cusfn18msflc73beiil0={"id":"cusfn18msflc73beiil0","created_at":"2025-02-21T22:17:42.2548390Z","player_ip":"174.93.233.23","group_id":"015d4dc8-6c79-4b5c-bbc6-f309b9787c8f","team_id":"cusfn1gmsflc73beiim0","attributes":{"beacons":{"Chicago":87.3,"LosAngeles":32.4,"Tokyo":253.2},"elo_rating":1339,"selected_game_mode":"quickplay","selected_map":["Island","Airport"],"backfill_group_size":["new","1"]}}
MM_GROUPS={"b2080c27-19c9-4fb0-8fe7-4bf1e5d285d1":["cusfn10msflc73beiik0"],"015d4dc8-6c79-4b5c-bbc6-f309b9787c8f":["cusfn18msflc73beiil0"]}
MM_TEAMS={"cusfn1gmsflc73beiim0":["b2080c27-19c9-4fb0-8fe7-4bf1e5d285d1","015d4dc8-6c79-4b5c-bbc6-f309b9787c8f"]}
MM_MATCH_ID=advanced-example_initial-2025-02-21T22:17:43.3886970Z
MM_INTERSECTION={"selected_map":["Airport"],"backfill_group_size":["new","1"]}
MM_EQUALITY={"selected_game_mode":"quickplay"}
```

{% hint style="info" %}
环境变量被 **存储为字符串化的 JSON**，请使用我们的 SDK 或自定义方法解析它们。
{% endhint %}

{% hint style="success" %}
**服务器可以将玩家连接映射到组和属性** 在玩家将其票证 ID 发送到服务器后。
{% endhint %}

## 🧵 玩家追踪

如果你的玩家遇到任何问题，追踪他们到服务器日志的路径会很有帮助。每个匹配器 **部署** **都会标记已分配的玩家票证 ID** 这样你就可以轻松 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#filter-deployments) 并找到 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#container-logs) 以帮助你排查问题。

{% hint style="success" %}
**在客户端匹配历史界面中显示票证 ID 和部署 ID** 以便在排查问题时追踪玩家。
{% endhint %}

{% hint style="info" %}
请参见 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#connection-quality) 以了解部署故障排除。
{% endhint %}

## 👀 分析

无需代码或配置即可深入了解你的匹配器负载和性能。

🌟 [**将匹配器升级到企业层**](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list) **以解锁匹配指标和洞察：**

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fhb8NmB4ELuG7ayGLTeHs%2Fimage.png?alt=media&amp;token=e3e0371e-c33f-48c8-bd15-5c11448dc633" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fl0zTNccJASUTkJfTYxss%2Fimage.png?alt=media&amp;token=0d061320-9524-4b12-83e6-ea9112ef1409" alt=""><figcaption></figcaption></figure>

## ☁️ 托管集群

匹配器由 Edgegap 便捷地全天候 24/7 托管和管理。

选择最适合你目标的托管选项：

* **免费集群（共享）** 用于测试所有功能并探索与您的设计的协同效应，
  * 会在 3 小时后自动关闭，需要重启才能继续测试。
* **私有集群** **（专用）** 以确保为您的生产需求提供稳定的环境，
  * 选择您的区域并为实时游戏获得 24/7 支持，以便自信发布。

#### 私有集群层级

我们目前提供 [3 个私有集群层级](https://edgegap.com/resources/pricing#managed-infrastructure) 以满足每个人的需求：

<table><thead><tr><th width="160">层级</th><th align="right">爱好者层级</th><th align="right">工作室层级</th><th align="right">企业层级</th></tr></thead><tbody><tr><td>最适合</td><td align="right">爱好者，<br>独立开发者</td><td align="right">商业发布</td><td align="right">高流量上线</td></tr><tr><td>速率限制（请求/秒）</td><td align="right">200</td><td align="right">750</td><td align="right">2,000</td></tr><tr><td>资源</td><td align="right">1 vCPU + 2GB 内存</td><td align="right">6 vCPU + 12GB 内存</td><td align="right">18 vCPU + 48GB 内存</td></tr><tr><td>冗余</td><td align="right">1 个虚拟节点</td><td align="right">3 个虚拟节点</td><td align="right">3 个虚拟节点</td></tr><tr><td>价格，每小时</td><td align="right">$0.0312</td><td align="right"> $0.146</td><td align="right">$0.548</td></tr><tr><td><strong>价格，30 天</strong><br>（不间断使用）</td><td align="right"><strong>$22.464</strong></td><td align="right"><strong>$105.12</strong></td><td align="right"><strong>$394.56</strong></td></tr></tbody></table>

一键升级到私有集群。发布后也可以在不影响玩家停机的情况下更改私有集群层级，使用 [#rolling-updates-and-ab-tests](#rolling-updates-and-ab-tests "mention")。托管集群为公开发布的游戏提供由 Edgegap 维护的高可用服务托管和 24/7 实时支持。

你的实例资源需求将取决于以下因素：

* **玩家数量** - 更多玩家会产生更多票证和 API 请求，
* **每个玩家的请求数量** - 更快的重试会增加服务负载并消耗资源，
* **配置复杂度** - 交叉规则和扩展尤其耗费资源，
* **平均对局时长** - 更短的会话会让玩家更频繁地重新进入匹配，
* **过期和移除周期** - 过期票证会随着时间堆积并消耗资源，
* **客户端重试回退逻辑** - 使用带抖动的退避重试有助于分散流量峰值。

{% hint style="warning" %}
**为成功做好准备并在发布后进行优化，这样就不会在上线当天阻塞你的玩家。** 使用 [开发者工具](https://docs.edgegap.com/zh/unity/developer-tools.md#matchmaking-sdk) 或 **实现指数型抖动退避** 以从高负载中恢复。
{% endhint %}

{% hint style="info" %}
我们的集群使用云机器，配备 AMD/Intel CPU，时钟速度最高可达 3.7 GHz。
{% endhint %}

## ⏩ 滚动更新 <a href="#rolling-updates-and-ab-tests" id="rolling-updates-and-ab-tests"></a>

跟踪服务器和客户端版本之间的兼容性可能会变得很复杂。请遵循我们的建议，以实现可靠发布、更新并防止停机或兼容性问题。

**重启后你的匹配器 URL 和认证令牌将始终保持不变。**

{% hint style="danger" %}
**为开发和生产创建独立的匹配器** 环境，以安全地进行实验。
{% endhint %}

#### ⚠️ **上线前**

我们建议提前创建多个匹配器副本： `绿色`, `蓝色` 和 `橙色`。你可以在发布更新时轮换正在使用的匹配器（[蓝绿策略](https://en.wikipedia.org/wiki/Blue%E2%80%93green_deployment)).

**为每个实例选择不同区域以防止停机** 在局部故障期间。

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Flzy4elHYDPBMpjSMG1HS%2Fimage.png?alt=media&amp;token=7da795fc-ae6c-490f-b65c-5f8dda635503" alt=""><figcaption><p>蓝绿 DevOps 环境示例</p></figcaption></figure>

#### **🔃 客户端 + 服务器更新**

**前提条件：** 本节假设你已完成 [#before-going-live](#before-going-live "mention").

为了 **发布游戏客户端 + 服务器更新**，你可以：

1. 准备新的服务器应用版本 `v1.2.0-rc` 在 Edgegap 上：
   1. 将新的镜像标签推送到你的容器注册表 `t1.2.0`,
   2. 创建新的应用版本 `v1.2.0-rc`,
2. 通过以下方式执行任何开发测试： [部署你的新应用版本](https://app.edgegap.com/deployment-management/deployments/list) `v1.2.0-rc`:
   1. 将你的游戏引擎编辑器连接到提供的 URL + 外部端口，
3. 更新未使用的匹配器 `蓝色` 以链接到你的新镜像标签 `t1.2.0`,
   1. 为新的应用版本启用缓存 `v1.2.0-rc` ，为此版本启用缓存将确保该镜像也会被缓存到版本 `v-blue`  因为它们引用的是同一个标签，
   2. 等待版本中的缓存指示器 `v1.2.0-rc`  达到 :green\_circle: 绿色，
4. 更新你的新游戏客户端 `c2` 以使用新版本 `v-blue` 在创建票证时：
   1. 在游戏客户端中更新你的基础 URL 和 Authorization 令牌，
5. 对你的新游戏客户端执行 QA 测试和最终验证 `c2`:
   1. 如果你发现并解决了任何问题，请从头重复该流程，
   2. 在匹配器停止后，等待 3-7 天让匹配器 DNS 更改传播到全球各地的 ISP（快速重启不需要 DNS 更新或等待期），
6. 发布你的新游戏客户端更新 `c2` 在游戏分发平台上，
7. 留出时间让新的游戏客户端 `c2` 分发到玩家设备（通常最多需要 3-7 天）：
   1. 监控过时的游戏客户端 `c1`  使用部署 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#analytics),
8. 清理你 Edgegap 账户中的未使用资源：
   1. 删除镜像标签 `t1.0.0` 以释放容器注册表容量，
   2. 删除镜像标签 `t1.1.0` 以释放容器注册表容量，
   3. 关闭你的 `绿色`  匹配器，以暂停计费直到下次更新。

{% hint style="success" %}
**对于下次更新**，提高版本号并交换 `绿色` 和 `蓝色` 指南中的关键词。
{% endhint %}

#### **⚡ 服务器热修复**

**前提条件：** 本节假设你已完成 [#before-going-live](#before-going-live "mention").

为了 **在不需要游戏客户端更新的情况下发布服务器补丁**，你可以：

1. 准备新的服务器应用版本 `v1.2.0-rc` 在 Edgegap 上：
   1. 将新的镜像标签推送到你的容器注册表 `t1.2.0`,
   2. 创建新的应用版本 `v1.2.0-rc`,
2. 通过以下方式执行测试和验证： [部署你的新应用版本](https://app.edgegap.com/deployment-management/deployments/list) `v1.2.0-rc`:
   1. 将你的游戏引擎编辑器连接到提供的 URL + 外部端口，
   2. 如果你发现并解决了任何问题，请从头重复该流程，
   3. 为新的应用版本启用缓存 `v1.2.0-rc` ，为此版本启用缓存将确保该镜像也会被缓存到版本 `v-green`  稍后，因为它们将引用同一个标签，
   4. 等待版本中的缓存指示器 `v1.2.0-rc`  达到 :green\_circle: 绿色，
3. 更新版本 `v-green`  以链接到你的新镜像标签 `t1.2.0`,
   1. 新的匹配将自动使用更新后的标签开始分配 `t1.2.0`,
   2. 监控过时的游戏客户端 `c1`  使用部署 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#analytics),
4. 清理你 Edgegap 账户中的未使用资源：
   1. 删除镜像标签 `t1.1.0` 以释放容器注册表容量。

## 📗 API <a href="#matchmaking-api" id="matchmaking-api"></a>

客户端和服务器可以直接调用 API，或使用游戏引擎 SDK，另请参阅 [匹配系统](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md).

{% hint style="info" %}
Unity/Android - 考虑 [使用原始字符串插值](https://www.c-sharpcorner.com/article/convert-string-to-json-in-c-sharp/) 以防止对硬编码 JSON 的代码剥离。
{% endhint %}

{% hint style="success" %}
**Swagger Web 界面**: 部署您的托管服务会生成一个 OpenAPI 规范和一个便捷的 Web 界面，可用于测试边缘情况或验证负载结构。
{% endhint %}

{% tabs fullWidth="false" %}
{% tab title="🍀 简单示例" %}
{% file src="/files/3f48de4d14fea1d589ad785e9730695a062c38eb" %}
{% endtab %}

{% tab title="🏁 高级示例" %}
{% file src="/files/6f6319774f9650dd7371595fdd7f4b132340ee1c" %}
{% endtab %}

{% tab title="🎾 自定义大厅" %}
{% file src="/files/5c46537fd89f053c32ecf3efd3b2146952739d1d" %}
{% endtab %}

{% tab title="🥛 回填展示" %}
{% file src="/files/a1aabfbd3ec2944a21bba8b2222625ed3d8fa759" %}
{% endtab %}

{% tab title="⚔️ 竞技游戏" %}
{% file src="/files/79c201866d4b9952d11b7cdb8bdbccc64ddb249f" %}
{% endtab %}

{% tab title="🤝 合作游戏" %}
{% file src="/files/4050e58da314beb3c7d257346e6489a434d2b1cc" %}
{% endtab %}

{% tab title="🎈 社交游戏" %}
{% file src="/files/e9faff81678425eb54e627ce7c766f61db0e39b6" %}
{% endtab %}
{% endtabs %}

将 API 规范导入到 [Scalar API Web 客户端](https://client.scalar.com/workspace/default/request/default) 注入的变量（Injected Variables） [Swagger 编辑器](https://editor.swagger.io/) 以查看详细信息。

### 速率限制

为了保护你的集群不超过其突发容量并崩溃，我们基于内部负载测试限制每秒请求数，使用 [匹配系统](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md#advanced-example) 配置。

<table><thead><tr><th>API 端点</th><th width="130">免费层</th><th width="130">爱好者层</th><th width="130">工作室层</th><th width="130">企业层</th></tr></thead><tbody><tr><td><strong>总限制</strong></td><td><strong>100</strong></td><td><strong>200</strong></td><td><strong>750</strong></td><td><strong>2,000</strong></td></tr><tr><td>创建部署</td><td>5</td><td>10</td><td>30</td><td>30</td></tr><tr><td>列出信标</td><td>10</td><td>20</td><td>75</td><td>200</td></tr><tr><td>创建组<br>+ 创建票证<br>+ 创建组票证</td><td>10</td><td>20</td><td>75</td><td>200</td></tr><tr><td>读取成员关系<br>+ 读取组<br>+ 读取票证</td><td>10</td><td>120</td><td>450</td><td>1,300</td></tr><tr><td>创建回填</td><td>5</td><td>10</td><td>37</td><td>100</td></tr></tbody></table>

速率限制以 **针对指定 API 端点集合的合并每秒请求数**.

{% hint style="warning" %}
如果你的游戏客户端在收到响应后不重试请求 `429 请求过多` **你的部署中可能会缺少玩家** 在短时突发和流量峰值期间。
{% endhint %}

#### 负载测试

在类似生产环境中进行负载测试会产生部署托管成本。请参见各层级对应的资源和价格 [我们的定价页面](https://edgegap.com/resources/pricing#matchmaker).

{% hint style="warning" %}
**使用** [**私有集群**](#private-cluster-tiers) **用于压力测试。** 免费实例严格仅限于开发测试。
{% endhint %}

在设计负载测试时， **请考虑真实的玩家行为模式**:

| 真实场景                                  | 不现实的流量模式                       |
| ------------------------------------- | ------------------------------ |
| ✅ 玩家逐步加入游戏，在数小时内逐渐提升请求/秒。             | ❌ 所有玩家协调一致，在完全相同的一秒内访问 API。    |
| ✅ 玩家在重试之间等待的时间逐步增加（例如 1s-5s-10s-10s）。 | ❌ 所有玩家在收到后立即重试 `429 请求过多`  响应。 |
| ✅ 大多数玩家会在较短时间内（10-60 秒）收到分配并停止轮询。     | ❌ 所有玩家在收到分配后仍会继续轮询一段固定时间。      |
| ✅ 大多数玩家在重新开始新会话之前会先完成当前游戏（需要一些时间）。    | ❌ 所有玩家在收到服务器分配后立即重新开始新的会话。     |
| ✅ 峰值流量每天持续约 6 小时，之后部分时区的流量会下降。        | ❌ 峰值流量全天 24 小时持续，所有玩家日夜不停地玩。   |

#### 负载下的行为

如果匹配器负载很高：

* 如果 CPU 受限，匹配速度可能会变慢，
* 如果匹配器内存耗尽，它会在不丢失票证信息的情况下重启，希望客户端实现指数退避，并将突发流量分散到更长时间内。

#### 跨源资源共享 (CORS)

对于托管在第三方分发平台上的 WebGL 游戏（例如 [itch.io](http://itch.io/)），从游戏客户端向匹配器发送任何请求都可能导致 [跨源资源共享](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) 策略违规。大多数现代网页浏览器会发送一个 [预检请求](https://developer.mozilla.org/en-US/docs/Glossary/Preflight_request) 以验证后端服务（匹配器）是否理解并接受来自你的游戏客户端的通信。

预检检查失败（出于安全原因这是默认情况）可能导致 [多个可能的 CORS 相关错误之一](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS/Errors/CORSMissingAllowOrigin)，最常见的是 `缺少 CORS 标头 'Access-Control-Allow-Origin'` .

要解决此错误，请添加 **`allowed_cors_origin`** 参数到你的配置中，以便：

* 将你的精确客户端托管域名列入白名单：

<details>

<summary>🍀 简单示例（具体域名示例）</summary>

<pre class="language-json"><code class="lang-json">{
  "version": "3.2.3",
  "allowed_cors_origins": [
    "https://dev.my-game-server.com",
    "https://prod.my-game-server.com"
  ],
  "profiles": {
      <a data-footnote-ref href="#user-content-fn-11">...</a>
  }
}
</code></pre>

</details>

* 或者将通配符域名（包括所有子域）列入白名单：

<details>

<summary>🍀 简单示例（通配符域名示例）</summary>

<pre class="language-json"><code class="lang-json">{
  "version": "3.2.3",
  "allowed_cors_origins": ["https://*.my-game-server.com"],
  "profiles": {
      <a data-footnote-ref href="#user-content-fn-11">...</a>
  }
}
</code></pre>

</details>

{% hint style="info" %}
**匹配器预检请求不需要凭据**，前提是域名配置正确。
{% endhint %}

### 服务器对服务器 <a href="#server-to-server-api" id="server-to-server-api"></a>

为匹配流程添加增强或自定义控制——使用我们的 [托管集群](https://docs.edgegap.com/zh/learn/advanced-features/managed-clusters.md) 或任何云 FaaS[^12] 计算平台，以实现以下任一目标：

* 附加敏感的玩家属性——例如作弊标记、技能评分或类似信息，
* 在游戏内提供团队和比赛上下文——在加载期间列出我的队友和对手，
* 限制特定边缘情况——例如任何时候每个玩家只允许 1 个组，
* 添加缓存或 API 速率限制——减少请求数量和匹配器负载，
* 自定义大厅-组集成——在匹配前创建不对称/基于角色的大堂。

{% hint style="success" %}
**包含参数 `player_ip`  使用成员的公网 IP 地址** 以确保尽可能低的玩家延迟并利用 [/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-1.-server-score-strategy-best-practice](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-1.-server-score-strategy-best-practice "mention").
{% endhint %}

{% hint style="info" %}
游戏客户端可以使用 [ipify.org](http://ipify.org/) 免费服务来查找其公网 IP。VPN 可能会掩盖公网 IP 地址。
{% endhint %}

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FzLfA3fEBgwaziGtp2yMO%2Fimage.png?alt=media&amp;token=3d551e74-4a60-47a6-9d79-a506f961663d" alt=""><figcaption><p>服务器到服务器匹配活动图</p></figcaption></figure>

## 🚨 故障排除

**你的成功是我们的首要任务。** 如果你想发送自定义请求、提出缺失的关键功能，或表达任何想法， [请在我们的社区 Discord 联系我们](https://discord.gg/MmJf8fWjnt).

<details>

<summary><code>应用配置对于配置文件 XYZ 无效。</code></summary>

* 我们找不到您的 [应用与版本](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md)，请验证 `应用`  值。

</details>

<details>

<summary><code>标签为 '2024.01.30-16.23.00-UTC' 的 Docker 镜像未被缓存。</code></summary>

[**🌟 升级到按需付费等级**](https://app.edgegap.com/user-settings?tab=memberships) **以解锁** [**具有缓存的即时部署**](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-1.-start-a-deployment)**.**

* 4GB 以上未缓存的镜像可能需要更长时间部署，导致 [/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-4.-deployment-error](https://docs.edgegap.com/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-4.-deployment-error "mention")。请考虑优化您的服务器镜像大小（[虚幻引擎](https://docs.edgegap.com/zh/unreal-engine.md#optimize-server-build-size) / [Unity](https://docs.edgegap.com/zh/unity.md#optimize-server-build-size)).
* 您仍然可以继续，但我们建议测试您的部署时间。

</details>

<details>

<summary>为什么我在尝试创建新的匹配器时会出错？</summary>

* 请阅读错误信息，可能是你拼错了标识符、规则或运算符。- 使用 [JSONLint](https://jsonlint.com/) 验证你的 JSON 格式，你可能漏了一个逗号或括号。- 通过以下方式联系我们： [我们的社区 Discord](https://discord.gg/MmJf8fWjnt) 寻求帮助，我们很乐意协助。🙏

</details>

<details>

<summary>为什么我的匹配器在 3 小时后会自动关闭？</summary>

* 免费层中的匹配器仅用于初步测试，并会在 3 小时后自动关闭。要继续测试，你可以 [重启你的匹配器](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list).
* 考虑升级到付费层以获得无限运行时间。

</details>

<details>

<summary>为什么我无法在我的账户上启动第二个部署？</summary>

* 在免费层中你只能运行 1 个并发部署。
* 请考虑升级到付费层以获得无限部署。

</details>

<details>

<summary>为什么我会在随机时间收到分配/部署，而不考虑 <code>player_count</code>?</summary>

* 你或其他团队成员可能在之前的测试会话中创建了未分配的票证。请 [重启你的匹配器](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list).

</details>

<details>

<summary>我的票证卡在 <code>SEARCHING</code> .</summary>

* 请确认你已根据你的配置创建了足够的匹配票证。

</details>

<details>

<summary>我的票证卡在在以下状态之间反复切换： <code>MATCH_FOUND</code>  和 <code>SEARCHING</code>  重复地。</summary>

* 免费层账户一次仅限 1 个部署。
* 请考虑升级，或停止当前部署以启动新的部署。

</details>

<details>

<summary>我的票证直接进入 <code>CANCELLED</code>.</summary>

* 你的票证已到达其过期时间。请创建新票证，或在配置中增加过期时间用于测试。

</details>

<details>

<summary>我收到 <code>HTTP 404 未找到</code> 在检查我的票证时。</summary>

* 你的票证要么被 DELETE 请求移除，要么已达到其移除期限（在票证过期后开始，由你的配置定义）。请重新创建新票证，或在配置中增加过期/移除期限用于测试。

</details>

<details>

<summary>我的匹配器显示错误，我该怎么办？</summary>

* 如果这是开发或测试实例，请先尝试重启你的匹配器。- 请通过以下方式报告任何问题： [我们的社区 Discord](https://discord.gg/MmJf8fWjnt).
* 如果此问题影响到了线上游戏，请创建一个 [紧急支持请求](https://edgegap.atlassian.net/servicedesk/customer/portal/3).

</details>

## 🔖 更新日志

请查看 [发行说明](https://docs.edgegap.com/zh/docs/release-notes.md) 以获取此服务的最新更新日志。

#### 语义化版本控制

我们的开发者工具和托管服务使用官方 [语义化版本控制](https://semver.org/)，用于指明哪些更新是✅安全的（次要版本、补丁），哪些可能包含⚠️破坏性更改（主版本）。

**一旦某个版本发布，它将永远不会被修改/更改**.

{% hint style="warning" %}
**要升级服务版本 - 停止、编辑、重启。** 快速重启不会应用版本更改。
{% endhint %}

你的配置文件将根据所使用的匹配器版本进行验证，请确保你的规则与该匹配器版本的能力相匹配。

[^1]: 示例值

[^2]: 游戏客户端加入大厅以获取匹配组 ID 并加入该组

[^3]: 完全限定域名

[^4]: 例如，若有 3 个空位 = \["3", "2", "1"]

[^5]: 将“2”替换为实际组成员数量

[^6]: 替换为您自己的应用名称

[^7]: 替换为您自己的应用版本

[^8]: 超过最大差值

[^9]: 超过最大延迟

[^10]: 互联网服务提供商（ISP）

[^11]: 查看其他示例

[^12]: [函数即服务](https://www.ibm.com/think/topics/faas)
