> 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/playfab-spaceedge.md).

# PlayFab SpaceEdge

Космический шутер на Unity, в котором PlayFab Matchmaking подбирает игроков, а две функции Azure запускают выделенный сервер Edgegap рядом с ними для каждого матча.

Узнайте, как связать **PlayFab Matchmaking** и запускать каждый матч на отдельном **Edgegap** выделенном сервере с помощью [примера SpaceEdge для PlayFab](https://github.com/edgegap/backend-game-sample-unity-playfab-matchmaker-fishnet-spaceedge), небольшого космического шутера на Unity с FishNet.

Игроки входят в PlayFab и нажимают **Начать игру**. Когда PlayFab подбирает им соперников, функция Azure запускает поблизости сервер Edgegap, а вторая функция передаёт каждому игроку адрес и токен для подключения. Сервер допускает только подобранных игроков и останавливается, когда они выходят.

В этом примере показаны:

* **проект Unity 2021.3.45f2 на** с использованием **FishNet 3.11.14** (Tugboat, UDP 7770), собранный как выделенный сервер Linux с помощью [плагина Edgegap для Unity](https://github.com/edgegap/buildtool-unity-plugin),
* **PlayFab Matchmaking** с отключённым распределением серверов: PlayFab формирует матч, а Edgegap размещает сервер;
* **две функции Azure** (Node.js 22, без SDK): одна развёртывает сервер при событии `match_found`, другая получает вебхук о готовности от Edgegap и записывает адрес в данные каждого игрока, доступные только для чтения;
* **токены для подключения**: сервер допускает только игроков, подобранных PlayFab, и не хранит секреты PlayFab;
* **автоматическая остановка сервера**: сервер останавливает собственное развёртывание, если никто не подключился или все игроки вышли.

{% hint style="info" %}
Сквозное тестирование на Edgegap проведено 21 октября 2026 года с клиентами Windows и очередью PlayFab на 2 игрока: адрес был передан обоим игрокам примерно через 8 секунд после вызова функции. Токены для подключения и сборка плагина появились позже; их проверили модульными тестами и с помощью локального контейнера сервера.
{% endhint %}

{% hint style="success" %}
[В разделе «Развёртывание из PlayFab»](https://docs.edgegap.com/ru/docs/tools-and-integrations/playfab-bridge.md) рассматривается каждый этап добавления Edgegap в вашу игру на PlayFab.
{% endhint %}

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

{% hint style="info" %}
Этот пример разработан и протестирован в Unity `2021.3.45f2` — используйте ту же версию.
{% endhint %}

Прежде чем начать, обязательно [создайте бесплатную учетную запись в Edgegap](https://app.edgegap.com/auth/register) (кредитная карта не требуется). Вы можете [позже пригласить членов вашей команды](https://app.edgegap.com/user-settings?tab=organizations), даже если у них ещё нет учётной записи Edgegap.

**Настройте несколько основных параметров на вашей машине для разработки:**

<details>

<summary>Установите модули поддержки сборки Unity для Linux</summary>

* Используйте Unity Hub, чтобы выбрать вкладку **Устанавливает**, доступ **Настройки** и **Добавить модули** для каждой версии Unity, которую вы планируете использовать с платформой Edgegap:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FylRG4r8orenZrw5ijjpJ%2Fimage.png?alt=media&amp;token=fb981825-8a15-4c07-9180-0f79a6a77a91" alt=""><figcaption></figcaption></figure>

* Прокрутите вниз, чтобы выбрать и установить следующие модули Unity:
  * **Поддержка сборки для Linux (IL2CPP),**
    * **Поддержка сборки для Linux (Mono),**
    * **Поддержка сборки выделенного сервера для Linux**

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FuXtyqoLhBOk8CZJ4WdzA%2Fimage.png?alt=media&amp;token=19e956ed-a731-420d-b911-130c334794fc" alt=""><figcaption></figcaption></figure>

</details>

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

* идентификатор [PlayFab](https://developer.playfab.com) проекта, его Title ID и секретный ключ;
* подписка Azure и [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli),
* токен API Edgegap из раздела [Dashboard → User Settings → Tokens](https://app.edgegap.com/user-settings?tab=tokens). Он указывается только в настройках приложения Function App, но не в игре.

## ⚡ Запуск примера

### 1. Игровой сервер

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

Откройте `SpaceEdge_project` в Unity, затем выберите **Tools → Edgegap Server Hosting**:

1. **Войдите в Edgegap**затем **Сервер сборки**.
2. **Создание контейнера с помощью Docker**: имя образа `playfab-fishnet`, тег образа оставьте пустым (плагин использует текущее время UTC).
3. **Загрузка в Edgegap**: приложение `playfab-fishnet`, затем **Загрузить образ и создать версию приложения**. В открывшейся форме версии задайте один порт с именем `gameport`, 7770, UDP и 0,5 vCPU / 1 ГБ. Оставьте предложенное имя версии: оно понадобится Azure Functions.

{% hint style="info" %}
Для сервера не нужны переменные среды и секреты: функции передают сведения о матче и развертывании.
{% endhint %}

### 2. Заголовок PlayFab

1. Создайте очередь подбора игроков `edgegap-fishnet`, размер матча — 2–2, параметр **Enable server allocation** отключите.
2. В разделе **Title settings → API Features**снимите флажок **Disable player creation using Client/LoginWithCustomId**.
3. Создайте секретный ключ в разделе **Title settings → Secret Keys**.

### 3. Azure Functions

Разверните папку примера `azure-functions` в приложении Flex Consumption Function App на Node.js 22 и задайте параметры приложения, как описано в разделе [Развертывание из PlayFab](https://docs.edgegap.com/ru/docs/tools-and-integrations/playfab-bridge.md). Используйте приложение `playfab-fishnet` и имя версии из шага 1. Затем зарегистрируйте `StartEdgegapDeployment` в PlayFab и добавьте правило для `playfab.matchmaking.match_found`.

### 4. Сыграйте матч

1. Откройте сцену `Assets/SpaceEdge/Scenes/MainMenu`, а в объекте `PlayfabRestApiService` укажите свой **Title Id**. Имя очереди уже задано: `edgegap-fishnet`.
2. Соберите тестовый клиент для Windows (Mono, модуль Windows IL2CPP не требуется) и запустите его дважды от имени двух игроков PlayFab:

```bash
"<Unity>" -batchmode -projectPath SpaceEdge_project -executeMethod EdgegapPluginBuild.BuildClient -logFile build-client.log
SpaceEdge_project/Builds/Client/win64/Game.exe -playfabCustomId player-a
SpaceEdge_project/Builds/Client/win64/Game.exe -playfabCustomId player-b
```

3. Нажмите **Начать игру** в обоих клиентах. Когда PlayFab сопоставит их, на [панели управления Edgegap](https://app.edgegap.com/deployment-management/deployments/list)появится развёртывание с идентификатором, начинающимся с идентификатора матча, а через несколько секунд оба клиента подключатся.
4. Закройте оба клиента: сервер остановится автоматически в течение минуты.

{% hint style="info" %}
На бесплатном тарифе одновременно может работать только одно развёртывание: перед тестированием остановите остальные.
{% endhint %}

## 🔧 Известные ограничения

* **2 игрока в матче.** Проверялись только очереди на 2 игроков. Для матчей с большим числом игроков увеличьте размер матча в очереди и повторите тестирование.
* **Проверялись только клиенты для Windows.** В коде клиента используются только `UnityWebRequest` и `JsonUtility`, поэтому он может работать в WebGL, но для веб-сборки также потребуются транспорт WebSocket и порт.
