Pour combler rapidement cette lacune, utilisez une invite universelle que tout assistant de codage IA peut exécuter. Elle fonctionne en deux parties : d'abord, l'assistant audite le projet pour découvrir comment votre jeu et votre code réseau se connectent actuellement à un serveur, puis il ajoute la connexion de Matchmaking. Les deux invites sont indépendantes du code réseau utilisé.

Invite 1 — auditer le projet (lecture seule) :

Lecture seule, aucune modification de code. Mon projet Unity utilise un framework de code réseau et j'ajoute le Matchmaking Edgegap, qui fournira à mon client une adresse de serveur (un FQDN) et un port externe au moment de l'exécution. Trouvez et dites-moi : 1) la méthode qui démarre une connexion client à un serveur, le fichier et la ligne, et ce qui la déclenche ; 2) où l'adresse du serveur et le port sont définis avant la connexion — les noms exacts de la propriété ou du champ, le transport utilisé, ainsi que le fichier et la ligne. Fournissez les chemins d'accès aux fichiers et les numéros de ligne. Ne modifiez rien.

Pour l'échantillon Mirror Tank, l'audit confirme que le client se connecte en appelant StartClient() sur le NetworkManager de Mirror, avec l'adresse définie via NetworkManager.singleton.networkAddress et le port défini sur le PortTransport actif — dans ce cas, le transport KCP sur le port 7777.

Invite 2 — ajouter la connexion :

Dans l'échantillon Edgegap MatchmakingClientHandler.cs, trouvez le bloc qui s'exécute lorsque le statut du ticket est "HOST_ASSIGNED". Actuellement, il ne fait qu'enregistrer l'attribution. Remplacez cet espace réservé par un code qui se connecte au serveur attribué en utilisant mon code réseau : lisez le FQDN du serveur attribué et configurez-le comme adresse réseau, lisez le port externe (c'est une chaîne de caractères — convertissez-la dans le type attendu par mon transport) et configurez-le sur le transport actif, puis démarrez la connexion client. Utilisez la méthode de connexion, le champ d'adresse et le port de transport que vous avez identifiés à l'étape précédente. Renvoyez le bloc complet mis à jour.

L'assistant lit le projet, identifie le code réseau et y adapte la connexion. La même approche fonctionne pour d'autres codes réseau — l'audit et la modification s'adaptent à la méthode de connexion utilisée par le projet. La seule exception est un projet qui oriente les connexions via sa propre couche réseau personnalisée plutôt que d'appeler directement le code réseau ; l'audit le signalera, et vous pourrez alors inviter l'assistant à adapter la modification en conséquence.

Partie 3 - Connecter le gestionnaire à votre scène

Dans la scène de votre jeu, créez un objet vide : dans le menu, sélectionnez GameObject, puis Create Empty. Renommez-le "Matchmaking." Avec l'objet sélectionné, dans l'Inspecteur, sélectionnez Add Component et ajoutez le Matchmaking Client Handler.

Deux champs doivent être remplis : Base URL et Auth Token. Tous deux proviennent du matchmaker, créé ensuite. Laissez tous les autres paramètres par défaut.

Partie 4 - Créer votre Matchmaker

Sur la plateforme Edgegap, sélectionnez Matchmaker, puis Create Matchmaker, et donnez-lui un nom pour votre propre référence, comme "quickstart-dev."

Pour la configuration, rien n'a besoin d'être écrit ou collé. Ouvrez le menu déroulant et sélectionnez le Simple Example — une configuration prête à l'emploi idéale pour un match à deux joueurs, ce qui convient parfaitement au jeu de Tank. Le sélectionner remplit automatiquement votre application et votre version téléchargées le plus récemment. Confirmez qu'il s'agit bien de l'application et de la version que vous avez l'intention d'utiliser ; si vous avez plusieurs versions, sélectionnez la bonne dès maintenant.

Il convient de comprendre deux parties de cette configuration, car elles constituent le point de départ de la personnalisation ultérieure du Matchmaking :

• La règle de taille du match définit le nombre de joueurs requis — ici, une équipe de deux joueurs.

• La règle des latences permet à chaque joueur de tester un ensemble de balises partagées par ping et de regrouper les joueurs dont les résultats sont suffisamment proches pour partager un match à faible latence. L'emplacement du serveur est choisi séparément, en fonction de l'endroit où se trouvent réellement les joueurs regroupés.

Lors de la validation, un avertissement peut s'afficher indiquant que l'image du serveur n'est pas mise en cache. Il s'agit d'un rappel qu'une version de production bénéficie d'une image mise en cache afin que les serveurs se déploient instantanément ; pour les tests, ce n'est pas un problème, sélectionnez donc Continue. Le matchmaker démarre sur le cluster partagé gratuit — comptez quelques minutes pour l'initialisation, puis jusqu'à cinq de plus pour qu'il devienne accessible sur le réseau.

Une fois qu'il est en ligne, ouvrez ses détails. Copiez l'URL de l'API et, de retour dans Unity, collez-la dans le champ Base URL de l'objet Matchmaking. Faites de même pour l'Auth Token.

Ce jeton ne donne accès qu'à votre matchmaker et à rien d'autre sur votre compte, il est donc sûr de le conserver dans le client pendant le développement — aucun backend n'est nécessaire. En production, vous conserveriez généralement ce jeton sur votre propre backend à la place. Non pas pour cacher le jeton, puisqu'il est limité au cadre du Matchmaking et sécurisé, mais pour que les joueurs s'authentifient d'abord sur votre backend, vous permettant ainsi d'appliquer l'identité, les bannissements et le système de matchmaking basé sur les compétences (skill-based matching) avant même qu'un ticket ne soit créé.