For the complete documentation index, see llms.txt. This page is also available as Markdown.

Photon Fusion 2 简易 FPS

在 Edgegap 专用服务器上托管 Photon 的简易 FPS 示例(Photon Fusion 2),每场比赛部署一台服务器,使用 Edgegap Simple FPS 套件。

了解如何使用以下技巧在 Edgegap 上托管 Unity 项目 Simple FPS 多人示例. 玩家从示例的 派对 菜单中输入部署地址和 Photon 区域。

我们的 Edgegap Simple FPS 套件 是一组要复制到你的 Simple FPS 项目中的文件。它 不会修改或包含任何受 Photon 许可的代码,因此你会在 Unity Asset Store 下以你自己的许可证获得 Simple FPS。

此示例展示:

  • 作为专用服务器的 Simple FPS ——每场比赛对应一次部署, 部署在靠近玩家的位置.

  • 派对菜单加入 - 加入卡片会接受你的部署 FQDN 和 Photon 区域代码, 创建游戏 保持不变。

  • 直接连接 ——服务器绑定 0.0.0.0 在端口 7777,因此客户端可直接连接。

  • 双方共用一个项目 - 服务器和客户端构建共用相同的场景列表。

  • 服务器自动停止 - 当服务器进程自行退出时,启动脚本会停止该部署。

✔️ 准备工作

开始之前,你需要:

打开你的项目,并按照以下内容安装服务器构建工具: Unity 准备步骤。

此套件已在 Windows 上使用 Simple FPS 2.1.1、Fusion 2.1.1(构建 2177)和 Unity 6000.3.11f1 进行了测试。

☑️ 要在 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/EdgegapSimpleFPS, edgegap/, scripts/, .dockerignore 以及 .gitattributes 从套件复制到你的项目根目录,放在 Assets/.

☑️ 将你的 Fusion App ID 粘贴到 Tools / Fusion / Realtime Settings。

客户端和服务器 必须使用相同的 App ID、App Version 和 Photon 区域,否则它们无法互相找到。

☑️ 将 Peer Mode 变为 Single ,在 Tools / Fusion / Network Project Config 中。

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

☑️ 运行 Tools / Edgegap Simple FPS / Set Up Project。它只会更改场景和构建设置,再次运行也很安全:

  • Deathmatch: FusionBootstrap 变为 EdgegapFusionBootstrap (保留其设置),并且 Start Mode 变为 用户界面,

  • Startup:派对菜单的 FusionMenuUIParty 变为 EdgegapPartyMenu (为此已解包菜单预制件实例),

  • 加入卡片的代码字段最多可接受 30 个字符(字母、数字和点),并新增一个 区域 字段位于其旁边,

  • 构建配置文件设置为 Startup (0),然后是 Deathmatch (1)。

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

2. 构建并上传服务器

☑️ 开始前,你需要 在 Edgegap 创建一个免费账户。无需信用卡。

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

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

☑️ 保持端口 7777 / UDP,当插件创建你的应用版本时。

☑️ 找到你的 容器仓库 项目名称和凭据,然后使用以下命令登录: docker login registry.edgegap.com.

☑️ 构建你的服务器,然后打包并推送镜像(Windows 上可使用 Git Bash):

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

☑️ 创建一个应用 并为你的镜像创建一个版本。你也可以使用该套件的 examples/app-version.json 搭配 POST /v1/app/{app}/version.

第一次 IL2CPP 服务器构建大约需要 13 分钟。

你也可以在编辑器中通过 Tools / Edgegap Simple FPS / Build Linux Server 进行构建,它会将相同的输出构建到 Builds/EdgegapServer。请参见 Unity 以了解更多关于构建 Unity 服务器的信息。

☑️ 创建一个应用 以及一个带有以下内容的版本:

  • 你的镜像和标签,

  • 你的容器仓库用户名和令牌,

  • 启动时分配 1 vCPU 和 2 GB 资源,

  • 端口 7777,协议 UDP,并关闭端口检查。

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

3. 本地测试

☑️ 构建本地镜像,并使用 Edgegap 会注入的变量运行它:

☑️ 找到日志行 [edgegap-simplefps] 服务器已启动:session=f68e011bfb01.pr.edgegap.net photon_region=<code> 然后像下一步那样,使用该会话和区域从客户端加入。

本地客户端连接 中继,因为同一台机器上的客户端无法直接访问 Docker Desktop 的 NAT 地址。在 Edgegap 上,同一个镜像连接 直接.

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

4. 部署并连接

☑️ 从插件启动部署, 控制面板,或 POST /v2/deployments。将你玩家的公网 IP 传给 以便在靠近他们的位置部署.

☑️ 查找 服务器已启动:session=<fqdn> photon_region=<code> ,在你的部署日志中。

☑️ 使用以下命令构建客户端: scripts/build.sh client (或你平常的 Windows 构建),启动它并点击 派对菜单 在主菜单中。

☑️ 在加入卡片上,输入你的部署 FQDN(例如 f68e011bfb01.pr.edgegap.net)到代码字段中,并输入区域代码(例如 cae)到 区域 字段中,然后点击 加入.

如果你的客户端无法连接,最可能是区域与服务器日志不匹配。

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

🔄 比赛生命周期

  1. 服务器构建会跳过 Startup 菜单并加载 Deathmatch。

  2. EdgegapFusionBootstrap 在以下位置启动 Fusion 服务器 ARBITRIUM_PORT_GAMEPORT_INTERNAL (7777 (默认情况下),绑定到 0.0.0.0,并将会话名称设为部署 FQDN, <ARBITRIUM_REQUEST_ID>.pr.edgegap.net.

  3. 服务器会记录会话名称和 Photon 区域,玩家将其输入到派对菜单的加入卡片中,并直接连接到部署。

  4. 当服务器进程自行退出时, edgegap/start-server.sh 调用 ARBITRIUM_DELETE_URL 以停止部署。

启动脚本从不打印环境,因此 你的删除令牌不会出现在日志中.

参见 部署 以了解更多。

⚙️ 环境变量

变量
由以下项设置
效果

ARBITRIUM_REQUEST_ID

Edgegap

会话名称变为 <request id>.pr.edgegap.net,即部署的 FQDN。

ARBITRIUM_PORT_GAMEPORT_INTERNAL

Edgegap

服务器绑定的 UDP 端口(7777 默认情况下)。它绑定到 0.0.0.0,因此客户端可直接连接。

PHOTON_REGION

你(版本或部署)

固定的 Photon 区域,例如 us。未设置时,服务器会使用其运行位置下延迟最低的区域。此覆盖目前尚未测试。

ARBITRIUM_DELETE_URL, ARBITRIUM_DELETE_TOKEN

Edgegap

当服务器进程自行退出时,启动脚本会使用它们来停止部署。

参见 注入的变量 以了解更多。

🔌 直接连接

Simple FPS 的 IP 以及 端口 设置服务器 绑定 到的地址。该套件会绑定 0.0.0.0:7777,Fusion 会自行找到部署的公共地址,客户端连接 直接 ——即使 Edgegap 为玩家分配了不同的 外部端口.

服务器 IP

结果

0.0.0.0 (本套件)

直接 在 Edgegap 上。

127.0.0.1

服务器已启动,但客户端通过 中继 Photon 进行连接,这会增加延迟。容器外部的任何内容都无法访问回环地址。

部署的公网 IP

服务器 无法启动 (绑定套接字失败),因为容器不拥有该地址。客户端会收到 GameNotFound.

🎬 服务器场景

Fusion 通过以下方式告诉客户端要加载哪个场景: 构建索引。仅使用 Deathmatch 构建的服务器会让 Deathmatch 位于索引 0,而客户端则将 Startup 放在索引 0。这样客户端就永远找不到游戏对象并抛出 NullReferenceException 位于 Player.FixedUpdateNetwork ,每个 tick 都会这样。因此两个构建都使用 Startup (0) 和 Deathmatch (1),而服务器会跳过 Startup。

出于同样的原因,服务器会将 Deathmatch 标记为 加载时激活,就像示例自己的主机一样。没有它,客户端会加载 Deathmatch 但保持 Startup 活跃,并出现同样的异常。

⚠️ 已知问题

  • 将一局比赛玩到结束,以及服务器是否会在比赛后退出,目前尚未测试——请参阅套件的 README.

  • PHOTON_REGION 覆盖尚未测试。

🚨 故障排查

MethodAccessException ... CheckInvokeRpc 在服务器日志中
  • 你的服务器是用 Mono 构建的。请使用 IL2CPP 重新构建。

未找到主机平台的 Toolchain 或 未找到 Linux sysroot
客户端收到 GameNotFound
  • 客户端与服务器之间的 App Version 或 Photon 区域不同。请与服务器的 photon_region= 日志行。

客户端收到 InvalidAuthentication
  • 你的 Fusion App ID 在构建中错误或缺失。

Tab 覆盖层显示 CT Relayed

最后更新于

这有帮助吗?