Photon Fusion 2 简易 FPS
在 Edgegap 专用服务器上托管 Photon 的简易 FPS 示例(Photon Fusion 2),每场比赛部署一台服务器,使用 Edgegap Simple FPS 套件。
了解如何使用以下技巧在 Edgegap 上托管 Unity 项目 Simple FPS 多人示例. 玩家从示例的 派对 菜单中输入部署地址和 Photon 区域。
此示例展示:
作为专用服务器的 Simple FPS ——每场比赛对应一次部署, 部署在靠近玩家的位置.
派对菜单加入 - 加入卡片会接受你的部署 FQDN 和 Photon 区域代码, 创建游戏 保持不变。
直接连接 ——服务器绑定
0.0.0.0在端口7777,因此客户端可直接连接。双方共用一个项目 - 服务器和客户端构建共用相同的场景列表。
服务器自动停止 - 当服务器进程自行退出时,启动脚本会停止该部署。
✔️ 准备工作
开始之前,你需要:
Simple FPS 多人游戏(Photon Fusion) - 下载并导入到一个新的 Unity 项目中。
此示例自带其项目设置。
Unity 6000.3,带有下面的 Linux 构建模块,以及 Windows 构建支持(IL2CPP) 用于客户端(需要 Visual Studio 的 C++ 工作负载),
Photon Fusion App ID——可在你的 Photon 控制台.
此套件已在 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。
☑️ 将 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,当插件创建你的应用版本时。
第一次 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> 然后像下一步那样,使用该会话和区域从客户端加入。
✅ 现在你可以继续下一步。
4. 部署并连接
☑️ 从插件启动部署, 控制面板,或 POST /v2/deployments。将你玩家的公网 IP 传给 以便在靠近他们的位置部署.
☑️ 查找 服务器已启动:session=<fqdn> photon_region=<code> ,在你的部署日志中。
☑️ 使用以下命令构建客户端: scripts/build.sh client (或你平常的 Windows 构建),启动它并点击 派对菜单 在主菜单中。
☑️ 在加入卡片上,输入你的部署 FQDN(例如 f68e011bfb01.pr.edgegap.net)到代码字段中,并输入区域代码(例如 cae)到 区域 字段中,然后点击 加入.
🙌 祝贺你在 Edgegap 上完成首次部署!
🔄 比赛生命周期
服务器构建会跳过 Startup 菜单并加载 Deathmatch。
EdgegapFusionBootstrap在以下位置启动 Fusion 服务器ARBITRIUM_PORT_GAMEPORT_INTERNAL(7777(默认情况下),绑定到0.0.0.0,并将会话名称设为部署 FQDN,<ARBITRIUM_REQUEST_ID>.pr.edgegap.net.服务器会记录会话名称和 Photon 区域,玩家将其输入到派对菜单的加入卡片中,并直接连接到部署。
当服务器进程自行退出时,
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覆盖尚未测试。
🚨 故障排查
最后更新于
这有帮助吗?

