> 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-2-simple-fps.md).

# Photon Fusion 2 Простой FPS

Разместите образец Simple FPS от Photon (Photon Fusion 2) на выделенных серверах Edgegap: по одному развертыванию на матч, используя комплект Edgegap Simple FPS.

Узнайте, как размещать проекты Unity на Edgegap, используя техники из [Simple FPS Multiplayer Sample](https://assetstore.unity.com/packages/templates/tutorials/simple-fps-multiplayer-photon-fusion-272941). Игроки подключаются к серверу из меню **Party** образца, вводя адрес развертывания и регион Photon.

{% hint style="info" %}
Наш [набор Edgegap Simple FPS](https://github.com/edgegap/netcode-game-sample-photon-fusion2-simple-fps) — это набор файлов, которые вы копируете в свой проект Simple FPS. Он **не изменяет и не включает какой-либо код Photon, лицензированный**, поэтому вы получаете Simple FPS из Unity Asset Store по своей собственной лицензии.
{% endhint %}

Этот образец показывает:

* **Simple FPS как выделенный сервер** - одно развертывание на каждый матч, [размещённое ближе к игрокам](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#server-placement).
* **Присоединение через меню Party** - карточка Join использует FQDN вашего развертывания и код региона Photon, **Создать игру** не изменяется.
* **Прямые подключения** - сервер привязывается `0.0.0.0` к порту `7777`, поэтому клиенты подключаются напрямую.
* **Один проект для обеих сторон** - сборки сервера и клиента используют один и тот же список сцен.
* **Самоостановка сервера** - когда процесс сервера завершается сам по себе, стартовый скрипт останавливает развертывание.

{% hint style="success" %}
См. [Photon Fusion 2](https://docs.edgegap.com/ru/docs/sample-projects/unity-netcodes/photon-fusion-2-on-edgegap.md) для **общего руководства по Photon Fusion 2 на Edgegap**. Смотрите [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-simple-fps) для полного списка файлов и результатов тестов.
{% endhint %}

## ✔️ Подготовка

Прежде чем мы начнём, вам понадобятся:

* [Simple FPS Multiplayer (Photon Fusion)](https://assetstore.unity.com/packages/templates/tutorials/simple-fps-multiplayer-photon-fusion-272941) - скачайте и импортируйте в новый проект Unity.
  * Этот образец поставляется со своими настройками проекта.
* [набор Edgegap Simple FPS](https://github.com/edgegap/netcode-game-sample-photon-fusion2-simple-fps),
* Unity 6000.3 с модулями сборки Linux ниже, и **Windows Build Support (IL2CPP)** для клиентов (требуется рабочая нагрузка C++ в Visual Studio),
* App ID Photon Fusion — найдите его в своей [панели управления Photon](https://dashboard.photonengine.com).

{% hint style="info" %}
Откройте проект и установите инструменты сборки сервера, выполнив [Unity](https://docs.edgegap.com/ru/unity.md) шаги подготовки.
{% endhint %}

Этот набор был протестирован с Simple FPS 2.1.1, Fusion 2.1.1 (сборка 2177) и Unity 6000.3.11f1 на Windows.

{% hint style="warning" %}
Ваш сервер **должен использовать IL2CPP** (по умолчанию в образце). Серверы Mono завершают работу в рантайме с необратимой ошибкой.
{% endhint %}

☑️ Чтобы собрать Linux IL2CPP на Windows, добавьте Linux toolchain Unity в Window / Package Manager / + / Add package by name:

* 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.

{% hint style="info" %}
Клиенты и сервер **должны использовать один и тот же App ID, App Version и регион Photon**, иначе они не найдут друг друга.
{% endhint %}

{% hint style="warning" %}
Пакет из Asset Store также содержит `PhotonAppSettings` asset в `Assets/AssetStoreTools/Resources/` с App ID издателя. **Поместите туда и свой App ID или удалите эту копию.**
{% endhint %}

☑️ Установите **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 становится **Пользовательский интерфейс**,
* Запуск: меню Party `FusionMenuUIParty` становится `EdgegapPartyMenu` (для этого экземпляр префаба меню распаковывается),
* Поле кода карточки Join принимает до 30 символов (буквы, цифры и точки) и получает новое **Region** поле рядом с ним,
* профиль сборки установлен на Startup (0), затем Deathmatch (1).

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

### 2. Соберите и загрузите сервер

☑️ Чтобы начать, вам нужно [создать бесплатный аккаунт в Edgegap](https://app.edgegap.com/auth/register). Кредитная карта не требуется.

☑️ Соберите и загрузите свой сервер с помощью плагина Edgegap или из терминала:

{% tabs %}
{% tab title="Плагин Edgegap (рекомендуется)" %}
☑️ Откройте Tools / Edgegap Server Hosting. На шаге **3. Контейнеризуйте ваш сервер**, нажмите **Path To Dockerfile** и выберите `edgegap/Dockerfile`. Оставьте **Relative Build Path** на `Builds/EdgegapServer`, затем Containerize и загрузите.

☑️ Оставьте порт `7777` / UDP, когда плагин создаёт вашу версию приложения.
{% endtab %}

{% tab title="Терминал (для Agents)" %}
☑️ Найдите ваш [Container Registry](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) имя проекта и учётные данные, затем выполните вход с помощью `docker login registry.edgegap.com`.

☑️ Соберите свой сервер, затем упакуйте и отправьте образ (Git Bash работает в Windows):

{% code collapsedlinecount="10" %}

```bash
scripts/build.sh server
scripts/package.sh registry.edgegap.com/<your-registry-project>/simplefps <new-tag>
```

{% endcode %}

`package.sh` выводит новый тег, который он отправил.

☑️ [Создайте приложение](https://app.edgegap.com/application-management/applications/list) и версию для вашего образа. Вы также можете использовать `examples/app-version.json` с `POST /v1/app/{app}/version`.
{% endtab %}
{% endtabs %}

Первая сборка IL2CPP сервера занимает около 13 минут.

{% hint style="danger" %}
:x: **НЕ ДЕЛАЙТЕ — не перезаписывайте существующие теги и не используйте `latest`  тег** — это приведёт к развёртыванию устаревшего кэша.\
:white\_check\_mark: **ДЕЛАЙТЕ — всегда увеличивайте номер версии в теге** и развёртывайте новую сборку.
{% endhint %}

Вы также можете собирать из редактора через Tools / Edgegap Simple FPS / Build Linux Server, что создаёт тот же результат в `Builds/EdgegapServer`. См. [Unity](https://docs.edgegap.com/ru/unity.md) чтобы узнать больше о сборке серверов Unity.

{% hint style="warning" %}
Если вы упаковываете сервер с помощью плагина Edgegap Unity, задайте его **Path To Dockerfile** в `edgegap/Dockerfile`.
{% endhint %}

☑️ [Создайте приложение](https://app.edgegap.com/application-management/applications/list) и версию с помощью:

* ваш образ и тег,
* ваше имя пользователя и токен Container Registry,
* ресурсы 1 vCPU и 2 GB для начала,
* [порт](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping) `7777`, протокол **UDP**, с выключенной проверкой порта.

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

### 3. Протестируйте локально

☑️ Соберите локальный образ и запустите его с переменными, которые Edgegap будет внедрять:

{% code collapsedlinecount="10" %}

```bash
scripts/package.sh
scripts/run-local.sh
```

{% endcode %}

☑️ Найдите строку журнала `[edgegap-simplefps] server started: session=f68e011bfb01.pr.edgegap.net photon_region=<code>` и присоединитесь с клиента с этой сессией и регионом, как на следующем шаге.

{% hint style="info" %}
Локальные клиенты подключаются **через ретрансляцию**, поскольку клиенты на той же машине не могут напрямую достучаться до NAT-адреса Docker Desktop. На Edgegap тот же образ подключается **напрямую**.
{% endhint %}

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

### 4. Разверните и подключитесь

☑️ Запустите развертывание из плагина, [панели управления](https://app.edgegap.com/deployment-management/deployments/list), или `POST /v2/deployments`. Передайте публичные IP ваших игроков в [разверните ближе к ним](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#server-placement).

☑️ Найдите `server started: session=<fqdn> photon_region=<code>` в логах вашего развертывания.

☑️ Соберите клиента с помощью `scripts/build.sh client` (или вашей обычной сборки Windows), запустите его и нажмите **Party Menu** в главном меню.

☑️ На карточке Join введите FQDN вашего развертывания (например, `f68e011bfb01.pr.edgegap.net`) в поле кода, а код региона (например, `cae`) в **Region** поле, затем нажмите **Join**.

{% hint style="info" %}
Если клиент не подключается, скорее всего, ваш регион не совпадает со строкой в логе сервера.
{% endhint %}

🙌 Поздравляем с вашим первым развертыванием на Edgegap!

## 🔄 Жизненный цикл матча

1. Сборка сервера пропускает меню Startup и загружает Deathmatch.
2. `EdgegapFusionBootstrap` запускает сервер Fusion на `ARBITRIUM_PORT_GAMEPORT_INTERNAL` (`7777` по умолчанию), привязанный к `0.0.0.0`, и называет сессию по FQDN развертывания, `<ARBITRIUM_REQUEST_ID>.pr.edgegap.net`.
3. Сервер записывает имя сессии и регион Photon, которые игроки вводят в карточке Join меню Party и подключаются напрямую к развертыванию.
4. Когда процесс сервера завершается сам по себе, `edgegap/start-server.sh` вызывает `ARBITRIUM_DELETE_URL` чтобы остановить развертывание.

{% hint style="info" %}
Стартовый скрипт никогда не выводит окружение, поэтому **ваш токен удаления не попадает в логи**.
{% endhint %}

См. [Развертывания](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md) узнать больше.

## ⚙️ Переменные окружения

| Переменная                                       | Задаётся                      | Эффект                                                                                                                                                                     |
| ------------------------------------------------ | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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`. Когда он не задан, сервер использует регион с лучшим ping из места, где он запущен. Это переопределение пока не тестировалось. |
| `ARBITRIUM_DELETE_URL`, `ARBITRIUM_DELETE_TOKEN` | Edgegap                       | Когда процесс сервера завершается сам по себе, стартовый скрипт использует их, чтобы остановить развертывание.                                                             |

См. [внедрённые переменные](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#injected-environment-variables) узнать больше.

## 🔌 Прямое подключение

Simple FPS  `IP` и `Порт` задайте адрес, к которому ваш сервер **привязывается** . Набор привязывается `0.0.0.0:7777`, Fusion самостоятельно находит публичный адрес развертывания, и клиенты подключаются **напрямую** - даже несмотря на то, что Edgegap даёт игрокам другой [внешний порт](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping).

| Сервер `IP`                | Результат                                                                                                                                          |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0.0.0.0` (этот набор)     | **напрямую** на Edgegap.                                                                                                                           |
| `127.0.0.1`                | Сервер запускается, но клиенты **через ретрансляцию** через Photon, что добавляет задержку. Ничто вне контейнера не может достичь loopback-адреса. |
| Публичный IP развертывания | Сервер **не запускается** (`Не удалось привязать сокет`), потому что контейнер не владеет этим адресом. Клиенты получают `GameNotFound`.           |

## 🎬 Сцены сервера

Fusion сообщает клиентам, какую сцену загружать, по **индексу сборки**. Сервер, собранный только с Deathmatch, имел бы Deathmatch под индексом 0, тогда как у клиентов Startup находится под индексом 0. Затем клиенты никогда не находят игровые объекты и выдают `NullReferenceException` в `Player.FixedUpdateNetwork` на каждом тике. Вот почему обе сборки используют Startup (0) и Deathmatch (1), а сервер пропускает Startup.

По той же причине сервер помечает Deathmatch **активным при загрузке**, как и собственный хост образца. Без этого клиенты загружают Deathmatch, но оставляют активным Startup, с той же ошибкой.

## ⚠️ Известные проблемы

* Прохождение матча до конца и то, завершается ли сервер после матча, пока не протестированы — см. [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-simple-fps).
* `PHOTON_REGION` переопределение пока не тестировалось.

## 🚨 Устранение неполадок

<details>

<summary><code>MethodAccessException ... CheckInvokeRpc</code> в логе сервера</summary>

* Ваш сервер был собран с Mono. Пересоберите его с IL2CPP.

</details>

<details>

<summary><code>Не найден toolchain для платформы хоста</code> или <code>Linux sysroot не найден</code></summary>

* Пакеты Linux toolchain отсутствуют, см. [Подготовка](#preparation).

</details>

<details>

<summary>Клиент получает <code>GameNotFound</code></summary>

* App Version или регион Photon отличается между клиентом и сервером. Сравните со строкой `photon_region=` в логе.

</details>

<details>

<summary>Клиент получает <code>InvalidAuthentication</code></summary>

* Ваш App ID Fusion указан неверно или отсутствует в сборке.

</details>

<details>

<summary>Наложение вкладки показывает CT Relayed</summary>

* Ваш сервер привязывается `127.0.0.1`, см. [Прямое подключение](#direct-connection).

</details>
