個人開発 » beatoraja

追加仕様 詳細設計（2026-06-13）本体側¶

親 #162 に対する追加表示要素の本体側設計。既存の「MainController.changeState() を唯一の更新funnelとする」方針を基本踏襲しつつ、GAS によるゲージ種別のプレイ中変化だけは追従用の副経路を追加する。

追加する表示要素と取得元¶

取得段位・一言はユーザー判断により「手動設定の文字列を PlayerConfig に保持しランチャーUIで設定」とする。

重要：GAS のリアルタイム更新（既存funnelの限界）¶

GAS=on 時、ゲージ種別は BMSPlayer のプレイループ内（BMSPlayer.java:643-677 の GAS 処理ブロック）で gauge.setType(...) により切り替わる。これは changeState() を通らないため、既存の「changeState のみで ObsState を更新」方式では追従できない。

対応方針:

• ObsState に in-play 用の軽量更新 API（例: updatePlayGauge(int gaugeType)）を追加。playing フェーズのスナップショットのうちゲージ表記だけを差し替え、volatile 参照を入れ替える。
• BMSPlayer 側に直近反映済みのゲージ種別を保持し、GAS 処理直後に 種別が変化したときのみ ObsState を更新（毎フレーム呼ばない／obsEnabled でガード）。
• スレッド安全性は維持: changeState() も BMSPlayer.update() も同じゲームスレッドから呼ばれるため単一ライタ。HTTP スレッドは volatile スナップショットを読むだけでロック不要、という #181 の前提を崩さない。

レーンパターン（仕様C）は laneShufflePattern がプレイ開始時に確定し以後不変のため副経路は不要。changeState(PLAY) で BMSPlayer 生成（MainController.java:263）後にスナップショットへ格納する。

/state.json スキーマ拡張¶

profile（全phase共通・常時）を追加し、nowPlaying に playOption を追加する。表記済み文字列で渡し、HTML 側は流し込むだけ、の方針は維持。

{
  "phase": "select | playing | result",
  "profile": {
    "name": "izu",
    "dan": "発狂八段",          // 手動設定 (PlayerConfig)
    "comment": "目標：皆伝"      // 手動設定 (PlayerConfig)
  },
  "nowPlaying": {
    // ...既存フィールド...
    "playOption": {
      "random": "R-RANDOM",      // 1P
      "random2": null,           // DP/バトル時のみ
      "gauge": "HARD",           // ★GASでライブ更新される現在のゲージ
      "gaugeAutoShift": true,    // On/Off
      "gaugeAutoShiftMode": "BEST CLEAR",
      "lane": "3 1 6 4 2 7 5"    // RANDOM/R-RANDOM時のみ。他はnull
    }
  },
  "lastResult": { /* 既存 */ },
  "session": { /* 既存 */ }
}

表記の整形（本体側で確定）¶

既存配列・enum を流用する。

• ランダム名: {OFF, MIRROR, RANDOM, R-RANDOM, S-RANDOM, SPIRAL, H-RANDOM, ALL-SCR, RANDOM-EX, S-RANDOM-EX}（PlayConfigurationView の scoreOptions と同一インデックス。R-RANDOM = Random.ROTATE）。PMS(9K) は OPTION_PMS 準拠。
• ゲージ名: {ASSIST EASY, EASY, NORMAL, HARD, EX-HARD, HAZARD, CLASS, EX-CLASS, EXHARD-CLASS}（GrooveGauge の type 定数 0–8 に対応。コース/段位プレイの CLASS 系も含めて網羅）。
• GAS モード名: {NONE, CONTINUE, SURVIVAL TO GROOVE, BEST CLEAR, SELECT TO UNDER}（GAUGEAUTOSHIFT_* 0–4）。
• レーンパターン: IntegerIndexPropertyTypes.getAssignedLane()（#180）と同等のロジックで laneShufflePattern を整形（割当元レーン番号をスペース区切り）。#180 と重複するため共通ヘルパへの切り出しを推奨。RANDOM/R-RANDOM(=ROTATE) のみ対象（spec準拠。EX/CROSS 系は将来拡張余地）。

設定（Config / PlayerConfig）¶

• PlayerConfig に String dan（取得段位）と String obsComment（一言）を追加。getter/setter と PlayerConfigPersistenceDto への追加、デフォルト空文字。
• ランチャー PlayConfigurationView（プレイヤー設定タブ）にテキスト入力欄2つを追加。FXML・コントローラのバインド・リソースバンドルのキーを同期。
• obsEnabled / obsPort（既定 7322）は本チケット既存設計のまま。

配置¶

• 既存設計どおり bms.player.beatoraja.stream.obs に ObsState ほかを配置。整形ヘルパ（ランダム名/ゲージ名/GAS名/レーンパターン）も同パッケージへ。

動作確認の想定¶

7K 譜面を RANDOM + GAS=BEST CLEAR でプレイし、http://localhost:7322/now-playing.html を開く。ランダム=RANDOM、レーンパターン=置換列、ゲージが初期 HARD から GAS 発動で NORMAL/EASY 等へ1秒ポーリングでライブに変化、GAS バッジ On、プロフィールに名前/段位/一言が表示されることを確認する。

本コメントは詳細設計であり実装着手前。ステータスは変更していない。

補足（2026-06-13）：HTML側の単一集約に伴う影響¶

#182 の方針を「用途別分割 → 単一 overlay.html に集約」へ変更したことに伴う本体側の確認事項。

• /state.json スキーマ（profile / nowPlaying.playOption）は変更不要。元から全ブロックを1本で返す設計のため単一 HTML と整合する。
• HTTP サーバの静的配信は overlay.html 1枚（＋CSS/JS）を配る構成になる。profile.html など用途別テンプレートの配信は不要。
• ポーリングが3ソース→1ソースに集約されるため、/state.json 生成・配信の負荷面でもむしろ軽くなる。GAS のライブ更新経路（ObsState.updatePlayGauge）の設計は前コメントのまま。

実装完了・MR !24 にて develop へ。https://gitlab.izu-san.com/games/beatoraja/-/merge_requests/24

本体側：新規 bms.player.beatoraja.stream.obs（ObsHttpServer / ObsState / SessionStats / ObsController / ObsFormat）。MainController.changeState() を funnel に select/nowPlaying/play/result/courseResult を反映、BMSPlayer の GAS 処理直後に種別変化時のみゲージをライブ更新。/state.json（phase/profile/nowPlaying(+playOption)/lastResult/session/history）、難易度表表記、選曲履歴（最大5件）。設定：Config.obsEnabled/obsPort、PlayerConfig.dan/obsComment＋永続化、ランチャー Stream タブ UI。スレッド安全（単一ライタ＋volatile）。xvfb-run -a ./gradlew test 成功。