> 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/unreal-engine/top-down-sample.md).

# 俯视角示例

将 Unreal Engine 俯视角示例作为专用服务器部署到 Edgegap，这是独立开发者和小团队的实用起点。

推出一款带专用游戏服务器的 Unreal Engine 游戏，可能是一项艰巨的工程，无论是个人开发者还是经验丰富的中型团队都是如此。

幸运的是，Edgegap 平台让这一切变得简单，只需几分钟即可完成集成。之后，你的游戏就会上线，准备好连接全球玩家一起游玩。帮助你把宝贵的开发资源投入到你热爱的事情上——做出一款优秀的游戏。

{% hint style="success" %}
查看我们的 [Unreal Engine 示例项目](https://github.com/edgegap/game-sample-unreal-engine-topdown) 使用 Top-Down 示例作为灵感。
{% endhint %}

{% hint style="info" %}
请参见 [Unreal Engine](https://docs.edgegap.com/zh/unreal-engine.md) 设置为 **了解如何构建和自定义服务器**.
{% endhint %}

此示例展示：

* 将 Unreal Engine Top-Down 项目打包为 Linux 专用服务器，并带有一个 `Dockerfile` 用于 Edgegap，
* 通过控制台命令按 IP 连接客户端 `open <YOUR_DEPLOYMENT_IP:PORT>`,
* 可选 [匹配系统](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md) 与一个 **查找匹配** 按钮， [Ping 信标](https://docs.edgegap.com/zh/learn/bian-pai/ping-beacons.md) 延迟和服务器自停止，
* 使用 Epic Online Services 的可选游戏内语音聊天，见 [EOS 语音聊天](https://docs.edgegap.com/zh/docs/tools-and-integrations/eos-voice-chat.md).

这两个可选功能均 **默认禁用**。在你启用它们之前，游戏将按以下内容中所述方式运行： [Unreal Engine](https://docs.edgegap.com/zh/unreal-engine.md) 指南。

{% hint style="info" %}
随附的 `Dockerfile` 会以以下参数启动你的服务器： `-stdout -FullStdOutLogOutput`. **如果没有这些标志，stdout 会被缓冲，你的部署日志将一直为空。**
{% endhint %}

## 🎯 匹配（可选）

启用匹配后：

* 菜单地图会显示一个 **查找匹配** 按钮——它会测量玩家到 [ping 信标的延迟](https://docs.edgegap.com/zh/learn/bian-pai/ping-beacons.md)，用这些延迟创建一个匹配票据，等待匹配器在玩家附近启动一台服务器，然后连接到它，
* `FindMatch` 和 `CancelMatch` 也可作为控制台命令使用，而使用 `-FindMatch` 启动客户端时会自动入队，这在使用多个客户端测试时很有用，
* 由匹配器启动的服务器会在最后一名玩家离开 15 秒后自行停止部署；如果无人加入，则在 5 分钟后停止，因此空闲服务器不会继续计费。你手动部署或在本地运行的服务器永远不会被停止。

### 1. 打包并上传服务器

☑️ 将 Linux 专用服务器打包到 `Packaged/` （使用 Linux 交叉编译工具链从源码构建引擎）：

{% code collapsedlinecount="10" %}

```shell
<UE_ROOT>/Engine/Build/BatchFiles/RunUAT.bat BuildCookRun -project=<PATH>/MultiplayerGame/MultiplayerGame.uproject -noP4 -server -noclient -serverplatform=Linux -serverconfig=Development -build -cook -stage -pak -archive -archivedirectory=<PATH>/Packaged
```

{% endcode %}

{% hint style="success" %}
不想从源码构建 Unreal Engine？请查看 [从插件构建](https://docs.edgegap.com/zh/unreal-engine/geng-duo-gou-jian-fang-fa.md#build-from-plugin).
{% endhint %}

☑️ 使用随附的工具在仓库根目录构建你的镜像 `Dockerfile` 并将其推送到你的镜像仓库：

{% code collapsedlinecount="10" %}

```shell
docker build --platform linux/amd64 -t <REGISTRY>/<IMAGE>:<TAG> .
docker push <REGISTRY>/<IMAGE>:<TAG>
```

{% endcode %}

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

☑️ [创建一个应用版本](https://app.edgegap.com/application-management/applications/list) ，配合 [端口](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md#port-mapping) `7777`，协议 `UDP`，命名为 `gameport`.

✅ 现在可以继续下一步。

### 2. 创建匹配器

☑️ 将 `application.name` 和 `application.version` 将其添加到你的应用和版本中，位于 `matchmaker-config.json`.

☑️ [创建匹配器](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list) 基于此配置。它的 `休闲` 配置文件：

* 将 2 到 4 名玩家与同一个信标匹配，要求 ping 低于 150 毫秒且彼此相差不超过 100 毫秒，
* 等待 10 秒后，也接受单个玩家，且 ping 最高可达 250 毫秒（参见 [规则扩展](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong/matchmaker-in-depth.md#rule-expansion)),
* 如果 20 秒内未匹配成功，则取消票据——按 **查找匹配** 再次。

{% hint style="warning" %}
你的客户端会发送信标延迟，因为该配置文件包含 `延迟` 规则。如果你移除该规则， **将 `bSendBeaconLatencies=False` 在 `DefaultGame.ini`，否则匹配器会拒绝票据。**
{% endhint %}

✅ 现在可以继续下一步。

### 3. 将游戏指向你的匹配器

☑️ 在以下位置启用匹配： `MultiplayerGame/Config/UserGame.ini`，该文件被 git 忽略，并会覆盖 `DefaultGame.ini`，从而使你的配置值不进入版本控制。将 `YOUR_MATCHMAKER_URL` 和 `YOUR_MATCHMAKER_AUTH_TOKEN` 替换为你在匹配器仪表板页面上的 URL 和 Auth Token：

{% code collapsedlinecount="10" %}

```ini
[/Script/MultiplayerGame.EdgegapMatchmakerSubsystem]
bEnabled=True
MatchmakerUrl="YOUR_MATCHMAKER_URL"
AuthToken="YOUR_MATCHMAKER_AUTH_TOKEN"
```

{% endcode %}

{% hint style="warning" %}
**请将你的 URL 用引号括起来。** 如果不加引号，Unreal 的 ini 解析器会在此处截断： `//`.
{% endhint %}

{% hint style="danger" %}
**不要在游戏客户端中集成 Edgegap API 端点，因为你的 API 令牌会为你的账户提供无限访问权限。参见** [集成](https://docs.edgegap.com/zh/docs/api/ji-cheng.md) **以了解安全的面向客户端的 API 端点和功能。**
{% endhint %}

{% hint style="info" %}
匹配器 Auth Token 仅作用于你的匹配器，因此可以安全地随游戏客户端一起发布。
{% endhint %}

✅ 现在可以继续下一步。

### 4. 查找匹配

☑️ 启动两个客户端并按下 **查找匹配** ，并在 10 秒内在两个客户端都按下。它们会加入同一服务器。

🙌 祝贺你在 Edgegap 上完成了第一个匹配部署！

## 🎙️ 语音聊天（可选）

该示例还可以使用 Epic Online Services 的 EOS Voice 添加游戏内语音聊天。你的专用服务器充当可信服务器——它会检查每个玩家的 EOS 身份，选择他们的语音房间（每个匹配器队伍一个，或每场匹配一个），并将各自的房间令牌发给每位玩家。

请参见 [EOS 语音聊天](https://docs.edgegap.com/zh/docs/tools-and-integrations/eos-voice-chat.md) 以了解其工作原理以及如何进行设置。
