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

# Photon Bolt

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

Это руководство поможет вам создать выделенный сервер на Edgegap для проекта на Unity с использованием Photon Bolt в качестве сетевого решения.

В этом руководстве в качестве примера мы будем использовать собственный демонстрационный проект.

### Подготовка проекта Unity

### Клонируйте проект Unity

Первый шаг — клонировать демонстрационный проект игры Edgegap из git. Это можно сделать с помощью этой команды в командной строке:

Команда создаст папку, содержащую исходный проект Unity, под названием `demo-game`.

Когда процесс завершится, вы можете открыть Unity Hub и добавить проект, нажав кнопку `Add` на вкладке Projects, а затем найдя папку проекта на своем компьютере:

Чтобы открыть проект, у вас должна быть установлена правильная версия Unity. В нашем случае мы будем использовать Unity `2020.3.3`. Найти ее можно в архиве загрузок Unity: <https://unity3d.com/get-unity/download/archive>.

После завершения установки вы сможете выбрать новую версию Unity в раскрывающемся меню рядом с названием проекта в Unity Hub:

Теперь вы можете открыть проект Unity и перейти к следующим шагам.

### Настройка игры

### Настройка Photon Bolt

#### Добавьте App ID Photon и скомпилируйте Bolt

Чтобы игра могла взаимодействовать со службами Photon, вам нужно добавить приложение в панель управления Photon. Если у вас еще нет [аккаунта Photon](https://id.photonengine.com/Account/) то вы можете легко создать его.

После входа в систему вы можете создать приложение и дать ему имя. У каждого приложения есть уникальный `App ID`. Вам нужно будет скопировать и вставить этот ID в окно `Bolt Settings` внутри проекта Unity:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-85755915f46bb51ed45784518d86ce278e998650%2Funity_photon_bolt_settings.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-fccf1cdf65056d42522cd4405f5a5dfbc5265106%2Funity_photon_bolt_app_id.png?alt=media" alt=""><figcaption></figcaption></figure>

После ввода ID вы можете закрыть окно Bolt Settings. В том же меню `Bolt` что и раньше, вам нужно будет выполнить два действия: `Update Prefab Database` и `Compile Assembly`, соответственно.

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-93c9dc4b160db8a4b12142313da2c48bdb6a05cb%2Funity_photon_bolt_compile.png?alt=media" alt=""><figcaption></figcaption></figure>

На этом этапе вы должны иметь возможность запустить сцену `StartScene` игры без каких-либо ошибок или предупреждений в консоли отладки. Однако пока вы не можете начать играть на сервере.

На этом завершаются общие изменения, необходимые для работы вашего Photon Bolt. Эти изменения будут работать как для клиентов, так и для серверов вашей игры.

### Подготовка сервера без графического интерфейса

Чтобы ваше приложение эффективно работало с контейнерами, вам нужно внести несколько изменений в игру, чтобы создать сборку «headless server». Для большинства проектов это потребует лишь нескольких простых шагов.

#### Требования к проекту Unity

Во-первых, важно отметить, что режим headless server в Photon Bolt требует загрузки сцены, содержащей скрипт с названием `HeadlessServerManager`.

Стандартный, без изменений, скрипт по этому вопросу (взятый из документации Bolt) выглядит так:

{% code collapsedlinecount="10" %}

```cs
using System;
using Bolt.Matchmaking;
using Bolt.Photon;
using UnityEngine;
using UnityEngine.SceneManagement;

namespace Bolt.Samples.HeadlessServer
{
    public class HeadlessServerManager : Bolt.GlobalEventListener
    {
        public string Map = "";
        public string GameType = "";
        public string RoomID = "";

        public override void BoltStartBegin(" alt=""><figcaption></figcaption></figure>
        {
            // Зарегистрируйте любой Protocol Token, который вы используете
            BoltNetwork.RegisterTokenClass<PhotonRoomProperties>();
        }

        public override void BoltStartDone()
        {
            if (BoltNetwork.IsServer)
            {
                // Создайте пользовательские свойства комнаты
                PhotonRoomProperties roomProperties = new PhotonRoomProperties();

                roomProperties.AddRoomProperty("t", GameType); // например: тип игры
                roomProperties.AddRoomProperty("m", Map); // например: id карты

                roomProperties.IsOpen = true;
                roomProperties.IsVisible = true;

                // Если RoomID не был задан, создайте случайный
                if (RoomID.Length == 0)
                {
                    RoomID = Guid.NewGuid().ToString();
                }

                // Создайте комнату Photon
                BoltMatchmaking.CreateSession(
                    sessionID: RoomID,
                    token: roomProperties,
                    sceneToLoad: Map
                );
            }
        }

        // Используется для инициализации
        void Start()
        {
            // Получить пользовательские аргументы из командной строки
            Map = GetArg("-m", "-map") ?? Map;
            GameType = GetArg("-t", "-gameType") ?? GameType; // например: получить тип игры из командной строки
            RoomID = GetArg("-r", "-room") ?? RoomID;

            // Проверить запрошенный уровень
            var validMap = false;

            foreach (string value in BoltScenes.AllScenes)
            {
                if (SceneManager.GetActiveScene().name != value)
                {
                    if (Map == value)
                    {
                        validMap = true;
                        break;
                    }
                }
            }

            if (!validMap)
            {
                BoltLog.Error("Invalid configuration: please verify level name");
                Application.Quit();
            }

            // Запустить сервер
            BoltLauncher.StartServer();
            DontDestroyOnLoad(this);
        }

        /// <summary>
        /// Утилитарная функция для определения, был ли экземпляр игры запущен в headless-режиме.
        /// </summary>
        /// <returns><c>true</c>, если был использован headless-режим, <c>false</c> в противном случае.</returns>
        public static bool IsHeadlessMode()
        {
            return Environment.CommandLine.Contains("-batchmode") && Environment.CommandLine.Contains("-nographics");
        }

        static string GetArg(params string[] names)
        {
            var args = Environment.GetCommandLineArgs();
            for (int i = 0; i < args.Length; i++)
            {
                foreach (var name in names)
                {
                    if (args[i] == name && args.Length > i + 1)
                    {
                        return args[i + 1];
                    }
                }
            }

            return null;
        }
    }
}
```

{% endcode %}

Обычно его размещают на пустом GameObject в пустой сцене (которая будет использоваться только для сборок headless server).

Скрипт был немного изменен для этого демонстрационного проекта, чтобы соответствовать структуре проекта, и в настоящее время он размещен на пустом GameObject в сцене, расположенной в `Assets/Scenes/BoltHeadlessServer`.

#### Добавление проверок headless server в вашу игру

В приведенном выше скрипте есть статический метод-утилита под названием `IsHeadlessMode`, который используется для проверки, является ли запущенная игра headless или нет. Если вы обновляете существующий проект, возможно, вы захотите добавить эту проверку, чтобы удалять или добавлять функции для headless server, например, предотвращать создание персонажа игрока.

#### Настройки сборки

В `Buid Settings` проекта добавьте сцену `BoltHeadlessServer` в самый верх, чтобы она первой загружалась сервером.

Затем выберите `Linux` в качестве целевой платформы и отметьте `Server Build`.

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-119e3c54e779d1120313d9dbba22037fbe3670ca%2Funity_photon_bolt_build_settings.png?alt=media" alt=""><figcaption></figcaption></figure>

Теперь вы можете собрать свою игру под Linux с указанными выше настройками.

Для **сборок клиента**, не забудьте снять флажок с `BoltHeadlessServer` сцены и `IsServer` параметра, чтобы ваша игра работала корректно.

По каждому шагу, связанному с созданием headless server для Photon Bolt, доступно больше подробностей в [документации по headless server для Photon Bolt](https://doc.photonengine.com/en-us/bolt/current/demos-and-tutorials/headless-server).

### Создайте контейнер для сервера

Если вы не знакомы с Docker или контейнерами, вы можете узнать больше, ознакомившись с [Что такое Docker?](https://docs.edgegap.com/ru/docs/tools-and-integrations/docker.md)

Чтобы создать контейнер из проекта Unity, обратитесь к [Unity on Docker](broken://pages/a2a2d6a63dad79041b04c5a60831409dfc7a3a24).

### Добавьте свое приложение в Edgegap

Теперь вы можете добавить свой контейнер в Edgegap, чтобы он мог быть размещен везде, где находятся ваши игроки.

Если вы не знаете, как добавить приложение в Edgegap, обратитесь к [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md).

Однако вам нужно убедиться, что название вашего приложения — `demo-game` и что у него есть версия под названием `v1`. В противном случае вам нужно будет обновить эти значения в скрипте, расположенном в `Assets/Scripts/StaginController.cs`.

Также в скрипте `Assets/Scripts/StaginController.cs` вы найдете константную переменную под названием `API_TOKEN`. Вам нужно будет создать токен в своей учетной записи Edgegap и вставить его в виде строки в эту переменную. Этот токен будет использоваться для авторизации API-запросов, отправляемых в Edgegap.

Вот этот скрипт: токен Edgegap выделен синим, а параметры приложения — красным:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-356f4d51a5c114024fea432e8fcd9b677d3c9e98%2Funity_photon_bolt_staging_controller.png?alt=media" alt=""><figcaption></figcaption></figure>

## Запуск демо-игры

Наконец, вы можете запустить клиентскую сборку демо-игры, чтобы поиграть. Вы можете либо собрать клиентскую версию игры и запустить ее, либо играть прямо из интерфейса Unity. Только обязательно запускайте ее на `StartScene` сцене.

После запуска появится интерфейс. Он содержит текстовое поле вверху, две большие кнопки и метку внизу слева экрана, показывающую текущее состояние Bolt.

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-3ace5ac3f2d80112f7564e85fdcf8c65d844bf34%2Funity_photon_bolt_demo_game.png?alt=media" alt=""><figcaption></figcaption></figure>

Вы можете скопировать свой API Token из Edgegap в текстовое поле вверху. После того как токен будет вставлен, вы можете нажать кнопку `Request Server` чтобы отправить API-вызов в Edgegap и запустить сервер.

Через несколько секунд вы должны увидеть, как внизу интерфейса появится метка с количеством доступных серверов. Теперь нажмите кнопку `Connect to a random server` чтобы присоединиться к игре и начать играть.
