> 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/photon-fusion-2-br200.md).

# Photon Fusion 2 BR200

在 Edgegap 专用服务器上托管 Photon 的 BR200 大逃杀示例（Photon Fusion 2），每场比赛部署一台服务器，使用 Edgegap BR200 套件。

了解如何使用以下技巧在 Edgegap 上托管 Unity 项目 [BR200 大逃杀示例](https://assetstore.unity.com/packages/templates/packs/br200-battle-royale-multiplayer-photon-fusion-226753)，一款最多支持 200 名玩家的大逃杀游戏。

{% hint style="info" %}
我们的 [Edgegap BR200 套件](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200) 是一组你复制到 BR200 项目中的文件。它 **不会修改或包含任何受 Photon 许可的代码**，因此你可以在 Unity Asset Store 中按你自己的许可获取 BR200。
{% endhint %}

此示例展示：

* **将 BR200 作为专用服务器** ——每场比赛对应一次部署， [部署在靠近玩家的位置](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#server-placement).
* **无需修改 BR200 代码** ——启动脚本会映射 [注入的变量](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#injected-environment-variables) 到 BR200 自身的命令行选项。
* **直接连接** ——服务器绑定 `0.0.0.0`，因此客户端直接连接，而不是通过 Photon 中继。
* **Photon 区域选择** ——服务器会选择离其部署最近的 Photon 区域。
* **服务器自停止** ——比赛结束时服务器会停止其自身部署。

{% hint style="success" %}
参见 [Photon Fusion 2](https://docs.edgegap.com/zh/docs/sample-projects/unity-netcodes/photon-fusion-2-on-edgegap.md) 以获取 **Edgegap 上 Photon Fusion 2 的通用指南**。查看该套件的 [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200) 以查看完整的文件列表、运行时变量和测试结果。
{% endhint %}

## ✔️ 准备工作

开始之前，你需要：

* [BR200 大逃杀（Photon Fusion）](https://assetstore.unity.com/packages/templates/packs/br200-battle-royale-multiplayer-photon-fusion-226753) ——下载并在受支持的 Unity 版本中打开。
* [Edgegap BR200 套件](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200).
* Photon Fusion App ID——可在你的 [Photon 控制台](https://dashboard.photonengine.com).

{% hint style="info" %}
打开你的项目，并按照以下内容安装服务器构建工具： [Unity](https://docs.edgegap.com/zh/unity.md) 准备步骤。
{% endhint %}

此套件已在 Windows 上使用 BR200 2.1.0、Fusion 2.1.1（build 2177）和 Unity 6000.3.11f1 测试。

{% hint style="warning" %}
你的服务器 **必须是 IL2CPP 构建** （BR200 的默认设置）。Mono 服务器在处理 BR200 的 RPC 时会失败并出现 `MethodAccessException` ，且玩家永远无法获得角色。
{% endhint %}

☑️ 要在 Windows 上构建 Linux IL2CPP，请在 Window / Package Manager / + / Add package by name 中添加 Unity 的 Linux toolchain：

* Unity 6000.3 及更高版本： `com.unity.toolchain.win-x86_64-linux` 以及 `com.unity.sdk.linux-x86_64`,
* 更早版本： `com.unity.toolchain.win-x86_64-linux-x86_64`.

## ⚡ 部署并连接

### 1. 将套件添加到你的项目

☑️ 复制 `Assets/EdgegapBR200`, `edgegap/`, `scripts/`, `.dockerignore` 以及 `.gitattributes` 将套件中的内容复制到你的 BR200 项目根目录中，放在 `Assets/`.

☑️ 在 Tools / Fusion / Realtime Settings 中粘贴你的 Fusion App ID，并记下你的 **App Version**.

{% hint style="info" %}
客户端和服务器 **必须使用相同的 App ID、App Version 和 Photon 区域**，否则它们无法互相找到。
{% endhint %}

☑️ 将 **Peer Mode** 设为 `Single` ，在 Tools / Fusion / Network Project Config 中。

☑️ 运行 Tools / Edgegap BR200 / Check Project，并修复报告的任何问题。

你无需编辑 Loader 场景或脚本。服务器模式、地址、端口、会话和区域会通过命令行传入。

{% hint style="info" %}
如果你的控制台显示 `只有在使用 /unsafe 编译时，unsafe 代码才可能出现` 如果在首次导入后立即出现，请关闭并重新打开你的项目。
{% endhint %}

✅ 现在你可以继续下一步。

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

☑️ 开始前，你需要 [在 Edgegap 创建一个免费账户](https://app.edgegap.com/auth/register)。无需信用卡。

☑️ 使用 Edgegap 插件或通过终端构建并上传你的服务器：

{% tabs %}
{% tab title="Edgegap 插件（推荐）" %}
☑️ 运行 Tools / Edgegap BR200 / Build Linux Server。它会检查你的项目，并在需要时启用 *Allow 'unsafe' Code* ，并构建 Linux **服务器** 子目标为 `Builds/EdgegapServer`.

☑️ 打开 Tools / Edgegap Server Hosting。在步骤 **3. 将你的服务器容器化**，点击 **Dockerfile 路径** 并选择 `edgegap/Dockerfile`。保持 **相对构建路径** 为 `Builds/EdgegapServer`，然后进行容器化并上传。

☑️ 保持端口 `7777` / UDP，当插件创建你的应用版本时。
{% endtab %}

{% tab title="终端（适用于 Agents）" %}
☑️ 找到你的 [容器仓库](https://docs.edgegap.com/zh/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) 项目名称和凭据，然后使用以下命令登录： `docker login registry.edgegap.com`.

☑️ 构建你的服务器，然后打包并推送镜像（Windows 上可使用 Git Bash）：

{% code collapsedlinecount="10" %}

```bash
scripts/build-server.sh
scripts/package.sh registry.edgegap.com/<your-registry-project>/br200
```

{% endcode %}

`package.sh` 会打印它推送的新标签。

☑️ [创建一个应用](https://app.edgegap.com/application-management/applications/list) 并为你的镜像创建一个版本。你也可以使用该套件的 `examples/app-version.json` 搭配 `POST /v1/app/{app}/version`.
{% endtab %}
{% endtabs %}

{% hint style="danger" %}
:x: **不要覆盖现有标签，也不要使用 `latest`  标签** ——这会部署过时的缓存。\
:white\_check\_mark: **应该始终递增版本标签** 并部署新的构建版本。
{% endhint %}

☑️ 使用以下内容配置你的应用版本：

* [端口](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md#port-mapping) `7777`，协议 **UDP**，命名为 `gameport`,
* [重启策略](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md#safety-guardrails) `never` ——比赛结束且服务器退出时，部署结束，
* 最大持续时间略高于你最长的比赛（示例中为 60 分钟），
* 资源先设为 1 vCPU 和 2 GB。

✅ 现在你可以继续下一步。

### 3. 本地测试

☑️ 使用与真实部署相同的注入变量在本地运行你的镜像：

{% code collapsedlinecount="10" %}

```bash
scripts/run-local.sh eu
```

{% endcode %}

☑️ 使用以下方式，从两个编辑器或两个客户端构建加入打印出的会话名： **选项 B** ，在下一步中使用该会话名和你传入的区域。

{% hint style="info" %}
本地客户端连接 **中继**，因为同一台机器上的客户端无法直接访问 Docker Desktop 的 NAT 地址。在 Edgegap 上，同一个镜像连接 **直接**.
{% endhint %}

✅ 现在你可以继续下一步。

### 4. 部署并连接

☑️ 从插件启动部署， [控制台](https://app.edgegap.com/deployment-management/deployments/list)，或 `POST /v2/deployments` 使用该套件的 `examples/deploy-request.json`。将你玩家的公网 IP 传给 [以便在靠近他们的位置部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#server-placement).

你的部署 FQDN（例如 `0a1b2c3d4e5f.pr.edgegap.net`）也是 BR200 的会话名和服务器名。最初的服务器日志行会显示绑定地址、公共地址以及所选的 Photon 区域：

{% code collapsedlinecount="10" %}

```
[edgegap-br200] deployment=0a1b2c3d4e5f session=0a1b2c3d4e5f.pr.edgegap.net bind=0.0.0.0:7777/udp public=203.0.113.10:31502
[edgegap-br200] photon_region=eu (nearest to Frankfurt (50.11, 8.68)) max_players=200 mode=default scene=default
```

{% endcode %}

☑️ 使用以下选项之一连接客户端：

* **选项 A：菜单** ——打开 `TPSBR/Scenes/Menu`，按 ▶️ Play，选择相同的区域并从列表中加入服务器，
* **选项 B：Standalone Manager 自动加入** ——打开设置为 Loader 的 **Batch Mode Scene**。在 **Standalone Manager**中，将 Game Mode 设为 `Client`，将 Server Name 和 Session Name 设为你的 FQDN，将 Region 设为服务器所在区域，然后按 ▶️ Play。

{% hint style="warning" %}
BR200 会启动一个 **服务器启动时 120 秒等待计时器**。计时结束后加入的玩家将视为被淘汰。等你的队伍准备好后再进行部署，并在部署变为 Ready 后立即连接客户端。
{% endhint %}

☑️ 按下 **Tab** 在已连接的客户端中。覆盖层左上角会显示 **CT** （Connection Type），应该显示为 **直接**.

🙌 祝贺你在 Edgegap 上完成首次部署！

## 🔄 比赛生命周期

1. Edgegap 启动部署并 [注入 `ARBITRIUM_*` 变量](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#injected-environment-variables).
2. `edgegap/start-server.sh` 将它们转换为 BR200 的命令行选项。它始终传递 `-dedicatedServer -ip 0.0.0.0 -port 7777`，并将会话命名为部署的 FQDN，同时选择最靠近部署的 Photon 区域。
3. 客户端会在相同的 Photon 区域中找到服务器并直接连接。
4. 当 BR200 在比赛结束时退出，脚本会调用 `ARBITRIUM_DELETE_URL` 以停止部署，因此比赛结束后会立即停止计费。当 Edgegap 停止部署时，脚本会将停止信号转发给 BR200。

参见 [部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md) 以了解更多。

## ⚙️ 环境变量

Edgegap [注入 `ARBITRIUM_*` 变量](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#injected-environment-variables) 会自动处理。请设置这些 `BR200_*` 变量设置在你的应用版本（每场比赛）或部署请求（仅本场比赛）上：

| 变量                       | 默认值                                                                     | BR200 选项                                         |
| ------------------------ | ----------------------------------------------------------------------- | ------------------------------------------------ |
| `BR200_SESSION`          | 部署 FQDN， `<ARBITRIUM_REQUEST_ID>.pr.edgegap.net`                        | `-sessionName`                                   |
| `BR200_SERVER_NAME`      | 与会话相同                                                                   | `-serverName`                                    |
| `BR200_REGION`           | `auto`：距离部署最近的 Photon 区域。 `best`：让 Fusion 进行 ping 测试。或者使用类似以下的代码： `eu`. | `-region`                                        |
| `BR200_REGION_ALLOWLIST` | 所有 Photon 区域。以逗号分隔的代码， `auto` 可从中选择。                                    |                                                  |
| `BR200_MAX_PLAYERS`      | `200` （1 到 200）                                                         | `-maxPlayers`                                    |
| `BR200_MODE`             | BR200 的默认值。 `battleRoyale`, `deathmatch` 或 `elimination`.               | `-battleRoyale` / `-deathmatch` / `-elimination` |
| `BR200_SCENE`            | Loader 的 Batch Mode Scene                                               | `-scene`                                         |
| `BR200_LOBBY`            | BR200 的默认值                                                              | `-lobby`                                         |
| `BR200_FPS`              | Fusion 的 tick 速率                                                        | `-fps`                                           |
| `BR200_RECORD`           | `false`. `true` 将会话统计写入 `/data`.                                        | `-recordSession -dataPath /data`                 |
| `BR200_EXTRA_ARGS`       | 无。其他选项，会附加在最后。                                                          |                                                  |
| `BR200_SELF_STOP`        | `true`。当 BR200 退出时停止部署。                                                 |                                                  |

如果你的客户端使用固定的 Photon 区域，或者你的 Photon 应用只允许某些区域，请在 `BR200_REGION` 部署上设置，或限制 `auto` 搭配 `BR200_REGION_ALLOWLIST`.

## 🔌 直接连接

BR200 的 `IP` 以及 `端口` 设置服务器 **绑定** 到的地址。该套件会绑定 `0.0.0.0:7777`，Fusion 会自行找到部署的公共地址，客户端连接 **直接** ——即使 Edgegap 为玩家分配了不同的 [外部端口](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md#port-mapping).

| 服务器 `IP`        | 结果                                                          |
| --------------- | ----------------------------------------------------------- |
| `0.0.0.0` （本套件） | **直接** 在 Edgegap 上。                                         |
| `127.0.0.1`     | 服务器已启动，但客户端通过 **中继** Photon 进行连接，这会增加延迟。容器外部的任何内容都无法访问回环地址。 |
| 部署的公网 IP        | 服务器 **无法启动** (`绑定套接字失败`），因为容器不拥有该地址。客户端会收到 `GameNotFound`.  |

{% hint style="warning" %}
留空 `IP` 或 `0.0.0.0`. **不要将其设置为 `127.0.0.1` 或你的部署公网 IP。**
{% endhint %}

## 🚨 故障排查

<details>

<summary><code>MethodAccessException ... CheckInvokeRpc</code> 在服务器日志中</summary>

* 你的服务器是用 Mono 构建的。请使用 IL2CPP 重新构建。

</details>

<details>

<summary><code>未找到主机平台的 Toolchain</code> 或 <code>未找到 Linux sysroot</code></summary>

* 缺少 Linux toolchain 包，参见 [准备工作](#preparation).

</details>

<details>

<summary>客户端收到 <code>GameNotFound</code></summary>

* 客户端与服务器之间的 App Version 或 Photon 区域不同。请与服务器的 `photon_region=` 日志行。

</details>

<details>

<summary>客户端收到 <code>InvalidAuthentication</code></summary>

* 你的 Fusion App ID 在构建中错误或缺失。

</details>

<details>

<summary>Tab 覆盖层显示 CT Relayed</summary>

* 你的服务器绑定 `127.0.0.1`，参见 [直接连接](#direct-connection).

</details>

<details>

<summary>服务器未列在菜单中</summary>

* 客户端区域与服务器不同，或者 120 秒等待计时器已经结束。

</details>

<details>

<summary>部署立即退出，并出现 <code>错误：...</code></summary>

* 一个 `BR200_*` 值无效。日志行会说明是哪一个。

</details>

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