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

# Photon Fusion 2

Разместите игру Unity на Photon Fusion 2 на Edgegap, следуя примеру Fusion 2 Asteroids от сборки до рабочего развертывания.

Узнайте, как размещать проекты Unity на Edgegap, используя методы из [Образца Fusion 2 Asteroids](https://doc.photonengine.com/fusion/current/game-samples/fusion-asteroids).

{% embed url="<https://youtu.be/bg41HpPmE3E>" %}

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

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

* [Unity 6](https://unity.com/releases/unity-6) - загрузка через Unity Hub,
* [проект-образец Fusion 2 Asteroids](https://github.com/edgegap/netcode-game-sample-photon-fusion2-asteroid) (изменённый для Edgegap).

## ⚡ Развертывание и подключение

{% hint style="success" %}
Смотрите [Unity](https://docs.edgegap.com/ru/unity.md) для Unity, чтобы **узнать, как собирать и настраивать серверы**.
{% endhint %}

### 1. Разверните сервер на Edgegap

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

☑️ [Создайте новую версию приложения для вашего приложения](https://app.edgegap.com/application-management/applications/fusion-2-asteroids-sample/versions/create), выберите Fusion 2 Asteroids Sample.

☑️ Откройте новый проект в Unity.

☑️ Перейдите в Tools / Edgegap Hosting, затем к шагу 6. Разверните сервер на Edgegap.

☑️ Нажмите Deploy to cloud и [откройте детали нового развёртывания](https://app.edgegap.com/deployment-management/deployments/list).

☑️ Найдите уникальные одноразовые данные для подключения вашего развёртывания:

* **Host URL** в формате `780aa4260e83.pr.edgegap.net` .

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

### 2. Подключение из редактора

☑️ Откройте новый проект в Unity.

☑️ Нажмите кнопку ▶️ Play, чтобы запустить клиент игры.

☑️ Введите Host URL (данные подключения из предыдущего шага) как имя комнаты.

☑️ Нажмите кнопку Start Edgegap, чтобы подключиться к вашему серверу.

☑️ Подключите второго виртуального игрока с помощью [Multiplayer Play Mode](https://docs-multiplayer.unity3d.com/mppm/current/about/) или [ParrelSync](https://github.com/VeriorPies/ParrelSync).

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

## ✏️ Настройка сборки сервера

### Создайте приложение в Photon

{% hint style="info" %}
Чтобы сделать первоначальную демонстрацию простой, мы использовали бесплатный аккаунт Photon Cloud, принадлежащий Edgegap.
{% endhint %}

☑️ [Создайте бесплатную учётную запись в Photon](https://dashboard.photonengine.com/).

☑️ [Создайте приложение в Photon](https://dashboard.photonengine.com/app/create):

* `Многопользовательская игра`,
* `Fusion` Photon SDK,
* `Fusion 2` версия SDK.

☑️ Найдите свой Application ID в формате `85314a99-56fc-4ab3-ba26-50efca09f303` .

☑️ Введите свой ID в Photon Settings в Tools / Fusion / Fusion Hub (Alt + F).

### Интеграция проекта Fusion 2 с Edgegap

{% hint style="success" %}
Смотрите `EdgegapServerManager.cs`  скрипт с примером интеграции Fusion 2 с Edgegap.
{% endhint %}

{% hint style="warning" %}
Ваш `NetworkProjectConfig`  **должен использовать `Peer Mode = Single` (Ded. Server)**, а не `Multiple` (Client-Host)!
{% endhint %}

Игровые клиенты будут подключаться к игровым серверам через [Photon Fusion 2 ](https://doc.photonengine.com/fusion/current/manual/connection-and-matchmaking/matchmaking#creating-and-joining-a-game-session)[Session (комната) ](https://doc.photonengine.com/fusion/current/manual/connection-and-matchmaking/matchmaking#creating-and-joining-a-game-session)[функцию](https://doc.photonengine.com/fusion/current/manual/connection-and-matchmaking/matchmaking#creating-and-joining-a-game-session).

Ваш игровой сервер должен зарегистрировать свой IP-адрес и внешний порт вместе с именем Session при вызове `_runnerInstance.StartGame(StartGameArgs args)`:

* используйте `GameMode.Server`  чтобы убедиться, что ваше соединение не ретранслируется через Photon Cloud (это добавляет задержку),
* используйте `NetAddress.CreateFromIpPort` метод из Fusion,
* укажите IP-адрес сервера:\
  `Environment.GetEnvironmentVariable("ARBITRIUM_PUBLIC_IP")`
* укажите внешний порт сервера:\
  `Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_EXTERNAL")`
  * это имя сопоставления портов по умолчанию, если вы используете наш [плагин Unity для упаковки вашего сервера](https://docs.edgegap.com/ru/unity.md).

Используйте Host URL развёртывания Edgegap как имя Session:

* на игровом сервере получите его с помощью\
  `$"{Environment.GetEnvironmentVariable("ARBITRIUM_REQUEST_ID")}.pr.edgegap.net"`
* при тестировании игрового клиента получите его на панели управления — страница деталей развёртывания / Host URL
  * создавайте развёртывания для тестирования из нашего [плагина быстрого старта для хостинга](https://docs.edgegap.com/ru/unity/developer-tools.md#dedicated-servers-quickstart-plugin),
* в живом игровом клиенте получите его из [матчмейкинга / назначения билета / fqdn](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#player-api):
  * см. также [начало работы с Matchmaking](https://docs.edgegap.com/ru/learn/matchmeiking.md).

{% tabs %}
{% tab title="Интеграция клиента" %}
{% code title="EdgegapClientManager.cs" collapsedlinecount="10" %}

```csharp
// получить сетевой раннер Fusion 2
_runnerInstance = FindFirstObjectByType<NetworkRunner>();
_runnerInstance.ProvideInput = true;

// получите это значение из Edgegap Matchmaker Assignment или Fusion 2 Sessions API
string sessionName = "<requestId.pr.edgegap.net>";

// найти сессию Fusion 2 (используя имя сессии)
var result = await _runnerInstance.StartGame(
    new StartGameArgs() {
        GameMode = GameMode.Client,
        SessionName = sessionName,
        ObjectProvider = _runnerInstance.GetComponent<NetworkObjectPoolDefault>(),
    }
);

// теперь Fusion получит IP и порт сервера на основе имени сессии и подключится
```

{% endcode %}
{% endtab %}

{% tab title="Интеграция сервера" %}
{% code title="EdgegapServerManager.cs" collapsedlinecount="10" %}

```csharp
// прочитать внедрённые Edgegap переменные окружения
string requestId = Environment.GetEnvironmentVariable("ARBITRIUM_REQUEST_ID");
string listenPortStr = Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_INTERNAL");
string connectIP = Environment.GetEnvironmentVariable("ARBITRIUM_PUBLIC_IP");
string connectPort = Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_EXTERNAL");

// получить сетевой раннер Fusion 2
_runnerInstance = FindFirstObjectByType<NetworkRunner>();
_runnerInstance.ProvideInput = true;

// преобразовать порт прослушивания в ushort, ожидаемый StartGame
ushort.TryParse(listenPortStr, out ushort listenPort);

// зарегистрировать сессию Fusion 2, чтобы клиенты могли найти её позже (используя имя сессии)
var result = await _runnerInstance.StartGame(
    new StartGameArgs() {
        GameMode = GameMode.Server,
        SessionName = $"{requestId}.pr.edgegap.net",
        ObjectProvider = _runnerInstance.GetComponent<NetworkObjectPoolDefault>(),
        Address = NetAddress.Any(listenPort),
        CustomPublicAddress = NetAddress.CreateFromIpPort(connectIP, connectPort),
    }
);

// загрузить начальную сцену
if (result.Ok && _runnerInstance.IsServer) {
    await _runnerInstance.LoadScene(sceneName);
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

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

Fusion `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`.             |

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

<details>

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

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

</details>

<details>

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

* Пакеты Linux toolchain отсутствуют. Добавьте 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`.

</details>

<details>

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

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

</details>

<details>

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

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

</details>

<details>

<summary>Вкладка overlay показывает CT Relayed</summary>

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

</details>
