Photon Fusion 1

在 Arbitrium 上的 Photon Fusion

本指南将帮助您为使用以下内容的 Unity 项目在 Edgegap 上创建无头服务器 Photon Fusion 作为其联网解决方案。

我们将使用示例项目 来自 Photon Fusion 的 Tanknarok 作为示例。

因为当 Edgegap 知道所有玩家的位置信息时（以便选择最佳位置的服务器）效果最佳，Tanknarok 游戏将首先以客户端托管模式启动，然后在所有玩家加入后切换到 Edgegap 服务器。这是因为 Tanknarok 在比赛开始前有一个可玩的大厅，玩家可以随意加入和离开。所以逻辑流程如下：

1. 玩家使用相同的房间通过连接 AutoHostOrClient 模式。该模式会自动选择房间中的第一个玩家作为主机。

2. 所有玩家在加入时将他们的 IP 地址发送给主机。

3. 一旦玩家准备就绪，主机会使用这些 IP 地址启动一个 Edgegap 服务器版本的游戏，并使用随机化的房间代码（使用 guid）。

4. 当主机看到 Edgegap 实例已完成部署时，会将新的房间代码告知其他玩家。

5. 包括主机在内的所有玩家断开当前房间连接，并以客户端模式重新连接到由 Edgegap 服务器托管的新房间。

6. 当 Edgegap 服务器看到所有预期玩家都已加入时，它开始比赛。

7. 当 Edgegap 服务器看到所有人都已离开比赛时，它会自行关闭。

账户设置

要运行此应用，您需要同时拥有 Photon 帐户和 Edgegap 帐户。首先，您需要在 Photon 仪表板上创建一个 Fusion 应用并在 PhotonAppSettings 脚本化对象文件中设置应用 ID。然后，您需要在仪表板上添加一个应用并创建一个 API 令牌。您将使用这些在 EdgegapConfig 脚本化对象文件中设置应用名称、版本和 API 令牌。

在创建 Edgegap 应用时，该程序需要 512 CPU 单位和 512 MB 内存。

还有两个插件可以帮助开发：用于更好 JSON 序列化的 Newtonsoft Json 和 ParrelSync 用于更方便地在多个 Unity 编辑器中测试。

第 1 步：服务器模式设置

您可以在获取修改后的 Tanknarok 项目 GitHub。您还需要将 Photon Fusion SDK 导入到项目中。

Photon Fusion 的 Tanknarok 项目需要稍作修改以用作服务器。这主要涉及自动启动比赛并设置模式。

1. 已修改的 GameLauncher.cs 以在启动时使用启动 GameMode.Server.

2. 已修改的 FusionLauncher.cs 来调用 _spawnWorldCallback 一旦游戏运行而不是依赖于 InstantiatePlayer （因为服务器不会实例化玩家）。

3. 如果是服务器则跳过大厅场景，在所有玩家加入后直接进入比赛。

这已在我们可用的修改过的 Tanknarok 项目中完成， GitHub.

Dockerfile

Docker 文件非常基础。我们只是使用一个 ubuntu 基础镜像，复制已编译的 Linux 服务器构建，设置文件权限，然后运行它。

第 2 步：第一个客户端

初始客户端承担主机和管理 Edgegap 服务器的角色。它通过 EdgegapManager.cs 文件来完成，该文件又使用 EdgegapAPIInterface.cs 文件，该文件封装了与 Edgegap 交互的大部分功能。

在 GameManager.cs, OnAllPlayersReady 主机的函数将部署一个 Edgegap 服务器而不是直接开始比赛。它根据所有玩家的 IP 地址来完成此操作。Unity 协程允许这些操作异步发生。Deploy 方法接受一个回调函数，该函数会接收服务器将使用的新房间名称。一个 Photon RPC 函数会发送以通知所有客户端切换。

    if (EdgegapManager.EdgegapPreServerMode)
    {
        // 如果是主机，启动新的 edgegap 服务器
        // 一旦服务器准备就绪，连接到它

        FindObjectOfType<GameLauncher>().ShowMatchStartingUI();

        if (Object.HasStateAuthority)
        {
            string[] ips = PlayerManager.allPlayers.Select(p => p.ipAddress).ToArray();
            StartCoroutine(EdgegapManager.Instance.Deploy(ips, RpcOnEdgegapServerReady));
        }
    }
    else
    {
        LoadLevel(_levelManager.GetRandomLevelIndex(), -1);
    }

切换发生在名为的空场景中 TransferringScene.

在 EdgegapManager 中，会创建一个随机化的房间代码，并将其连同玩家数量作为环境变量通过部署 API 传递给新创建的实例。这与 status API 调用结合，每秒开始检查实例何时完成部署。您也可以使用 webhook 选项时，动态注入环境变量。

    /// <summary>
    /// 调用 Edgegap API 来部署服务器
    /// </summary>
    /// <param name="clientIpList">客户端 IP 地址列表</param>
    /// <param name="OnDeployed">带有会话名称作为参数的回调方法</param>
    public IEnumerator Deploy(string[] clientIpList, Action<string> OnDeployed = null)
    {
        var roomCode = Guid.NewGuid().ToString();
        yield return EdgegapAPIInterface.RequestDeployment(clientIpList,
             new Dictionary<string, string> {
                { "room_code", roomCode },
                { "player_count", clientIpList.Length.ToString() } });

        yield return EdgegapAPIInterface.WaitForDeployment();

        OnDeployed(roomCode);
    }

第 3 步：加入玩家

除了在被告知时切换到新的 Edgegap 服务器外，加入的玩家还需要将他们的 IP 地址告知主机。由于 Photon 不提供此信息，因此在 GameManager 中的一个 RPC 调用名为 ShareIpAddress 从 Player.cs 类的 Spawned 方法中被调用。

然后主机会根据 RPC 消息的来源将这些 IP 地址存储在所有玩家的玩家类中：

    [Rpc(sources:RpcSources.All, RpcTargets.StateAuthority)]
    public void RpcShareIpAddress(string ipAddress, RpcInfo info = default)
    {
        if (info.Source == PlayerRef.None)
        {
            // 本地玩家的来源将为 None
            Player.local.ipAddress = ipAddress;
            return;
        }

        foreach (var player in PlayerManager.allPlayers)
        {
            if (player.playerID == info.Source.PlayerId)
            {
                player.ipAddress = ipAddress;
                break;
            }
        }
    }

第 4 步：清理

回到服务器中，已修改的 GameManager.cs 在主 Update 函数中跟踪比赛中的玩家数量。它既检查目标玩家数量何时已加入以便开始比赛，也确定何时应关闭自身。如果游戏已运行超过一分钟且没有玩家，则调用 Edgegap API 来停止其自身的部署。

    if (EdgegapManager.IsServer())
    {
        if (GameManager.playState == GameManager.PlayState.LOBBY)
        {
            // 如果我们在大厅并且所有玩家都已加入，则开始比赛
            if (PlayerManager.allPlayers.Count >= EdgegapManager.ExpectedPlayerCount)
            {
                OnAllPlayersReady();
            }
        }

        if(Time.time > 60 && PlayerManager.allPlayers.Count == 0
            && GameManager.playState != GameManager.PlayState.TRANSITION)
        {
            // 如果已经超过一分钟且没有人，停止服务器
            Debug.LogWarning("Shutting Down");
            StartCoroutine(EdgegapAPIInterface.StopDeploymentFromServer());
            GameManager.playState = PlayState.TRANSITION;
        }
    }

现在您有一个可按需部署的 Photon Fusion 项目！