> 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/ru/docs/sample-projects/unity-netcodes/photon-fusion-on-edgegap.md).

# Photon Fusion 1

Создайте headless-игровой сервер Unity на Edgegap для проекта, использующего Photon Fusion в качестве сетевого решения.

### Photon Fusion на Arbitrium

Это руководство поможет вам создать безголовый сервер на Edgegap для проекта Unity с использованием [Photon Fusion](https://doc.photonengine.com/en-us/fusion/current/getting-started/fusion-intro) в качестве сетевого решения.

В качестве примера мы будем использовать демонстрационный проект [Tanknarok от Photon Fusion](https://doc.photonengine.com/en-us/fusion/current/samples/fusion-tanknarok) в качестве примера.

Поскольку Edgegap лучше всего работает, когда знает, где находятся все игроки (чтобы он мог выбрать сервер в оптимальном месте), игра Tanknarok сначала запускается в режиме клиент-хоста, а затем переключается на сервер Edgegap, когда все игроки присоединятся. Это потому, что в Tanknarok есть игровое лобби, которое работает до начала матча, где игроки могут свободно входить и выходить. Итак, логика работы следующая:

1. Игроки подключаются к одной и той же комнате, используя `AutoHostOrClient` режим. Он автоматически выбирает первого игрока в комнате в качестве хоста.
2. Все игроки отправляют свой IP-адрес хосту, когда присоединяются.
3. Как только игроки готовы, хост использует эти IP-адреса, чтобы запустить серверную версию игры Edgegap со случайным кодом комнаты (с использованием GUID).
4. Когда хост видит, что экземпляр Edgegap завершил развёртывание, он сообщает другим игрокам новый код комнаты.
5. Все игроки, включая хоста, отключаются от своей текущей комнаты и повторно подключаются в режиме Client к новой комнате, размещаемой сервером Edgegap.
6. Когда сервер Edgegap видит, что присоединились все ожидаемые игроки, он запускает матч.
7. Когда сервер Edgegap видит, что все покинули матч, он завершает свою работу.

### Настройка аккаунта

Чтобы запустить это приложение, вам понадобятся и аккаунт Photon, и аккаунт Edgegap. Сначала вам нужно создать приложение Fusion на панели управления Photon и задать идентификатор приложения в `PhotonAppSettings` файле scriptable object. Затем вам нужно добавить приложение и создать API-токен на панели управления. Вы будете использовать их, чтобы задать имя приложения, версию и API-токен в `EdgegapConfig` файле scriptable object.

{% hint style="info" %}
При создании приложения Edgegap этой программе требуются 512 единиц CPU и 512 МБ памяти.
{% 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. Вам также нужно импортировать [SDK Photon Fusion](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/9afd360b608a36b6247de5fedb65861406336dd2) .

{% code collapsedlinecount="10" %}

```cs
    /// <summary>
    /// Вызывает API Edgegap для развёртывания сервера
    /// </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 не предоставляет эту информацию, вызов RPC в `GameManager` с именем `ShareIpAddress` вызывается из `класса Player.cs` в `методе Spawned` .

Затем хост сохраняет эти IP-адреса в классе игрока для всех игроков на основе того, кто был источником RPC-сообщения:

{% code collapsedlinecount="10" %}

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

{% endcode %}

### Шаг 4: Очистка

Обратно на сервере, изменённый `GameManager.cs` отслеживает количество игроков в матче в основной функции Update. Он и проверяет, когда присоединилось целевое число игроков, чтобы можно было начать матч, и определяет, когда пора завершить свою работу. Если игра работает уже более минуты и никого не осталось, он вызывает API Edgegap, чтобы остановить собственное развёртывание.

{% 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, доступный для развертывания по запросу!
