マルチプレイヤー(WebRTCピアツーピア)
同一のデプロイされたドメイン上のすべての訪問者は、1つのデフォルトルームに参加し、他のすべての訪問者との間にネイティブのWebRTCデータチャネルを直接開きます。ゲームトラフィック自体はサーバーを一切経由しません。 /api/rtc にある小さなリレーは、ピアが接続する間、接続ハンドシェイク(SDP/ICE)のルーティングのみを処理します。このキットから使用するものはクライアントサイドのみであり、リレーはあなた自身のものです。
レイテンシはブラウザ↔ブラウザ(多くの場合5~40ミリ秒)で、1ティックあたりのサーバーコストはゼロです。
| 部品 | パス |
|---|---|
| メッシュプリミティブ(ここから始める) | @/lib/multiplayer の P2PRoom |
| Reactルームバインディング(オプション、自分で作成) | src/lib/multiplayer/use-p2p-room.ts |
| シグナリングリレー(自分で作成) | src/lib/multiplayer/signaling.server.ts |
| HTTPマウント(自分で作成) | src/routes/api/rtc.ts |
信頼モデル — P2Pを選択する前に読んでください。 サーバーによる権威は存在しません。すべてのピアはルールの独自コピーを実行し、嘘をつくことができます(位置、スコア、何でも)。また、ピアはICE中に互いのIPアドレスを学習します。P2Pは一緒にプレイすることを選択した人々の間での協力およびカジュアルプレイを目的としており、競技ランキング、不正防止が必要なプレイ、匿名の見知らぬ人とのマッチメイキングには絶対に使用しないでください。競技または不正防止が必要なプレイはこのテンプレートではサポートされていません。製品としてP2Pで出荷するのではなく、そうした要求を断ってください。
実用的な制限:フルメッシュはO(N²)の接続を持つため、ルームは約8ピアに制限してください。ピアペアの約10~20%は厳格なNATの背後にあり接続できません。このキットはこれをピアごとに connectionState: "failed" として表面化します。UIに表示し、ハングさせないでください。
セットアップ(1回のみ)
2つのサーバーファイルを作成します。これらがないと動作しません。
src/lib/multiplayer/signaling.server.ts— DBバックアップのシグナリングリレー (本番ではNeon、プレビューではPGLite)。src/routes/api/rtc.ts— これを/api/rtcにマウントします(GETポーリング、POSTシグナル/離脱)。
両方を references/signaling-relay.md からコピーしてください。 このファイルにはスキーマに関する注意事項も含まれています。リレーは初回使用時に独自の2つのテーブルを作成します(CREATE TABLE IF NOT EXISTS)。そのため、意図的にスキーマを管理したい場合を除き、migrations/ には何も追加しないでください。
プリミティブの使用
P2PRoom はフレームワークに依存しません。「ルーム」とは単なるランデブーキーです。ロビーコード、1:1通話ID、共有ドキュメントIDなど、任意の文字列(64文字以下)です。どのようなアーキテクチャでも、同じ3つの呼び出しの上に構築されます。
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),
});
await p2p.join();
p2p.broadcast(state); // 非信頼性 "state" チャネル — ゲームレート、古いものはドロップ
p2p.send(event, to); // 信頼性チャネル — 正確に1回のみイベント(toはオプション)
p2p.close();
Reactで「このアプリの全員が一緒にプレイする」という一般的な形状の場合、useP2PRoom フック(および動作例:ゲームレートブロードキャストループ約20送信/秒、信頼性のあるワンショットイベント)を references/react-binding.md からコピーしてください。
パターン:
broadcast()= 非信頼性/非順序、継続的に更新される状態(位置、カーソル)に使用。send()= 信頼性/順序、正確に1回到着しなければならないイベントに使用。ゲームレートの状態をsend()でストリームしないでください。ブロードキャスト間を補間してスムーズな動きを実現します。- 後から参加した人は何も知りません。
p2p.peersに新しいピアが現れた場合、既存のピアがその新しいピアに現在の共有状態をsend()する必要があります。正確に1つのピアのみが応答する必要があります。すでにルームにいるピア(自分のselfIdとp2p.peersから新規参入者を除いたもの)の中でIDを比較し、自分のselfIdが最小の場合のみ応答します。これにより、2人の同時参加者が二重に応答したり応答なしになったりするのを防ぎます。 - ルームID:「このアプリの全員が一緒にプレイする」場合は省略します。プライベートロビーの場合は
room: codeを渡します(短いコードを生成し、URLに入れます)。 - ピアは別れを告げずに消えます(タブを閉じる、スリープ)。
p2p.peersから消えたピアは消えたものとみなし、そのエンティティを削除します。 - 最初のレンダリングで
room/nameをキャプチャするReactバインディング(references/react-binding.mdにあるもの)は、これらを変更するために再マウントが必要です。コンポーネントをルームコードでキー付けしてください。
診断
p2p.peers の各エントリには、connectionState、rttMs(データチャネルping)、および candidateType(host/srflx = 直接)が含まれます。STUNを上書きするには、カンマ区切りの VITE_STUN_URLS を .grok/app-env.json に追加し、開発サーバーを再起動してください(Viteは起動時に環境変数を読み取ります。HMRでは反映されません)。このサンドボックスで .env を作成しないでください。