> 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/docs/sample-projects/unity-netcodes/playfab-mps-mirror.md).

# PlayFab MPS 镜像

PlayFab 的 Unity Mirror 多人游戏服务器示例，已迁移到 Edgegap：无需 GSDK，服务器按需在靠近玩家的位置启动，并在 Edgegap API 上提供一个分配器工具。

探索如何将游戏服务器从 **PlayFab 多人游戏服务器** (MPS) 迁移到 **Edgegap** 使用 [PlayFab MPS Mirror 示例](https://github.com/edgegap/backend-game-sample-unity-mirror-playfab-mps)，它是微软的 [MpsSamples](https://github.com/PlayFab/MpsSamples) 的一个分支，其中 `UnityMirror` 示例在 Edgegap 上运行。

此示例中没有匹配器。您可以通过一个小型命令行工具启动服务器，它相当于 PlayFab 的 `MpsAllocatorSample`，并将客户端连接到它输出的地址。玩家离开后，服务器会自行停止。

此示例展示：

* **Unity 2021.3.45f2** 服务器和客户端基于 **Mirror** （Telepathy，TCP 7777）；服务器使用 [Edgegap Unity 插件](https://github.com/edgegap/buildtool-unity-plugin),
* **不使用 GSDK**：服务器启动时在固定端口监听，无代理、心跳或就绪调用，
* **EdgegapAllocatorSample**：一个 .NET 控制台应用，用于在玩家附近启动服务器并等待其地址，列出版本和部署，以及停止部署，使用 [Edgegap API](https://docs.edgegap.com/zh/docs/api/zhuan-yong-fu-wu-qi.md),
* **服务器自行停止**：无人加入时，或所有人离开后，服务器会停止自己的部署。

{% hint style="info" %}
已于 2026 年 10 月 29 日在 Edgegap 上验证：分配器在数秒内于多伦多启动了一台服务器，两个 Windows 客户端成功连接，并且它们退出后服务器停止了自己的部署。
{% endhint %}

{% hint style="success" %}
使用 PlayFab 匹配功能？ [从 PlayFab 部署](https://docs.edgegap.com/zh/docs/tools-and-integrations/playfab-bridge.md) 会为每场比赛启动一台 Edgegap 服务器。
{% endhint %}

## 🗺️ 从 MPS 到 Edgegap

| PlayFab 多人游戏服务器                                   | Edgegap                                                                                                                                        |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| GSDK `启动`, `ReadyForPlayers`，监听于 `OnServerActive` | 启动时监听固定端口 7777（`EdgegapServer.cs`).                                                                                                            |
| 端口来源 `GetGameServerConnectionInfo`                | 应用版本上的固定内部端口。Edgegap 会将其映射到公共端口。                                                                                                               |
| `UpdateConnectedPlayers`                          | 不需要。服务器仅统计玩家数量，以确定何时停止。                                                                                                                        |
| `OnShutDownCallback`                              | Edgegap 发送 SIGTERM。Unity 退出时，玩家会收到相同的 `ShutdownMessage` 。                                                                                      |
| 构建、VM 大小、每个 VM 的服务器数量、待机服务器                       | 应用版本：镜像、每台服务器 0.5 vCPU / 1 GB、端口 `gameport` TCP 7777。不会预先配置任何资源。                                                                               |
| `RequestMultiplayerServer`                        | `POST /v2/deployments` 携带玩家的 IP 或坐标（`EdgegapAllocatorSample`).                                                                                 |
| 服务器会一直运行，直到 MPS 将其关闭                              | 服务器通过以下方式停止自己的部署 `ARBITRIUM_DELETE_URL`, [注入到每个部署中](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#injected-environment-variables). |

## ✔️ 准备工作

开始前，您需要：

* Unity `2021.3.45f2` 包含 **Linux 构建支持** 和 **Linux 专用服务器构建支持**,
* [Docker Desktop](https://www.docker.com/products/docker-desktop/)，正在运行，
* 该 [.NET SDK](https://dotnet.microsoft.com/download) 8 或更高版本，用于分配器，
* [示例项目](https://github.com/edgegap/backend-game-sample-unity-mirror-playfab-mps),
* 来自以下位置的 Edgegap API 令牌 [仪表板 → 用户设置 → 令牌](https://app.edgegap.com/user-settings?tab=tokens)。它仅保留在您的计算机或后端中，绝不放在游戏客户端内。

## ⚡ 部署并连接

### 1. 构建并上传服务器

打开 `UnityMirror/UnityServer` 在 Unity 中，然后选择 **工具 → Edgegap 服务器托管**:

1. **使用 Edgegap 登录**，然后 **构建服务器**.
2. **使用 Docker 容器化**：镜像名称 `mps-unity-mirror`，镜像标签留空（插件使用当前 UTC 时间）。
3. 可选的本地检查：运行参数 `-p 7777:7777/tcp`，然后 **部署本地容器**.
4. **上传到 Edgegap**：应用程序 `mps-unity-mirror`，然后 **上传镜像并创建应用版本**。在版本表单中，设置一个名为 `gameport`, 7777, **TCP**的端口、0.5 vCPU / 1 GB，以及 60 分钟的最长持续时间。如果表单要求提供镜像仓库凭据，请使用仪表板中的用户名和令牌，位置为 **容器镜像仓库** 页面。

从命令行执行，用于 CI 或脚本化测试：

{% code collapsedlinecount="10" %}

```bash
"<Unity>" -batchmode -projectPath UnityMirror/UnityServer -executeMethod EdgegapPluginBuild.BuildServer -logFile build-server.log
```

{% endcode %}

### 2. 启动服务器

使用您的令牌、应用程序和版本运行分配器：

{% code collapsedlinecount="10" %}

```bash
cd EdgegapAllocatorSample
export EDGEGAP_API_TOKEN="token xxxxxxxx" EDGEGAP_APP=mps-unity-mirror EDGEGAP_VERSION=<version name>
dotnet run -- deploy <您的公共 IP>
```

{% endcode %}

服务器就绪后，它会输出客户端参数，例如 `-server 1a2b3c.pr.edgegap.net:31202`。不带参数时， `dotnet run` 会打开一个菜单，用于列出版本和部署，或停止某个部署。

### 3. 连接客户端

构建 `UnityMirror/UnityClient` 以用于 Windows，然后使用以下地址启动它：

{% code collapsedlinecount="10" %}

```bash
"<Unity>" -batchmode -quit -projectPath UnityMirror/UnityClient -buildTarget Win64 -buildWindows64Player Builds/Client/win64/Client.exe
UnityMirror/UnityClient/Builds/Client/win64/Client.exe -server <host>:<port>
```

{% endcode %}

退出客户端：最后一名玩家离开 30 秒后，或无人加入时启动后 120 秒，服务器会停止其部署。

{% hint style="info" %}
免费套餐一次只能运行一个部署：测试前请停止其他部署。
{% endhint %}

## 🔧 已知限制

* **没有匹配器。** 服务器从分配器或仪表板启动。对于玩家，请从您的后端启动服务器，或者使用 [从 PlayFab 部署](https://docs.edgegap.com/zh/docs/tools-and-integrations/playfab-bridge.md) 或 [Edgegap 匹配器](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md).
* **服务器不会检查连接者的身份。** 在生产环境中，请将预期玩家作为环境变量传递给部署，并拒绝其他玩家。
