> 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/fr/docs/sample-projects/unity-netcodes/playfab-spaceedge.md).

# PlayFab SpaceEdge

Un jeu de tir spatial Unity où PlayFab Matchmaking associe les joueurs, puis où deux Azure Functions démarrent un serveur dédié Edgegap à proximité pour chaque match.

Découvrez comment conserver **PlayFab Matchmaking** et exécuter chaque partie sur son propre serveur dédié **Edgegap** avec le [exemple SpaceEdge PlayFab](https://github.com/edgegap/backend-game-sample-unity-playfab-matchmaker-fishnet-spaceedge), un petit jeu de tir spatial Unity basé sur FishNet.

Les joueurs se connectent à PlayFab et appuient sur **Démarrer la partie**. Lorsque PlayFab les met en relation, une fonction Azure démarre un serveur Edgegap à proximité, puis une deuxième transmet à chaque joueur l’adresse et un jeton de connexion. Le serveur n’admet que les joueurs mis en relation et s’arrête lorsqu’ils partent.

Cet exemple montre :

* **Unity 2021.3.45f2** projet sur **FishNet 3.11.14** (Tugboat, UDP 7770), compilé comme serveur dédié Linux avec le [plug-in Unity Edgegap](https://github.com/edgegap/buildtool-unity-plugin),
* **PlayFab Matchmaking** sans allocation de serveur : PlayFab forme la partie, Edgegap l’héberge,
* **deux fonctions Azure** (Node.js 22, sans SDK) : l’une déploie le serveur sur `match_found`, l’autre reçoit le webhook de disponibilité d’Edgegap et écrit l’adresse dans les données en lecture seule de chaque joueur,
* **jetons de connexion**: le serveur n’admet que les joueurs mis en relation par PlayFab, sans détenir de secret PlayFab,
* **arrêt automatique du serveur**: le serveur arrête son propre déploiement si personne ne rejoint la partie ou lorsque tout le monde est parti.

{% hint style="info" %}
Vérifié de bout en bout sur Edgegap le 21 octobre 2026 avec des clients Windows et une file d’attente PlayFab de 2 joueurs : l’adresse est parvenue aux deux joueurs environ 8 secondes après l’appel de la fonction. Les jetons de connexion et la compilation du plug-in ont été ajoutés ultérieurement et testés avec des tests unitaires et un conteneur de serveur local.
{% endhint %}

{% hint style="success" %}
[Déployer depuis PlayFab](https://docs.edgegap.com/fr/docs/tools-and-integrations/playfab-bridge.md) explique chaque étape pour ajouter Edgegap à votre propre jeu PlayFab.
{% endhint %}

## ✔️ Préparation

{% hint style="info" %}
Cet exemple a été développé et testé avec Unity `2021.3.45f2` — veuillez utiliser la même version.
{% endhint %}

Avant de commencer, assurez-vous de [créer un compte gratuit avec Edgegap](https://app.edgegap.com/auth/register) (aucune carte de crédit requise). Vous pouvez [inviter les membres de votre équipe ensuite](https://app.edgegap.com/user-settings?tab=organizations), même s’ils n’ont pas encore de compte Edgegap.

**Configurez quelques éléments essentiels sur votre machine de développement :**

<details>

<summary>Installer les modules de prise en charge de compilation Linux pour Unity</summary>

* Utilisez Unity Hub pour sélectionner l'onglet **Installe**, accéder à **Paramètres** et **Ajouter des modules** pour chaque version d'Unity que vous avez l'intention d'utiliser avec la plateforme Edgegap :

<figure><img src="https://3008966946-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>

* Faites défiler vers le bas pour sélectionner et installer les modules Unity suivants :
  * **Prise en charge de compilation Linux (IL2CPP),**
    * **Prise en charge de compilation Linux (Mono),**
    * **Prise en charge de compilation pour serveur dédié Linux**

<figure><img src="https://3008966946-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/">Installez Docker Desktop (ou Docker CLI)</a></summary>

* [Installez Docker Desktop à partir de la source officielle](https://www.docker.com/products/docker-desktop/) (aucun compte requis).
* Redémarrez votre ordinateur après avoir terminé l'installation.

</details>

* un [PlayFab](https://developer.playfab.com) titre, son ID de titre et une clé secrète,
* un abonnement Azure et l’ [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli),
* un jeton API Edgegap depuis [Dashboard → User Settings → Tokens](https://app.edgegap.com/user-settings?tab=tokens). Il doit uniquement figurer dans les paramètres de l’application de fonction, jamais dans le jeu.

## ⚡ Exécuter l’exemple

### 1. Serveur de jeu

{% hint style="info" %}
Consultez un guide plus détaillé pour cette étape dans le [Unity](https://docs.edgegap.com/fr/unity.md) guide de démarrage.
{% endhint %}

Ouvrez `SpaceEdge_project` dans Unity, puis sélectionnez **Tools → Edgegap Server Hosting**:

1. **Connectez-vous à Edgegap**, puis **Serveur de build**.
2. **Conteneuriser avec Docker**: nom de l’image `playfab-fishnet`, laissez le tag de l’image vide (le plug-in utilise l’heure UTC actuelle).
3. **Téléverser vers Edgegap**: application `playfab-fishnet`, puis **Téléverser l’image et créer une version de l’application**. Dans le formulaire de version qui s’ouvre, configurez un port nommé `gameport`, 7770, UDP, et 0,5 vCPU / 1 Go. Conservez le nom de version proposé : les Azure Functions en ont besoin.

{% hint style="info" %}
Aucune variable d’environnement ni aucun secret n’est nécessaire pour le serveur ; les fonctions transmettent les détails du déploiement de la partie.
{% endhint %}

### 2. Titre PlayFab

1. Créer une file d’attente de matchmaking `edgegap-fishnet`, taille de partie de 2 à 2, avec **Activer l’allocation de serveur** désactivé.
2. Dans **Paramètres du titre → Fonctionnalités de l’API**, décochez **Désactiver la création de joueurs avec Client/LoginWithCustomId**.
3. Créez une clé secrète dans **Paramètres du titre → Clés secrètes**.

### 3. Azure Functions

Déployez le dossier `azure-functions` de l’exemple dans une Function App Flex Consumption avec Node.js 22, puis configurez ses paramètres d’application comme indiqué dans [Déployer depuis PlayFab](https://docs.edgegap.com/fr/docs/tools-and-integrations/playfab-bridge.md). Utilisez votre application `playfab-fishnet` et le nom de version de l’étape 1. Enregistrez ensuite `StartEdgegapDeployment` dans PlayFab et ajoutez la règle sur `playfab.matchmaking.match_found`.

### 4. Jouer une partie

1. Ouvrez la scène `Assets/SpaceEdge/Scenes/MainMenu`, puis, sur l’objet `PlayfabRestApiService` , définissez votre **ID de titre**. Le nom de la file d’attente est déjà `edgegap-fishnet`.
2. Créez le client de test Windows (Mono, aucun module IL2CPP pour Windows n’est nécessaire), puis exécutez-le deux fois avec deux joueurs 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. Appuyez sur **Démarrer la partie** dans les deux. Une fois que PlayFab les a associés, un déploiement portant le début de l’ID de la partie apparaît dans le [tableau de bord Edgegap](https://app.edgegap.com/deployment-management/deployments/list), et les deux clients se connectent quelques secondes plus tard.
4. Fermez les deux clients : le serveur s’arrête automatiquement en moins d’une minute.

{% hint style="info" %}
L’offre gratuite ne permet qu’un seul déploiement à la fois : arrêtez les autres déploiements avant de faire le test.
{% endhint %}

## 🔧 Limites connues

* **2 joueurs par partie.** Seules les files d’attente de 2 joueurs ont été testées. Pour des parties plus grandes, augmentez la taille de la partie dans la file d’attente et refaites le test.
* **Seuls les clients Windows ont été testés.** Le code client utilise uniquement `UnityWebRequest` et `JsonUtility`, il pourrait donc fonctionner dans WebGL, mais une version web nécessiterait également un transport WebSocket et un port.
