> 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-on-edgegap.md).

# Photon Fusion 1

为一个使用 Photon Fusion 作为联网方案的项目，在 Edgegap 上创建一个无头 Unity 游戏服务器。

### Arbitrium 上的 Photon Fusion

本指南将帮助你为使用以下内容的 Unity 项目在 Edgegap 上创建一个无头服务器 [Photon Fusion](https://doc.photonengine.com/en-us/fusion/current/getting-started/fusion-intro) 作为其网络解决方案。

我们将使用以下示例项目 [Photon Fusion 的 Tanknarok](https://doc.photonengine.com/en-us/fusion/current/samples/fusion-tanknarok) 作为示例。

由于 Edgegap 在知道所有玩家的位置时效果最好（这样它就能选择最优位置的服务器），Tanknarok 游戏会先以客户端托管模式启动，然后在所有玩家加入后切换到 Edgegap 服务器。这是因为 Tanknarok 在比赛开始前有一个可游玩的大厅，玩家可以随时加入和离开。因此，逻辑流程如下：

1. 玩家使用以下方式连接到同一个房间 `AutoHostOrClient` 模式。它会自动将房间中的第一个玩家选为主机。
2. 所有玩家在加入时都会将自己的 IP 地址发送给主机。
3. 当玩家准备就绪后，主机会使用这些 IP 地址，通过一个随机房间代码（使用 GUID）启动游戏的 Edgegap 服务器版本。
4. 当主机发现 Edgegap 实例已完成部署时，会将新的房间代码告知其他玩家。
5. 包括主机在内的所有玩家都会断开当前房间，并以 Client 模式重新连接到由 Edgegap 服务器托管的新房间。
6. 当 Edgegap 服务器发现所有预期玩家都已加入时，它会开始比赛。
7. 当 Edgegap 服务器发现所有人都已离开比赛时，它会自行关闭。

### 账户设置

要运行此应用程序，你需要同时拥有 Photon 账户和 Edgegap 账户。首先，你需要在 Photon 仪表板上创建一个 Fusion 应用，并将应用 ID 设置在以下文件中： `PhotonAppSettings` ScriptableObject 文件中。然后，你需要添加一个应用程序并在仪表板上创建一个 API 令牌。你将使用它们在以下文件中设置 App Name、Version 和 Api Token： `EdgegapConfig` ScriptableObject 文件中。

{% hint style="info" %}
在创建 Edgegap 应用时，此程序需要 512 CPU 单元和 512 MB 内存。
{% endhint %}

此外，还有两个插件可帮助开发：Newtonsoft Json，用于更好的 Json 序列化，以及 [ParrelSync](https://github.com/VeriorPies/ParrelSync) 用于在多个 Unity 编辑器中更轻松地测试。

### 步骤 1：服务器模式设置

你可以获取 [修改后的 Tanknarok 项目](https://github.com/edgegap/netcode-game-sample-unity-photon-fusion-tanknarok) 在 GitHub 上。你还需要导入 [Photon Fusion SDK](https://doc.photonengine.com/en-us/fusion/current/getting-started/sdk-download) 到项目中。

Photon Fusion Tanknarok 项目需要做一些小改动才能作为服务器运行。这主要包括自动开始比赛和设置模式。

1. 已修改的 `GameLauncher.cs` 以在启动时使用 `GameMode.Server`.
2. 已修改的 `FusionLauncher.cs` 以调用 `_spawnWorldCallback` 在游戏运行后立即调用，而不是依赖 `InstantiatePlayer` （因为服务器不会实例化玩家）。
3. 如果是服务器，则跳过大厅场景，并在所有玩家加入后直接进入比赛。

这已经在以下内容中完成了 [修改后的 Tanknarok 项目](https://github.com/edgegap/netcode-game-sample-unity-photon-fusion-tanknarok).

#### Dockerfile

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

### 步骤 2：第一个客户端

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

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

{% code collapsedlinecount="10" %}

```cs
    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);
    }
```

{% endcode %}

切换发生在一个名为以下名称的空场景中： `TransferringScene`.

在 EdgegapManager 中，会创建一个随机房间代码，并通过部署 API 作为环境变量与玩家数量一起传递给新创建的实例。这与以下内容结合使用： `状态` API 调用，这些调用每秒开始检查一次，以查看实例何时完成部署。你也可以使用 [webhook](broken://pages/2f30a273a80a03bdb675d756ecd5af553b91084f) 选项。

{% code collapsedlinecount="10" %}

```cs
    /// <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);
    }
```

{% endcode %}

### 步骤 3：加入的玩家

除了在收到指令时切换到新的 Edgegap 服务器外，加入的玩家还需要告诉主机玩家自己的 IP 地址。由于 Photon 不提供此信息，因此会在 `GameManager` 中称为 `ShareIpAddress` 的 RPC 调用由 `Player.cs` 类中的 `Spawned` 方法调用。

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

{% code collapsedlinecount="10" %}

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

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

{% endcode %}

### 步骤 4：清理

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

{% code collapsedlinecount="10" %}

```cs
    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;
        }
    }
```

{% endcode %}

现在你已经拥有一个可按需部署的 Photon Fusion 项目了！
