概要
1. RGSP とは
Section titled “1. RGSP とは”連珠(と五目並べ)の対局サーバーの共通仕様です。この仕様に沿ったサーバーなら、どのアプリからでも、同じ方法でつなげます。
- ユーザーは、アプリの中で「対局するサーバー」を選びます。 マッチングとレーティングは、選んだサーバーの中で行います。
- サーバーは、誰でも運営できます。 仕様と、参照実装(ソース公開の実装)が公開されます。
- アプリも、誰でも作れます。 アプリの事前登録は要りません。同じサーバーを選べば、別のアプリのユーザーどうしでも対戦できます。
┌───────────────┐ 一覧を取得 ┌───────────────────┐ │ アプリ A │ ─────────────────▶ │ ディレクトリ │ │ (クライアント)│ │ 準拠したサーバーの一覧 │ └──────┬────────┘ └───────────────────┘ │ 選んだサーバーへ(HTTPS) ▼ ┌──────────────────────────┐ ┌──────────────────────────┐ │ サーバー X(運営者 P) │ │ サーバー Y(運営者 Q) │ │ アカウント・ロビー・対局・ │ │ アカウント・ロビー・対局・ │ │ レーティング・棋譜 │ │ レーティング・棋譜 │ └──────────────────────────┘ └──────────────────────────┘ ▲ │ 同じサーバーを選べば、別のアプリの人どうしでも対戦できる アプリ B| 用語 | 意味 |
|---|---|
| サーバー | この仕様に準拠する対局サーバー 1 台(1 運営)。アカウント・ロビー・対局・レーティングの単位 |
| アプリ | ユーザーが使う画面。サーバーにつなぐだけで、アカウントもレーティングも持たない |
| 運営者 | サーバーを立てて運営する人・団体 |
| ディレクトリ | 準拠したサーバーの一覧(§12) |
| 参照実装 | ソースを公開するサーバー実装。他の運営者が立てるときの出発点(§16。未公開) |
範囲: 規則判定、対局の進行、アカウントの取得、ロビー、レーティング、観戦、棋譜、サーバーの発見と準拠確認。 範囲外(v0.1): サーバー間の対局(別サーバーの人どうしの対戦)、トーナメント、詰め連珠・記事などの対局以外の機能。
2. 設計の考え方
Section titled “2. 設計の考え方”- サーバー権威。 着手の合法性・時計・終局は、サーバーだけが決める。アプリは「意図」を送り、サーバーが結果を返す。
- コマンドとイベントを分ける。 操作は HTTP の POST(コマンド)、変化の受信は SSE(イベント)。
- イベントは全順序で、再開できる。 対局ごとに連番(
seq)を振り、切れても続きから受け取れる。 - 着手ログが正。 盤面・手番・時計は、着手ログから導ける。
- 加算的に進化する。 未知のフィールド・イベント・アクションは無視する(§14)。
- サーバーは自己申告し、検証される。 対応する機能は
/.well-known/で名乗り、適合性テストで確かめる(§12)。 - アプリは、信頼できないサーバーにつなぐことがある。 トークンはサーバーごとに分ける(§4)。