> 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/web-games/matchmaking.md).

# Matchmaking

Ajoutez du matchmaking à votre jeu dans le navigateur avec le SDK JavaScript optionnel d'Edgegap, prêt à être étendu et personnalisé à mesure que votre projet multijoueur grandit.

Ce SDK est un kit de démarrage optionnel pour les utilisateurs de JavaScript et TypeScript, qui peut être étendu et personnalisé par la suite.

## 💡 Fonctionnalités

{% columns %}
{% column %}

* Exemples complets
* Promises et boucles asynchrones
* Tickets, groupes, équipes
  {% endcolumn %}

{% column width="33.33333333333333%" %}

* Variables de correspondance
* Définitions de types (TypeScript)
* Automatisation du backfill
  {% endcolumn %}

{% column width="33.33333333333333%" %}

* Navigateur, Node.js, Bun, Deno
* Aucune dépendance
* Réessai automatique
  {% endcolumn %}
  {% endcolumns %}

## ✔️ Préparation

Le SDK JavaScript contient des utilitaires d’intégration optionnels pour les déploiements et le matchmaking. Ce package prend officiellement en charge tous les navigateurs evergreen, Node.js 22 et versions ultérieures, Bun et Deno.

{% hint style="info" %}
**La dernière version du SDK JavaScript est `1.1.0`**. Tous les exemples de cette documentation sont à jour.
{% endhint %}

{% hint style="success" %}
Ce package est fourni 100 % gratuitement, conformément aux conditions générales du Free Tier.
{% endhint %}

#### Prérequis

<details>

<summary>Autorisez les origines web de votre jeu dans la configuration du Matchmaker</summary>

Les navigateurs n’appellent votre Matchmaker que depuis des pages dont l’origine est répertoriée dans `allowed_cors_origins` de la configuration de votre Matchmaker. Les entrées sont comparées à l’origine complète, y compris le schéma et le port :

* `https://*.my-game.com` correspond à tous les sous-domaines en HTTPS,
* `localhost` ne correspond à rien, listez les serveurs de développement locaux en entier, par exemple `http://localhost:5173` .

</details>

<details>

<summary>Activez la mise à niveau TLS pour le port WebSocket de votre serveur de jeu</summary>

Définissez votre [port de la version de l’application](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#port-mapping) au protocole `WS` et activez **la mise à niveau TLS**pour que les navigateurs puissent se connecter via des WebSockets sécurisés (`wss://`).

</details>

#### Installation

Installez le package depuis npm avec votre gestionnaire de paquets préféré :

{% tabs %}
{% tab title="npm" %}
{% code collapsedlinecount="10" %}

```bash
npm install @edgegap/sdk
```

{% endcode %}
{% endtab %}

{% tab title="pnpm" %}
{% code collapsedlinecount="10" %}

```bash
pnpm add @edgegap/sdk
```

{% endcode %}
{% endtab %}

{% tab title="yarn" %}
{% code collapsedlinecount="10" %}

```bash
yarn add @edgegap/sdk
```

{% endcode %}
{% endtab %}

{% tab title="bun" %}
{% code collapsedlinecount="10" %}

```bash
bun add @edgegap/sdk
```

{% endcode %}
{% endtab %}

{% tab title="deno" %}
{% code collapsedlinecount="10" %}

```bash
deno add npm:@edgegap/sdk
```

{% endcode %}
{% endtab %}

{% tab title="CDN (sans bundler)" %}
Chargez la build navigateur dans des jeux HTML sans bundler. Tout est exposé sous `Edgegap` global, avec le matchmaking sous `Edgegap.matchmaking`:

{% code collapsedlinecount="10" %}

```html
<script src="https://cdn.jsdelivr.net/npm/@edgegap/sdk@1.1.0/dist/browser/edgegap.iife.js"></script>
```

{% endcode %}

Ou importez-le comme module ES :

{% code collapsedlinecount="10" %}

```html
<script type="module">
  import { matchmaking, getConnectionUrl } from 'https://cdn.jsdelivr.net/npm/@edgegap/sdk@1.1.0/dist/browser/edgegap.js'
</script>
```

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

Le package comporte deux points d’entrée :

* `@edgegap/sdk/matchmaking` :
  * `GroupAgent`, `ServerAgent`, `MatchEnvironment`, `MatchmakingError`, `Api` .
* `@edgegap/sdk` - utilitaires partagés :
  * `getConnectionUrl`, `DeploymentEnvironment` .
  * `Observable`, `Logger`, divers utilitaires HTTP.

#### Sources vérifiées

Ce package n’est publié sur npm que sous [`@edgegap/sdk`](https://www.npmjs.com/package/@edgegap/sdk), à partir du code source sur [GitHub](https://github.com/edgegap/sdk-js-sessions-matchmaker-server-browser). Des CDN comme jsDelivr et unpkg répliquent le package npm. Ne faites pas confiance aux sources non vérifiées, les packages portant des noms similaires en dehors de `@edgegap` ne sont pas affiliés à Edgegap !

{% hint style="success" %}
**Chaque version est publiée par GitHub Actions avec** [**la provenance npm**](https://docs.npmjs.com/generating-provenance-statements), liant le package au commit qui l’a généré. Vérifiez les packages installés avec `les signatures de npm audit` .
{% endhint %}

{% hint style="info" %}
Lors du chargement depuis un CDN, épinglez la version exacte avec [l’intégrité des sous-ressources](https://developer.mozilla.org/docs/Web/Security/Subresource_Integrity) pour refuser les versions modifiées.
{% endhint %}

### Mettre à jour le package

Mettez à jour vers la dernière version avec votre gestionnaire de paquets :

{% code collapsedlinecount="10" %}

```bash
npm install @edgegap/sdk@latest
```

{% endcode %}

Lors du chargement depuis un CDN, modifiez la version dans l’URL et régénérez votre hachage d’intégrité.

{% hint style="info" %}
Certaines versions peuvent contenir des changements incompatibles. Cela sera indiqué par une nouvelle version MAJEURE.
{% endhint %}

## 🍀 Démarrage

Ce guide suppose des connaissances de base en [Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md) et un Matchmaker en cours d’exécution.

{% hint style="success" %}
**Nous vous recommandons vivement de cloner notre** [**Three.js Minigames**](#three.js-minigames) **exemple** pour suivre le code au fil de votre lecture de ce document.
{% endhint %}

### Vue d’ensemble

Notre SDK utilise fortement le [Observer](https://refactoring.guru/design-patterns/observer) patron de programmation, et vous permet de consommer les changements avec des callbacks, [promesses](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise), ou [itération asynchrone](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/for-await...of) - selon ce qui convient à votre boucle de jeu.

{% hint style="info" %}
Ce package intègre [Matchmaking](https://docs.edgegap.com/fr/learn/matchmaking.md) et [les utilitaires de déploiement.](https://docs.edgegap.com/fr/learn/orchestration/deployments.md) Vous pouvez réutiliser librement tout code pour vos propres forks et intégrations personnalisés.
{% endhint %}

Ce package comprend :

* Utilitaires spécifiques au service :
  * [#group-agent](#group-agent "mention") - une intégration complète du client navigateur à réutiliser/étendre.
  * [#server-agent](#server-agent "mention") - une intégration complète de backfill pour serveur de jeu à réutiliser/étendre.
  * `MatchEnvironment` - des [variables de matchmaking](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-environment-variables) pour votre serveur de jeu.
  * `Api` - définitions des endpoints, gestion des erreurs et automatisations de nouvelle tentative.
* Types spécifiques au service - types de requête et de réponse correspondant exactement au JSON de l’API de matchmaking.
* Utilitaires partagés - URL de connexion, variables de déploiement, journalisation, HTTP, observables, etc...

### Agent de groupe

**La gestion des tickets, la récupération de l’hôte et la découverte des beacons** sont effectuées par l’Agent de groupe.

Une fois instancié, le **gestionnaire (votre code de jeu) doit initialiser l’agent** et fournir éventuellement :

* `onMonitorUpdate` callback - surveille les changements d’état du service.
* `onGroupUpdate` callback - surveillez et réagissez aux changements d’affectation de groupe et d’hôte.

Une fois initialisé, cet agent fournira automatiquement des validations et connectera les observateurs de journalisation, en terminant par un seul appel au point de terminaison de l’API de surveillance pour indiquer l’état du service.

Le gestionnaire de l’agent est censé prendre le contrôle et appeler les fonctions de l’agent à partir de ce point :

* `balises` pour récupérer la liste des disponibles [Balises de ping](https://docs.edgegap.com/fr/learn/orchestration/ping-beacons.md).
* `measureBeaconsRoundTripTime` pour fournir des mesures de ping pour un ensemble donné de balises.
* `createGroup` pour que le leader du salon crée un groupe rejoignable, auquel des amis peuvent être invités.
* `joinGroup` pour rejoindre un groupe existant à l’aide de l’ID du groupe envoyé via un salon / backend tiers.
* `setReady` pour marquer le propriétaire du groupe et les membres comme prêts et commencer la recherche de parties.
* `nextAssignment` pour attendre l’attribution de l’hôte une fois que le groupe commence la recherche.
* `resumeMatchmaking` pour charger un groupe sauvegardé et poursuivre la recherche au cas où la page aurait été rechargée.
* `stopMatchmaking` pour supprimer le ticket (s’il n’est pas apparié) et quitter la file d’attente.
* `dispose` pour effacer tous les minuteurs, annuler les requêtes et supprimer les abonnés.

Voici les trois différents modèles de concurrence présentés ; choisissez celui que vous préférez :

{% tabs %}
{% tab title="Promesse" %}
{% code collapsedlinecount="10" %}

```javascript
import { getConnectionUrl } from '@edgegap/sdk'
import { GroupAgent, MatchmakingError } from '@edgegap/sdk/matchmaking'

const agent = new GroupAgent({ baseUrl: '<matchmaker url>', authToken: '<matchmaker auth token>' })
agent.initialize()

const { beacons } = await agent.beacons()
const latencies = await agent.measureBeaconsRoundTripTime(beacons)

agent.createGroup({ profile: 'simple-example', attributes: { beacons: latencies }, is_ready: true }, true)

try {
  const assignment = await agent.nextAssignment()
  connect(getConnectionUrl(assignment, 'gameport'), agent.group.current.ticket_id)
} catch (error) {
  if (!(error instanceof MatchmakingError)) throw error
  showRetryButton(error.message)
}
```

{% endcode %}
{% endtab %}

{% tab title="Boucle asynchrone" %}
{% code collapsedlinecount="10" %}

```javascript
import { getConnectionUrl, ObservableActionType } from '@edgegap/sdk'
import { GroupAgent } from '@edgegap/sdk/matchmaking'

const agent = new GroupAgent({ baseUrl: '<matchmaker url>', authToken: '<matchmaker auth token>' })
agent.initialize()

const { beacons } = await agent.beacons()
const latencies = await agent.measureBeaconsRoundTripTime(beacons)

agent.createGroup({ profile: 'simple-example', attributes: { beacons: latencies }, is_ready: true }, true)

for await (const { type, message, event, current } of agent.group) {
  if (type === ObservableActionType.Error) {
    showRetryButton(message)
    break
  }
  if (event.code !== 'updated') continue
  showStatus(current.status)
  if (current.status === 'CANCELLED') {
    showRetryButton(message)
    break
  }
  if (current.status !== 'HOST_ASSIGNED') continue
  connect(getConnectionUrl(current.assignment, 'gameport'), current.ticket_id)
  break
}
```

{% endcode %}
{% endtab %}

{% tab title="Callbacks" %}
{% code collapsedlinecount="10" %}

```javascript
import { getConnectionUrl, ObservableActionType } from '@edgegap/sdk'
import { GroupAgent } from '@edgegap/sdk/matchmaking'

const agent = new GroupAgent({ baseUrl: '<matchmaker url>', authToken: '<matchmaker auth token>' })
agent.initialize(
  (_monitor, _type, message) => console.log('matchmaker', message),
  (group, type, message, event) => {
    if (type === ObservableActionType.Error) return showRetryButton(message)
    if (event.code !== 'updated') return
    showStatus(group.current.status)
    if (group.current.status === 'CANCELLED') return showRetryButton(message)
    if (group.current.status === 'HOST_ASSIGNED')
      connect(getConnectionUrl(group.current.assignment, 'gameport'), group.current.ticket_id)
  },
)

const { beacons } = await agent.beacons()
const latencies = await agent.measureBeaconsRoundTripTime(beacons)

agent.createGroup({ profile: 'simple-example', attributes: { beacons: latencies }, is_ready: true }, true)
```

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

`profile` et `attributes` doit correspondre à un profil dans votre configuration Matchmaker, `gameport` est le nom du port de votre version de l’application. `getConnectionUrl` renvoie une `wss://` URL pour les ports WebSocket.

{% hint style="warning" %}
**Les navigateurs ne peuvent pas envoyer les pings ICMP, UDP ou TCP auxquels répondent les balises Edgegap**, donc `measureBeaconsRoundTripTime` renvoie `0` pour chaque balise par défaut. Fournissez votre propre `ping` implémentation dans les options de l’agent pour mesurer la latence autrement.
{% endhint %}

Lorsqu’une nouvelle connexion de joueur est établie, le joueur est censé envoyer son ID de ticket au serveur de jeu via votre netcode, afin de corréler les connexions avec [variables de matchmaking](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-environment-variables). Votre serveur de jeu peut encore être en cours d’initialisation à ce moment-là, donc **les joueurs doivent réessayer la connexion plusieurs fois**:

{% code collapsedlinecount="10" %}

```javascript
const connect = (url, ticketId, attempts = 10) => {
  const socket = new WebSocket(url)
  let opened = false
  socket.onopen = () => {
    opened = true
    socket.send(JSON.stringify({ ticketId }))
  }
  socket.onclose = () => !opened && attempts > 1 && setTimeout(() => connect(url, ticketId, attempts - 1), 1000)
}
```

{% endcode %}

{% hint style="success" %}
Enregistrez les détails de connexion dans le client ou le backend du jeu pour vous reconnecter en cas de crash inattendu. Voir [#resume-after-reload](#resume-after-reload "mention").
{% endhint %}

### Agent de serveur

L’Agent de serveur effectue **la création de backfills, la détection de l’attribution des tickets, la détection de l’abandon et de la suppression des backfills. Il suit également et recrée les backfills qui ont expiré, dont le délai de grâce de connexion s’est écoulé, ou qui ont été abandonnés, afin d’atteindre la taille d’équipe souhaitée**.

L’Agent de serveur suit les joueurs actuellement connectés et inclut automatiquement leurs tickets dans les nouveaux backfills afin de garantir que les joueurs ajoutés par backfill seront appariés selon les règles du profil configuré.

Une fois instancié, le **gestionnaire (votre code serveur) doit initialiser l’agent** et fournir :

* `tickets` - les joueurs déjà appariés à ce serveur, depuis [variables de matchmaking](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-environment-variables).
* `onMonitorUpdate` callback - surveille les changements d’état du service.
* `onBackfillUpdate` callback - surveillez et réagissez aux changements de backfill.

Une fois initialisé, cet agent fournira automatiquement des validations et connectera les observateurs de journalisation, en terminant par un seul appel au point de terminaison de l’API de surveillance pour indiquer l’état du service.

Le gestionnaire du serveur est censé prendre le contrôle et appeler les fonctions de l’agent à partir de ce point :

* `addBackfills` pour créer des backfills jusqu’à ce que les joueurs attribués et les backfills ouverts atteignent la taille d’équipe cible.
* `playerConnected` pour empêcher le remplacement des joueurs initiaux ou ajoutés par backfill qui ne se sont jamais connectés.
  * Renvoie le ticket du joueur, ou `null` si le ticket n’est pas attribué à ce serveur - rejetez de telles connexions.
* `abandonPlayer` pour signaler qu’un joueur connecté a quitté le serveur et doit être remplacé.
* `abandonAllBackfills` pour arrêter immédiatement le backfill du serveur et supprimer les backfills.
  * Cette méthode doit être appelée avant l’arrêt de votre serveur. Les joueurs déjà attribués à ce moment doivent rejoindre à nouveau le matchmaking, car le serveur est en train de s’arrêter.
  * Les backfills attribués au moment de cet appel peuvent encore se connecter pendant le délai de grâce configuré.
* `abandonBackfill` pour abandonner de force un backfill spécifique (implémentations de gestionnaire personnalisées).
* `dispose` pour effacer les minuteurs, annuler les requêtes et supprimer les abonnés.

{% code collapsedlinecount="10" %}

```javascript
import { WebSocketServer } from 'ws'
import { DeploymentEnvironment } from '@edgegap/sdk'
import { MatchEnvironment, ServerAgent } from '@edgegap/sdk/matchmaking'

const deployment = DeploymentEnvironment.fromEnv(process.env)
const match = MatchEnvironment.fromEnv(process.env)

const agent = new ServerAgent({
  baseUrl: process.env.MATCHMAKER_URL,
  authToken: process.env.MATCHMAKER_TOKEN,
  profile: match.matchProfile,
  targetTeamSize: 4,
  attributes: {
    assignment: {
      request_id: deployment.requestId,
      fqdn: deployment.fqdn,
      public_ip: deployment.publicIp,
      ports: deployment.portMapping,
      location: deployment.location,
    },
  },
})

agent.initialize(
  match.tickets,
  (_monitor, _type, message) => console.log('matchmaker', message),
  (_backfills, _type, _message, event) => {
    if (event.code === 'assigned') console.log(`le ticket ${event.ticketId} rejoint`)
  },
)
agent.addBackfills()

const wss = new WebSocketServer({ port: 7777 })

wss.on('connection', (socket) => {
  socket.once('message', (data) => {
    const { ticketId } = JSON.parse(data.toString())
    if (!agent.playerConnected(ticketId)) return socket.close(4001, 'ticket inconnu')
    socket.once('close', () => agent.abandonPlayer(ticketId))
  })
})

process.once('SIGTERM', () => agent.abandonAllBackfills(() => process.exit(0)))
```

{% endcode %}

{% hint style="danger" %}
**Chargez les jetons du serveur depuis les variables d’environnement**, par exemple en utilisant [Variables de version de l’application](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#injected-variables). Les jetons utilisés par vos serveurs de jeu ne doivent jamais être inclus dans un bundle de navigateur.
{% endhint %}

### Variables de correspondance

Lire [variables de matchmaking](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#injected-environment-variables) dans votre serveur de jeu pour vérifier les joueurs qui se connectent et attribuer les équipes, sans appeler d’API :

{% code collapsedlinecount="10" %}

```javascript
import { WebSocketServer } from 'ws'
import { MatchEnvironment } from '@edgegap/sdk/matchmaking'

const match = MatchEnvironment.fromEnv(process.env)
const wss = new WebSocketServer({ port: 7777 })

wss.on('connection', (socket) => {
  socket.once('message', (data) => {
    const { ticketId } = JSON.parse(data.toString())
    const ticket = match.tickets[ticketId]
    if (!ticket) return socket.close(4001, 'ticket inconnu')
    console.log(`le joueur a rejoint l’équipe ${ticket.team_id} dans le match ${match.matchId}`)
  })
})
```

{% endcode %}

`match` contient `matchProfile`, `matchId`, `tickets` (par ID de ticket), `groupes`, `équipes`ainsi que les `égalité` et `intersection` valeurs correspondantes. Le parsing ne lève jamais d’exception, donc le même serveur fonctionne en local.

Les joueurs rejoignant via backfill ne sont pas répertoriés dans `match.tickets`, donc les serveurs utilisant l’Agent de serveur vérifient les joueurs qui se connectent avec `agent.playerConnected` à la place.

## 🧪 Exemples

Commencez avec des exemples comprenant une intégration complète et fonctionnelle pour le serveur et le client.

### [Three.js Minigames](#three.js-minigames)

Comprend cinq jeux navigateur avec une implémentation complète du cycle de vie du joueur - groupes, récupération de l’attribution de l’hôte et nouvelles tentatives de connexion. Montre comment lire les variables de match injectées côté serveur, attribuer les joueurs aux équipes à partir d’un profil à 2 équipes et arrêter les déploiements lorsque le match se termine.

Ajoutez un nouveau profil de matchmaking et un serveur de jeu pour adapter facilement cet exemple à votre jeu.

### Former un groupe

Rejoignez la file d'attente de matchmaking avec un groupe d'amis, en exigeant que tous les joueurs confirment avant de lancer la recherche. Le propriétaire du groupe crée un groupe et partage son ID via votre lobby ou votre backend :

{% code collapsedlinecount="10" %}

```javascript
const attributes = { beacons: latencies }

// sur l'appareil du propriétaire du groupe
agent.group.subscribe((group, _type, _message, event) => {
  if (event.code === 'created') shareWithFriends(group.current.group_id)
})
agent.createGroup({ profile: 'simple-example', attributes, is_ready: false }, true)

// sur l'appareil de chaque ami, une fois qu'ils reçoivent l'ID du groupe
agent.joinGroup({ profile: 'simple-example', attributes, is_ready: false }, groupId, true)

// sur chaque appareil, lorsque le joueur est prêt
agent.setReady(true)
const assignment = await agent.nextAssignment()
```

{% endcode %}

### Reprendre après le rechargement

Enregistrez le groupe lorsqu'il change, et reprenez la recherche (ou reconnectez-vous) lorsque la page se recharge :

{% code collapsedlinecount="10" %}

```javascript
agent.initialize(undefined, (group) => {
  if (group.current) localStorage.setItem('edgegap-group', JSON.stringify(group.current))
  else if (group.previous?.status !== 'HOST_ASSIGNED') localStorage.removeItem('edgegap-group')
})

const saved = JSON.parse(localStorage.getItem('edgegap-group'))
if (saved?.status === 'HOST_ASSIGNED') {
  connect(getConnectionUrl(saved.assignment, 'gameport'), saved.ticket_id)
} else if (saved) {
  agent.resumeMatchmaking(saved)
  connect(getConnectionUrl(await agent.nextAssignment(), 'gameport'), saved.ticket_id)
}
```

{% endcode %}

Supprimez le groupe enregistré avec `localStorage.removeItem('edgegap-group')` une fois le match terminé, afin que les joueurs ne se reconnectent pas à un match terminé.

### Rattrapage

Réutilisez la capacité du serveur et ajoutez des joueurs aux déploiements en cours. Définissez la taille cible de l'équipe et attendez que des joueurs soient ajoutés. Inclut une période de grâce de connexion automatisée et la recréation des rattrapages expirés, voir [#server-agent](#server-agent "mention").

Personnalisez le gestionnaire de votre serveur pour des compositions d'équipe multi-équipe ou asymétriques.

## ⚙️ Personnalisation

Ce SDK est destiné à être étendu et modifié, bien que certaines modifications puissent être risquées :

✅ Gestionnaire - reliez en toute sécurité les observateurs de l'interface et effectuez des ajouts ou des modifications mineurs,

⚠️ Agent - bifurquez le code source et modifiez la gestion du cycle de vie des joueurs à vos risques et périls,

⚠️ API - écrivez votre propre intégration à partir de zéro, en utilisant `Api` et des utilitaires sélectionnés.

Les gestionnaires peuvent observer tous les événements émis par les agents Server et Group comme décrit ci-dessous.

{% hint style="warning" %}
Assurez-vous de vous familiariser avec [Matchmaking en profondeur](https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md) les concepts avant d'apporter des personnalisations.
{% endhint %}

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### Événements client

L'agent de groupe émet des événements typés que les gestionnaires peuvent observer et exploiter.

{% hint style="success" %}
Lisez l'état en accédant à `.current` et `.previous` de tout observable, et **faites une branche sur `event.code`** car les messages d'événement peuvent changer entre les versions. 🔴 `Erreur` les événements stockent également le message d'erreur complet dans `.error` .
{% endhint %}

Aperçu des événements émis par l'observable monitor `monitor` :

<table data-full-width="true"><thead><tr><th width="125">Type d'action</th><th width="200">Code de l'événement</th><th width="300">Paramètres de l'événement</th><th>Description</th></tr></thead><tbody><tr><td>🟢 <code>Mise à jour</code></td><td><code>en bonne santé</code></td><td>-</td><td>Tous les systèmes sont opérationnels.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>non sain</code></td><td>-</td><td>Problème inattendu.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>monitor_failed</code></td><td><code>detail</code></td><td>Mauvaise configuration ou problème inattendu.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>beacons_failed</code></td><td><code>detail</code></td><td>Problème inattendu.</td></tr></tbody></table>

Aperçu des événements émis par l'observable monitor `group` :

<table data-full-width="true"><thead><tr><th width="125">Type d'action</th><th width="200">Code de l'événement</th><th width="300">Paramètres de l'événement</th><th>Description</th></tr></thead><tbody><tr><td>🟢 <code>Mise à jour</code></td><td><code>created</code></td><td>-</td><td>Groupe créé avec succès.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>create_failed</code></td><td><code>detail</code></td><td>Échec de la création du groupe.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>joined</code></td><td>-</td><td>Groupe rejoint avec succès.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>join_failed</code></td><td><code>detail</code></td><td>Échec de la jonction au groupe.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>resumed</code></td><td>-</td><td>Groupe repris avec succès.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>not_found</code></td><td><code>detail?</code></td><td>Pas membre du groupe, ou groupe expiré.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>conflict</code></td><td>-</td><td>Veuillez quitter le groupe actuel avant d'essayer de créer/rejoindre un nouveau groupe, ou passez <code>abandon: true</code>.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>member_updated</code></td><td><code>isReady</code></td><td>Membre mis à jour avec la nouvelle valeur Ready.</td></tr><tr><td>🟡 <code>Avertissement</code></td><td><code>member_update_failed</code></td><td>-</td><td>Impossible de repasser non prêt après que le groupe a commencé à rechercher une correspondance.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>update_failed</code></td><td><code>detail</code></td><td>Échec de la mise à jour du membre du groupe.</td></tr><tr><td>🔵 <code>Journal</code></td><td><code>polling</code></td><td><code>tentative</code>, <code>maxAttempts</code></td><td>L'agent a lancé le sondage de l'état du groupe. Émis uniquement avec <code>logPollingUpdates: true</code>.</td></tr><tr><td>🔵 <code>Journal</code></td><td><code>polling_stopped</code></td><td>-</td><td>L'agent a arrêté de sonder l'état du groupe. Émis uniquement avec <code>logPollingUpdates: true</code>.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>polling_failed</code></td><td><code>reason: 'max_retries'</code>, <code>detail</code></td><td>L'agent a épuisé le nombre maximal de nouvelles tentatives de sondage consécutives. Vérifiez l'état du service.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>polling_failed</code></td><td><code>reason: 'error'</code>, <code>detail</code></td><td>L'agent a reçu une erreur non réessayable lors du sondage. Vérifiez l'état du service.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>updated</code></td><td><code>status</code></td><td>Changement d'état du groupe détecté pendant le sondage.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>abandonné</code></td><td>-</td><td>Ticket supprimé avec succès.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>abandon_failed</code></td><td><code>reason: 'not_found'</code></td><td>L'agent n'a pas pu trouver le groupe à supprimer, probablement expiré.</td></tr><tr><td>🟡 <code>Avertissement</code></td><td><code>abandon_failed</code></td><td><code>reason: 'match_found'</code></td><td>L'agent n'a pas pu supprimer un groupe apparié. Désactivez l'abandon ou <a data-mention href="https://docs.edgegap.com/fr/learn/matchmaking/matchmaker-in-depth.md#backfill-match">Analyse approfondie</a> pour remplacer le joueur.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>abandon_failed</code></td><td><code>reason: 'error'</code>, <code>detail</code></td><td>Échec de la suppression du groupe ou de l'appartenance.</td></tr><tr><td>🟡 <code>Avertissement</code></td><td><code>restart_skipped</code></td><td>-</td><td>Le groupe a déjà trouvé une correspondance, l'action de suivi après l'abandon a été ignorée.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>supprimé</code></td><td>-</td><td>Le groupe est terminé ou expiré, la référence locale a été supprimée.</td></tr></tbody></table>

### Événements serveur

L'agent serveur émet des événements typés que les gestionnaires peuvent observer et exploiter. L'agent serveur est uniquement nécessaire pour [#backfill](#backfill "mention").

{% hint style="info" %}
Les tickets actuellement assignés peuvent être lus à partir de la propriété de l'agent serveur `assignments` à tout moment, et les temps de connexion à partir de `connectedAt` .
{% endhint %}

{% hint style="success" %}
Lisez l'état en accédant à `.current` et `.previous` de tout observable, et **faites une branche sur `event.code`** car les messages d'événement peuvent changer entre les versions. 🔴 `Erreur` les événements stockent également le message d'erreur complet dans `.error` .
{% endhint %}

Aperçu des événements émis par l'observable monitor `monitor` :

<table data-full-width="true"><thead><tr><th width="125">Type d'action</th><th width="200">Code de l'événement</th><th width="300">Paramètres de l'événement</th><th>Description</th></tr></thead><tbody><tr><td>🟢 <code>Mise à jour</code></td><td><code>en bonne santé</code></td><td>-</td><td>Tous les systèmes sont opérationnels.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>non sain</code></td><td>-</td><td>Problème inattendu.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>monitor_failed</code></td><td><code>detail</code></td><td>Mauvaise configuration ou problème inattendu.</td></tr></tbody></table>

Aperçu des événements émis par l'observable monitor `backfills` :

<table data-full-width="true"><thead><tr><th width="125">Type d'action</th><th width="200">Code de l'événement</th><th width="300">Paramètres de l'événement</th><th>Description</th></tr></thead><tbody><tr><td>🟢 <code>Mise à jour</code></td><td><code>created</code></td><td><code>backfillId</code></td><td>Rattrapage créé avec succès.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>create_failed</code></td><td><code>detail</code></td><td>Problème inattendu avec le rattrapage. Vérifiez l'état du service.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>capacity_reached</code></td><td>-</td><td>Le serveur est plein, aucun rattrapage créé.</td></tr><tr><td>🔵 <code>Journal</code></td><td><code>polling</code></td><td><code>tentative</code>, <code>maxAttempts</code></td><td>L'agent a lancé le sondage des rattrapages. Émis uniquement avec <code>logPollingUpdates: true</code>.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>assigned</code></td><td><code>backfillId</code>, <code>ticketId</code></td><td>Ticket assigné au rattrapage avec succès.</td></tr><tr><td>🔵 <code>Journal</code></td><td><code>polling_stopped</code></td><td>-</td><td>L'agent a arrêté le sondage, il ne reste plus de rattrapages à sonder.</td></tr><tr><td>🟡 <code>Avertissement</code></td><td><code>polling_failed</code></td><td><code>backfillId</code>, <code>reason: 'not_found'</code></td><td>Introuvable, suppression de la référence. Le rattrapage a très probablement expiré.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>polling_failed</code></td><td><code>backfillId</code>, <code>reason: 'max_retries'</code></td><td>Nouvelles tentatives épuisées, abandon de tous les rattrapages.</td></tr><tr><td>🔴 <code>Erreur</code></td><td><code>polling_failed</code></td><td><code>backfillId</code>, <code>reason: 'error'</code>, <code>detail</code></td><td>Problème inattendu, abandon et remplacement du rattrapage.</td></tr><tr><td>🔵 <code>Journal</code></td><td><code>abandonné</code></td><td><code>backfillId</code></td><td>Rattrapage abandonné, suppression de la référence.</td></tr><tr><td>🟡 <code>Avertissement</code></td><td><code>abandon_failed</code></td><td><code>backfillId</code>, <code>reason: 'not_found'</code></td><td>Rattrapage introuvable, probablement expiré ou appel en double.</td></tr><tr><td>🟡 <code>Avertissement</code></td><td><code>abandon_failed</code></td><td><code>backfillId</code>, <code>reason: 'error'</code>, <code>detail</code></td><td>Échec de l'abandon, suppression de la référence.</td></tr><tr><td>🟢 <code>Mise à jour</code></td><td><code>supprimé</code></td><td><code>backfillId</code></td><td>Référence de rattrapage supprimée. Le rattrapage sera remplacé automatiquement s'il n'est pas arrêté.</td></tr><tr><td>🟡 <code>Avertissement</code></td><td><code>remove_failed</code></td><td><code>backfillId</code></td><td>Référence de rattrapage introuvable, appel en double probable.</td></tr></tbody></table>
