コンテンツにスキップ

概要

連珠(と五目並べ)の対局サーバーの共通仕様です。この仕様に沿ったサーバーなら、どのアプリからでも、同じ方法でつなげます。

  • ユーザーは、アプリの中で「対局するサーバー」を選びます。 マッチングとレーティングは、選んだサーバーの中で行います。
  • サーバーは、誰でも運営できます。 仕様と、参照実装(ソース公開の実装)が公開されます。
  • アプリも、誰でも作れます。 アプリの事前登録は要りません。同じサーバーを選べば、別のアプリのユーザーどうしでも対戦できます。
┌───────────────┐ 一覧を取得 ┌───────────────────┐
│ アプリ A │ ─────────────────▶ │ ディレクトリ │
│ (クライアント)│ │ 準拠したサーバーの一覧 │
└──────┬────────┘ └───────────────────┘
│ 選んだサーバーへ(HTTPS)
▼
┌──────────────────────────┐ ┌──────────────────────────┐
│ サーバー X(運営者 P) │ │ サーバー Y(運営者 Q) │
│ アカウント・ロビー・対局・ │ │ アカウント・ロビー・対局・ │
│ レーティング・棋譜 │ │ レーティング・棋譜 │
└──────────────────────────┘ └──────────────────────────┘
▲
│ 同じサーバーを選べば、別のアプリの人どうしでも対戦できる
アプリ B
用語 意味
サーバー この仕様に準拠する対局サーバー 1 台(1 運営)。アカウント・ロビー・対局・レーティングの単位
アプリ ユーザーが使う画面。サーバーにつなぐだけで、アカウントもレーティングも持たない
運営者 サーバーを立てて運営する人・団体
ディレクトリ 準拠したサーバーの一覧(§12)
参照実装 ソースを公開するサーバー実装。他の運営者が立てるときの出発点(§16。未公開)

範囲: 規則判定、対局の進行、アカウントの取得、ロビー、レーティング、観戦、棋譜、サーバーの発見と準拠確認。 範囲外(v0.1): サーバー間の対局(別サーバーの人どうしの対戦)、トーナメント、詰め連珠・記事などの対局以外の機能。

  1. サーバー権威。 着手の合法性・時計・終局は、サーバーだけが決める。アプリは「意図」を送り、サーバーが結果を返す。
  2. コマンドとイベントを分ける。 操作は HTTP の POST(コマンド)、変化の受信は SSE(イベント)。
  3. イベントは全順序で、再開できる。 対局ごとに連番(seq)を振り、切れても続きから受け取れる。
  4. 着手ログが正。 盤面・手番・時計は、着手ログから導ける。
  5. 加算的に進化する。 未知のフィールド・イベント・アクションは無視する(§14)。
  6. サーバーは自己申告し、検証される。 対応する機能は /.well-known/ で名乗り、適合性テストで確かめる(§12)。
  7. アプリは、信頼できないサーバーにつなぐことがある。 トークンはサーバーごとに分ける(§4)。