Multijoueur (WebRTC pair-à-pair)
Tous les visiteurs sur le même domaine déployé rejoignent une salle par défaut, ouvrant un
canal de données WebRTC natif directement vers chaque autre visiteur — le trafic de jeu
lui-même ne touche jamais le serveur. Un minuscule relais à /api/rtc gère uniquement le
routage de la poignée de main de connexion (SDP/ICE) pendant que les pairs se connectent. Ce que vous
utilisez de la trousse est uniquement côté client ; le relais est le vôtre.
La latence est navigateur↔navigateur (souvent 5-40 ms) avec un coût serveur nul par tick.
| Pièce | Chemin |
|---|---|
| Primitive de maillage (commencez ici) | P2PRoom de @/lib/multiplayer |
| Liaison React (optionnelle, vous créez) | src/lib/multiplayer/use-p2p-room.ts |
| Relais de signalisation (vous créez) | src/lib/multiplayer/signaling.server.ts |
| Montage HTTP (vous créez) | src/routes/api/rtc.ts |
Modèle de confiance — lisez avant de choisir P2P. Il n'y a pas d'autorité serveur : chaque pair exécute sa propre copie des règles et peut mentir (position, score, quoi que ce soit). Les pairs apprennent également les adresses IP des autres pendant ICE. Le P2P est uniquement pour les jeux coopératifs et décontractés entre personnes qui choisissent de jouer ensemble — jamais pour les classements compétitifs, les jeux sensibles à la triche, ou les rencontres entre inconnus anonymes. Les jeux compétitifs ou sensibles à la triche ne sont pas pris en charge dans ce modèle : repoussez en termes de produit plutôt que de les expédier en P2P.
Limites pratiques : un maillage complet est de O(N²) connexions — limitez les salles à ~8 pairs.
Environ 10-20 % des paires de pairs se trouvent derrière des NAT stricts et ne peuvent pas se connecter ; la
trousse expose cela par pair comme connectionState: "failed" — affichez-le dans
l'interface utilisateur plutôt que de bloquer.
Configuration (une fois)
Créez les deux fichiers serveur — rien ne fonctionne sans eux :
src/lib/multiplayer/signaling.server.ts— le relais de signalisation basé sur une base de données (Neon déployé, PGLite en prévisualisation).src/routes/api/rtc.ts— le monte à/api/rtc(GET poll, POST signal/leave).
Copiez les deux à partir de references/signaling-relay.md, qui contient également la
note de schéma : le relais crée ses propres deux tables lors de la première utilisation
(CREATE TABLE IF NOT EXISTS), donc rien ne va dans migrations/ à moins que vous
ne souhaitiez délibérément posséder le schéma.
Utilisation de la primitive
P2PRoom est indépendant du framework, et une « salle » est simplement une clé de rendez-vous — un code
de lobby, un identifiant d'appel 1:1, un identifiant de document partagé, n'importe quelle chaîne (≤64 caractères). N'importe quelle
architecture repose sur les trois mêmes appels :
import { P2PRoom } from "@/lib/multiplayer";
const p2p = new P2PRoom({
room: "doc-42",
selfId: myId,
name: "ani",
onPeersChanged: (peers) => render(peers),
onMessage: (from, data, channel) => apply(from, data, channel),
});
avoid p2p.join();
p2p.broadcast(state); // canal "state" non fiable — rythme de jeu, les périmés sont abandonnés
p2p.send(event, to); // canal fiable — événements exactement une fois (to optionnel)
p2p.close();
Pour la forme courante « tous sur cette application jouent ensemble » dans React, copiez le
hook useP2PRoom (plus un composant concret : boucle de diffusion au rythme du jeu à ~20 envois/s,
événements ponctuels fiables) depuis references/react-binding.md.
Modèles :
broadcast()= non fiable/non ordonné, pour un état continuellement rafraîchi (positions, curseurs).send()= fiable/ordonné, pour les événements qui doivent arriver exactement une fois. Ne diffusez jamais l'état du jeu sursend(); interpolez entre les diffusions pour un mouvement fluide.- Les arrivants tardifs ne savent rien : lorsqu'un nouveau pair apparaît dans
p2p.peers, un pair existant doit luisend()l'état partagé actuel. Exactement un pair doit répondre : comparez les identifiants parmi les pairs qui étaient DÉJÀ dans la salle (votreselfIdplusp2p.peersmoins le nouveau venu) et répondez uniquement si votreselfIdest le plus petit — ainsi deux arrivants simultanés ne répondent ni doublement ni ne restent sans réponse. - Identifiants de salle : omettez pour « tous sur cette application jouent ensemble » ; passez
room: codepour les salons privés (générez un code court, mettez-le dans l'URL). - Les pairs disparaissent sans au revoir (fermeture d'onglet, veille) : traitez un pair absent
de
p2p.peerscomme parti et supprimez ses entités. - Une liaison React qui capture
room/namelors du premier rendu (celle dereferences/react-binding.mdle fait) nécessite un remontage pour les modifier — associez le composant au code de la salle.
Diagnostic
Chaque entrée dans p2p.peers porte connectionState, rttMs (ping du canal de
données), et candidateType (host/srflx = direct). Pour remplacer STUN, ajoutez
VITE_STUN_URLS (séparé par des virgules) à .grok/app-env.json et redémarrez le serveur
de développement (Vite lit l'environnement au démarrage ; HMR ne le détectera pas) — n'écrivez jamais un
.env dans ce bac à sable.