> 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/small-network-relay.md).

# Малый сетевой ретранслятор Lightnet

Разверните небольшой расширяемый сетевой ретранслятор на Edgegap и играйте в Tanks через него с помощью Mirror, FishNet, PurrNet или Netcode for Game Objects, используя коды комнат или матчмейкинг Edgegap.

Узнайте, как запустить собственный небольшой сетевой релей на Edgegap, с примером игры на Unity, который проходит через него с использованием [Mirror](https://mirror-networking.com/), [FishNet](https://fish-networking.gitbook.io/docs), [PurrNet](https://purrnet.dev/) или [Netcode for GameObjects (NGO)](https://docs-multiplayer.unity3d.com/netcode/current/about/).

Релей — это небольшой сервер .NET, построенный на [LightNet](https://github.com/edgegap/server-sample-unity-smart-relays). Edgegap размещает и оркестрирует его как любой другой сервер: одно развёртывание, запущенное рядом с вашими игроками. Один игрок создаёт комнату и получает код из 6 букв, остальные игроки присоединяются по этому коду. Никакой игрок не открывает порт: все, включая хоста, являются клиентами релея.

Этот пример показывает:

* **сервер релея** в `linux/amd64` Docker-образе, прослушивающем порт `7777` для TCP (надёжные сообщения) и UDP (ненадёжные сообщения),
* **комнаты с кодом для присоединения** - множество комнат могут использовать одно развёртывание релея,
* **пример Tanks на четырёх netcode** - Mirror, FishNet, PurrNet и NGO в одном проекте Unity, одна сборка,
* **одна настройка для переключения netcode** - в asset настроек, меню редактора, в игре до подключения или из командной строки,
* **необязательный matchmaking Edgegap** - по умолчанию выключен: **Найти матч** сводит рядом находящихся игроков на релее рядом с ними, один игрок на комнату становится хостом, игроки, которые ищут позже, присоединяются к уже запущенным комнатам, а релей с полными комнатами открывает новые, прежде чем запустится ещё один релей,
* **необязательное зашифрованное соединение** - `wss://` через TLS Upgrade от Edgegap, рядом с обычными TCP и UDP,
* **автоматизированные тесты** - игровые клиенты играют через релей на каждом netcode, с кодами комнат или через матчмейкер.

{% hint style="success" %}
**Это схема клиент-хост**: хостирующий игрок работает как сервер, а релей пересылает байты между игроками.
{% endhint %}

{% hint style="info" %}
Альтернатива - [выделенные серверы](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#orchestration) устраняют преимущество хостирующего игрока, и матч продолжается после выхода хоста.
{% endhint %}

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

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

* [демо-проект Small Network Relay](https://github.com/edgegap/server-sample-lightnet-relay),
* [Unity `6000.0.54f1`](https://unity.com/releases/editor/archive), чтобы открыть и собрать игру,
* [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) (необязательно), только чтобы запускать релей вне Docker.

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Установите Docker Desktop (или Docker CLI)</a></summary>

* [Установите Docker Desktop из официального источника](https://www.docker.com/products/docker-desktop/) (аккаунт не требуется).
* Перезагрузите компьютер после завершения установки.

</details>

Репозиторий состоит из четырёх частей:

| Папка                    | Что это                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
| `LightNet`               | Сетевое ядро LightNet как пакет Unity, плюс протокол релея и его клиент, не зависящий от netcode. |
| `relay-server`           | Relay Server — консольное приложение .NET 8, собранное из тех же исходников, и его Dockerfile.    |
| `tanks`                  | проект Unity: пример Tanks из Mirror на Mirror, FishNet, PurrNet и NGO.                           |
| `matchmaker-config.json` | необязательная конфигурация матчмейкера, см. [Необязательный Matchmaking](#optional-matchmaking). |

## 🔀 Выберите netcode

Netcode — это `netcode` поле `tanks/Assets/Tanks/Resources/TanksSettings.asset`: `Mirror`, `FishNet`, `PurrNet` или `NGO`. В этом же asset хранится адрес и порт релея.

Вы также можете переключить его:

* в Unity Editor, с помощью меню **Tanks > Netcode** — это также открывает сцену этого netcode,
* в игре, с кнопками netcode в верхней части экрана, до хоста или подключения,
* из командной строки, с помощью `-netcode FishNet`.

| Netcode | Версия | Синхронизация Tank                                                                         |
| ------- | ------ | ------------------------------------------------------------------------------------------ |
| Mirror  | 66.0.9 | `SyncVar`, `Command`, `ClientRpc`, клиент-авторитетный `NetworkTransform`                  |
| FishNet | 4.7.4  | `SyncVar<int>`, `ServerRpc`, `ObserversRpc`, клиент-авторитетный `NetworkTransform`        |
| PurrNet | 1.24.1 | `SyncVar<int>`, `ServerRpc`, `ObserversRpc`, авторитет у владельца `NetworkTransform`      |
| NGO     | 1.13.0 | `NetworkVariable<int>`, `ServerRpc`, `ClientRpc`, авторитет у владельца `NetworkTransform` |

{% hint style="warning" %}
**Хост и каждый игрок должны использовать один и тот же netcode.** Релей не проверяет совместимость netcode.
{% endhint %}

У каждого netcode есть свой транспорт релея, построенный на одном и том же клиенте релея (`RelayPeer`): `MirrorRelayTransport`, `FishNetRelayTransport`, `PurrNetRelayTransport` и `NgoRelayTransport`). Чтобы использовать релей в своей игре, скопируйте `LightNet` пакет и транспорт для вашего netcode.

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

### 1. Запустите релей локально

☑️ Из корня репозитория соберите и запустите образ релея:

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 -f relay-server/Dockerfile -t lightnet-relay:dev .
docker run -p 7777:7777/tcp -p 7777:7777/udp -p 7778:7778/tcp lightnet-relay:dev
```

{% endcode %}

☑️ Откройте `tanks` в Unity, выберите netcode и соберите с помощью **Tanks > Build Windows client**, или нажмите Play на `Assets/Tanks/Scenes/Boot.unity`.

☑️ В первой игре нажмите **Host**: на экране появится код комнаты. Во второй игре введите код и нажмите **Join room**.

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

### 2. Отправьте образ релея

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

☑️ Найдите данные вашего [Container Registry](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md) имя проекта и учётные данные.

☑️ Войдите в Edgegap Container Registry через Docker, используя имя проекта реестра, имя пользователя и токен:

{% tabs %}
{% tab title="Bash (Linux)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (Windows)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

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

{% code collapsedlinecount="10" %}

```bash
docker tag lightnet-relay:dev registry.edgegap.com/<project>/lightnet-relay:<tag>
docker push registry.edgegap.com/<project>/lightnet-relay:<tag>
```

{% endcode %}

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

{% hint style="warning" %}
Каждая организация получает свой собственный проект реестра, **убедитесь, что изменили команды под свои данные.**
{% endhint %}

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

### 3. Создайте версию приложения

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

* образ `registry.edgegap.com/<project>/lightnet-relay` и вашим тегом,
* ваше имя пользователя и токен Container Registry, чтобы Edgegap мог скачать ваш образ,
* ресурсы 0.25 vCPU и 512 МБ памяти,
* один [порт](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md) `7777`, названный `relay`, протокол **TCP/UDP**,
* необязательно, для [зашифрованного соединения](#encrypted-connection): второй порт `7778`, названный `relay-ws`, протокол **WS**, с **TLS Upgrade** включённым,
* [максимальная длительность](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md) 30 минут для тестирования.

{% hint style="warning" %}
Используйте одну запись порта с протоколом **TCP/UDP**, а не отдельные `7777` TCP и `7777` UDP-записи. Затем Edgegap назначает TCP и UDP один и тот же внешний порт, так что игрокам нужен только один номер порта.
{% endhint %}

Необязательные настройки релея, как [переменные окружения в версии приложения](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#injected-variables):

| Переменная                | По умолчанию | Что делает                                                                                                                                                                       |
| ------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `RELAY_TCP_PORT`          | `7777`       | порт для надёжных сообщений                                                                                                                                                      |
| `RELAY_UDP_PORT`          | `7777`       | порт для ненадёжных сообщений                                                                                                                                                    |
| `RELAY_MAX_PEERS`         | `256`        | максимум одновременных подключений по всем комнатам                                                                                                                              |
| `RELAY_IDLE_EXIT_SECONDS` | `600`        | останавливает релей, если за это время не существует ни одной комнаты, `0` = никогда (релеи, запущенные матчмейкером, останавливаются, когда заканчивается их последняя комната) |
| `RELAY_WS_PORT`           | `7778`       | порт для WebSocket-подключения, `0` = выключено                                                                                                                                  |
| `RELAY_MATCH_MAX_PLAYERS` | `4`          | игроков в комнате на релеях, запущенных матчмейкером; backfill заполняет до этого числа                                                                                          |
| `RELAY_MAX_ROOMS`         | `4`          | комнат на релей, запущенный матчмейкером                                                                                                                                         |
| `RELAY_SOLO_ROOM_SECONDS` | `120`        | закрывает комнату, в которой хост слишком долго один; затем игра снова ищет матч                                                                                                 |
| `MATCHMAKER_URL`          |              | URL API матчмейкера, для [backfill](#optional-matchmaking)                                                                                                                       |
| `MATCHMAKER_TOKEN`        |              | токен авторизации матчмейкера, для backfill                                                                                                                                      |

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

### 4. Разверните и играйте

☑️ [Разверните новую версию приложения](https://app.edgegap.com/deployment-management/deployments/create) рядом с вашими игроками. Когда оно будет готово, запишите его имя хоста (`<id>.pr.edgegap.net`) и внешний порт `relay`.

☑️ В обеих играх **заранее задайте адрес и порт релея на экране перед подключением**, или запустите их из командной строки (альтернатива):

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -relay <id>.pr.edgegap.net -relayPort <external port> -host
Tanks.exe -netcode NGO -relay <id>.pr.edgegap.net -relayPort <external port> -join <code>
```

{% endcode %}

☑️ Создайте комнату в первой игре и присоединитесь к ней с кодом из второй.

{% hint style="info" %}
В логах релея видно игрока, который подключается и сразу уходит после запуска развёртывания: это проверка готовности Edgegap, а не игрок.
{% endhint %}

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fz9xjzvZwKSIp9IeC9qo8%2Fimage.png?alt=media&amp;token=e3f345ac-848d-4469-b66f-3655cd393cf3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Внешний порт вашего развёртывания в облаке Edgegap будет выбран случайным образом, чтобы потенциальный злоумышленник (хакер) замедлялся и обнаруживался до того, как сможет нанести ущерб.
{% endhint %}

{% hint style="warning" %}
**Отключите VPN при тестировании** для более реалистичных условий и получения [развёртывания с низкой задержкой](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#server-placement).
{% endhint %}

☑️ Как только вы убедитесь, что можете подключиться к вашему развёртыванию без проблем и завершите тестирование, **Остановите ваше развёртывание** чтобы освободить ресурсы в вашем аккаунте для следующей сборки.

* Если вы столкнётесь с проблемами, [просмотрите логи на Панели управления вашего развёртывания](https://app.edgegap.com/deployment-management/deployments/list).
* Если вы не сможете разобраться с проблемой, мы сидим в нашем [сообществе Discord](https://discord.gg/NgCnkHbsGp) и будем рады помочь.

🙌 Поздравляем с вашим первым развёртыванием в Edgegap! Если хотите узнать больше, продолжайте чтение.

## 🎯 Необязательный Matchmaking

Коды комнат работают среди друзей. Чтобы подбирать игроков, которые не знают друг друга, включите Edgegap [Matchmaking](https://docs.edgegap.com/ru/learn/matchmeiking.md): игроки нажимают **Найти матч**, матчмейкер группирует от 2 до 4 игроков рядом друг с другом и запускает для их матча релей рядом с ними. Затем релей выбирает одного игрока хостом и даёт остальным код комнаты, так что никто не вводит код. Игроки, которые нажимают **Найти матч** позже, присоединяются к комнатам со свободными местами, а релей, у которого все комнаты заполнены, открывает новые, прежде чем матчмейкер запустит ещё один релей. По умолчанию это выключено, и подключение по коду продолжает работать рядом с ним.

Как начинается матч:

1. Игра каждого игрока измеряет свою задержку до маяков Edgegap и создаёт билет матчмейкинга.
2. Матчмейкер группирует билеты и развёртывает релей из версии вашего приложения. Edgegap передаёт этому релею список сопоставленных билетов (`MM_TICKET_IDS`).
3. Каждая игра подключается к релею по своему ID билета. Первый сопоставленный игрок, который запросит это, становится хостом комнаты матча, остальные присоединяются к ней. Билеты, которых нет в матче, отклоняются.
4. Пока в комнате есть свободные места, релей запрашивает у матчмейкера ещё игроков с помощью backfill. Когда каждая комната заполнена, он вместо этого предлагает новую комнату. См. шаг 3 ниже.
5. Когда заканчивается последняя комната, релей удаляет свои backfill и останавливает собственное развёртывание, так что завершённый матч ничего не стоит.

Релей, развёрнутый без матчмейкера, работает как и раньше, с кодами комнат.

### 1. Создайте Matchmaker

☑️ Откройте `matchmaker-config.json` из репозитория и установите `application.name` и `версию` на версию вашего приложения из шага 3:

{% code title="matchmaker-config.json" lineNumbers="true" expandable="true" collapsedlinecount="10" %}

```json
{
  "version": "3.3.3",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "profiles": {
    "casual": {
      "ticket_expiration_period": "30s",
      "ticket_removal_period": "1m",
      "group_inactivity_removal_period": "5m",
      "application": {
        "name": "lightnet-relay",
        "version": "<ваша версия>"
      },
      "rules": {
        "initial": {
          "match_size": {
            "type": "player_count",
            "attributes": {
              "team_count": 1,
              "min_team_size": 9999,
              "max_team_size": 9999
            }
          },
          "beacons": {
            "type": "latencies",
            "attributes": {
              "difference": 100,
              "max_latency": 150
            }
          }
        },
        "expansions": {
          "10": {
            "match_size": {
              "team_count": 1,
              "min_team_size": 2,
              "max_team_size": 4
            }
          }
        }
      }
    }
  }
}
```

{% endcode %}

В течение первых 10 секунд билет может присоединиться только к релею, где есть место (`min_team_size` `9999` не может быть выполнено). После 10 секунд применяется обычное правило, и от 2 до 4 ожидающих игроков получают новый релей.

Правило `beacons` удерживает игроков рядом с игроками поблизости: маяк учитывается, если задержка игрока до него меньше 150 мс, а задержки сопоставленных игроков до него должны отличаться друг от друга не более чем на 100 мс. Игра отправляет свои задержки в каждом билете (**Matchmaker Latency Beacons** в `TanksSettings.asset`, включено по умолчанию).

{% hint style="warning" %}
**Браузеры не могут пинговать маяки.** Для сборки WebGL используйте профиль без правила `beacons` и выключите **Matchmaker Latency Beacons** .
{% endhint %}

☑️ В панели управления откройте [Matchmaker](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list), нажмите **Create Matchmaker**, загрузите файл, затем **Create and Start**.

☑️ Когда матчмейкер **Online**, скопируйте его **API URL** и **Auth Token**.

{% hint style="info" %}
Auth Token безопасно встраивать в вашу игру: он позволяет игрокам создавать билеты и не даёт доступа к вашему аккаунту Edgegap.
{% endhint %}

☑️ Добавьте их в версию приложения как переменные окружения `MATCHMAKER_URL` и `MATCHMAKER_TOKEN`, чтобы релеи могли заполнять свободные места (шаг 3).

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

### 2. Найдите матч

☑️ В `tanks/Assets/Tanks/Resources/TanksSettings.asset`, включите **Use Matchmaker** и вставьте **Matchmaker Url** и **Matchmaker Token**. Профиль (`casual`) и имя порта (`relay`) уже соответствуют конфигурации выше.

☑️ Соберите игру, запустите две копии и нажмите **Найти матч** в обеих. Или запустите их из командной строки:

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -matchmaker https://<id>.edgegap.net -matchmakerToken <token> -findMatch
```

{% endcode %}

☑️ Обе игры показывают статус матча, затем одна становится хостом, а другая присоединяется: в обеих играх видны оба танка.

{% hint style="warning" %}
**Проверьте с двумя игроками.** Для матча нужно минимум 2 игрока, поэтому один билет продолжает поиск и истекает через 30 секунд.
{% endhint %}

Клиент матчмейкинга находится в `Assets/Tanks/Core/TanksMatchmaker.cs`, построен на [Edgegap Unity SDK](https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser). Он никогда не зависит от netcode: он помещает адрес релея в настройки и запускает игру как хост или как игрок, как это делают **Host** и **Join room** кнопки.

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

### 3. Один релей, несколько комнат

Релей, запущенный матчмейкером, продолжает работать для него после старта первого матча, через backfill. Backfill — это билет, принадлежащий релею и содержащий его собственный адрес. Когда матчмейкер помещает в него билет игрока, этот игрок получает адрес релея, запрашивает свою роль как остальные и присоединяется к комнате или становится хостом. Игре ничего дополнительного не нужно: это тот же **Найти матч** поток.

* **Сначала идут комнаты со свободными местами.** Пока в комнате меньше `RELAY_MATCH_MAX_PLAYERS` (по умолчанию `4`) игроков, в комнате или по пути к ней, релей держит для неё до 3 backfill. Игрок, помещённый туда, присоединяется к этой комнате.
* **Затем новые комнаты.** Когда каждая комната заполнена, а у ретранслятора меньше чем `RELAY_MAX_ROOMS` (по умолчанию `4`) комнат, он предлагает одну новую комнату. Помещённый туда игрок становится хостом, и комната заполняется так же, как и остальные.
* **Только ближайшие игроки.** Ретранслятор отправляет билеты самих игроков комнаты вместе со своими backfill-записями, поэтому `beacons` правило проверяет нового игрока по ним.
* **Хост, оставшийся один** на `RELAY_SOLO_ROOM_SECONDS` (по умолчанию `120`) получает сообщение о закрытии комнаты, и игра сама ищет другой матч.
* **Ретранслятор останавливается, когда заканчивается его последняя комната**, а не когда уходит один хост. Сначала он удаляет свои backfill-записи, поэтому ни один игрок не отправляется на уже исчезнувший ретранслятор.
* **Ограничения скорости.** Не более 5 backfill-записей могут быть открыты на один ретранслятор, и они создаются с интервалом не менее 0,3 секунды.

☑️ Когда матч уже идёт между двумя играми, нажмите **Найти матч** в третьей: она присоединяется к уже идущей комнате, и все три игры видят три танка.

☑️ Заполните комнату 4 играми, затем нажмите **Найти матч** в двух ещё: первая создаёт новую комнату на том же ретрансляторе, а вторая присоединяется к ней.

{% hint style="info" %}
Без `MATCHMAKER_URL` и `MATCHMAKER_TOKEN` в версии приложения ретранслятор пишет в журнал `backfill: выкл.`: его комнаты не принимают новых игроков, и он не открывает новых комнат.
{% endhint %}

Код backfill ретранслятора находится в `relay-server/MatchBackfill.cs` и `relay-server/RelayServer.cs`.

## 🔒 Зашифрованное соединение

По умолчанию игровой трафик через ретранслятор **не зашифрован**: он передаётся по обычным TCP и UDP. Игроков защищает то, что никто не видит IP-адрес другого игрока, а при использовании matchmaker код комнаты получают только сопоставленные игроки. Обращения к matchmaker используют HTTPS.

Для шифрования игроки могут подключаться через WebSocket. При **TLS Upgrade** на `relay-ws` порту (шаг 3) Edgegap хранит сертификат, и соединение `wss://`: трафик между каждым игроком и Edgegap зашифрован, и ретранслятору не нужен сертификат.

☑️ Укажите игре `wss://` адрес ретранслятора вместо имени хоста, с внешним портом `relay-ws`: на экране, в `TanksSettings.asset`, или в командной строке:

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -relay wss://<id>.pr.edgegap.net:<relay-ws external port> -host
```

{% endcode %}

☑️ В matchmaker включите **Использовать WebSocket в Matchmaker** в `TanksSettings.asset` (или `-matchmakerWebSocket`): игра подключается к `relay-ws` порту.

{% hint style="warning" %}
**WebSocket работает только поверх TCP**: сообщения «unreliable» доставляются надёжно и по порядку, что добавляет задержку при плохом соединении. Он лучше подходит для кооперативных и пошаговых игр, чем для быстрых шутеров, поэтому это вариант наряду с TCP и UDP. Игроки на TCP и UDP и игроки на WebSocket могут находиться в одной комнате.
{% endhint %}

{% hint style="info" %}
Подключайтесь по имени хоста (`<id>.pr.edgegap.net`), а не по IP-адресу: сертификат выдан на имя хоста. Шифрование заканчивается на Edgegap: ретранслятор и игра хоста по-прежнему видят то, что они пересылают, как и любой ретранслятор.
{% endhint %}

## 🌐 Игра в браузере

Сборка WebGL этой игры работает через тот же ретранслятор по `wss://`. Игрок в браузере может создать комнату или присоединиться к ней на всех четырёх netcode и поделиться ею с игроками в десктопных сборках.

У браузеров нет сокетов TCP или UDP, а у сборок WebGL нет .NET `ClientWebSocket` и нет потоков. Поэтому в сборке WebGL LightNet из примера использует собственный WebSocket браузера через небольшой мост, `LightNet/Runtime/Relay/RelayWebSocket.jslib`. Транспорты netcode такие же, как на десктопе.

☑️ В Unity выберите **Tanks > Build WebGL client**. Сборка помещается в `tanks/Builds/WebGL`, без сжатия, поэтому её может раздавать любой статический файловый сервер.

☑️ Откройте страницу с адресом ретранслятора `wss://` в URL, используя внешний порт `relay-ws`. У сборки WebGL нет командной строки, поэтому она считывает те же параметры из адреса страницы. Поле ретранслятора и **Host** и **Join room** кнопки на экране тоже работают.

{% code collapsedlinecount="10" %}

```
index.html?netcode=FishNet&relay=wss://<id>.pr.edgegap.net:<relay-ws external port>&host
index.html?netcode=FishNet&relay=wss://<id>.pr.edgegap.net:<relay-ws external port>&join=<room code>
```

{% endcode %}

{% hint style="warning" %}
**Держите вкладку хоста на переднем плане.** Браузеры приостанавливают страницы во вкладках на заднем плане, поэтому комната, размещённая в браузере, останавливается, когда её вкладка скрыта. Десктопная сборка делает хост более стабильным.
{% endhint %}

{% hint style="info" %}
Страница, загруженная по HTTPS, может открывать только `wss://`, а не `ws://`. В браузере весь трафик доставляется надёжно и по порядку, как и при любом WebSocket-соединении. При использовании matchmaker браузеры не могут пинговать маяки, поэтому используйте профиль без правила `beacons` .
{% endhint %}

## 🧪 Автоматический тест

При сборке для Windows и работающем ретрансляторе (локальном или на Edgegap), `e2e.sh` запускает хост и клиент для каждого netcode:

{% code collapsedlinecount="10" %}

```bash
./e2e.sh <id>.pr.edgegap.net <external port>
./e2e.sh 127.0.0.1 7777 FishNet NGO
./e2e.sh wss://<id>.pr.edgegap.net:<relay-ws external port> 0
```

{% endcode %}

Клиент едет и стреляет. Netcode считается пройденным, когда обе игры видят два танка, обе получили данные по надёжному и ненадёжному каналам, обе увидели появление снаряда, а хост увидел, как двигается танк клиента.

С matchmaker, `e2e-matchmaker.sh` запускает тот же тест через него: для каждого netcode две игры нажимают **Найти матч** и играют матч на ретрансляторе, который запустил matchmaker. С `BACKFILL=1`, третья игра нажимает **Найти матч** после запуска матча и должна присоединиться к нему через backfill. С `MULTIROOM=1`, четыре игры заполняют комнату, затем пятая должна создать новую комнату на том же ретрансляторе, а шестая должна присоединиться к ней. С `MM_WEBSOCKET=1`, игры подключаются по `wss://`.

{% code collapsedlinecount="10" %}

```bash
./e2e-matchmaker.sh https://<id>.edgegap.net <token>
./e2e-matchmaker.sh https://<id>.edgegap.net <token> FishNet NGO
BACKFILL=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
MM_WEBSOCKET=1 BACKFILL=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
MULTIROOM=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
```

{% endcode %}

## 💡 Полезно знать

* **Как ретранслятор пересылает данные** - сообщения хоста идут одному игроку, а сообщения каждого игрока — только хосту. Игроки никогда не общаются друг с другом напрямую. Надёжные сообщения идут по TCP, ненадёжные — по UDP, либо и те и другие через один WebSocket.
* **Размер сообщения** - до 1 177 байт на одно ненадёжное сообщение и 16 КБ на одно надёжное сообщение. Транспорты сообщают эти ограничения своему netcode.
* **Когда хост уходит** - комната закрывается, и ретранслятор отключает своих игроков. Netcode в этом примере не мигрируют хоста.
* **Один ретранслятор или много** - одно развёртывание обслуживает много комнат, когда игроки используют коды комнат. С [matchmaker](#optional-matchmaking), каждый ретранслятор обслуживает до `RELAY_MAX_ROOMS` комнат рядом со своими игроками, а новый ретранслятор запускается только тогда, когда ближайшие ретрансляторы заполнены.
* **Изменения в LightNet** - LightNet из примера работает за NAT и при пробросе портов: ретранслятор отвечает на UDP-трафик каждого игрока с адреса, с которого он пришёл. Полный список см. в README репозитория.
