ゲームの見た目を機械で検査する（人が見る工程を減らす）

4本目のゲームは、テストが通っていました。60fps も出ていました。1フレームの確保も0バイトでした。それでも公開した画面は「単色の図形が並ぶだけ」で、人に言われるまで気づけませんでした。

理由ははっきりしています。自動で見ていたのは「壊れていないか」だけで、見た目を見る仕組みが無かったからです。

何を数えるか

公開したページを自動で開き、遊ばせて、連続3コマ撮って判定します。

npm run check:look -- https://aigame.game-union-libra.com/play/mureuchi/ --seconds 12

見た目の検査: https://aigame.game-union-libra.com/play/mureuchi/
○ 明るさ（真っ黒でない）: 平均 0.0644（0.015 以上）
○ 明るさ（白飛びしない）: 平均 0.0644（0.45 以下）
○ 要素の量: 背景以外 4.15%（1% 以上）
○ 色の数: 4 種類（3 以上）
○ HUD の読みやすさ: 明暗差 0.907（0.35 以上）
○ 動き: 変わった画素 6.43%（0.2% 以上）
○ 音: 338 回鳴った（3 回以上）
○ コンソールのエラー: なし

作り直す前の画面で同じ検査をかけると、色の数が1種類で落ちます。つまり、あの状態は自動で見つけられました。

色の数え方

難しいことはしていません。明るくて色味のある画素だけを拾い、色相を12個の箱に分けて、全体の4%以上を占める箱を数えます。

if (l > 0.18 && sat > 0.25) {
  hueBuckets[Math.floor(hue / 30)]++
  bright++
}
const hues = hueBuckets.filter((c) => c / bright > 0.04).length

背景の明るさは「画面の下10%の中央値」を使いました。ゲームの絵が少ない場所なので、背景の明るさに近い値が取れます。そこから 0.06 以上明るい画素を「何かが出ている画素」として数えます。

音は WebAudio の再生回数で見る

耳を使わずに「鳴っているか」を確かめる方法です。ページを開く前に、音を出す呼び出しへ印を付けておきます。

await page.evaluateOnNewDocument(() => {
  window.__sounds = 0
  const start = AudioBufferSourceNode.prototype.start
  AudioBufferSourceNode.prototype.start = function (...args) {
    window.__sounds++
    return start.apply(this, args)
  }
})

これで「鳴っていない」は確実に見つかります。おまけに、鳴りすぎも見つかりました。12秒で 345回。1秒に29回です。発射音を「同じフレームに何発撃っても1回」に制限していたのに、この数でした。種類ごとに最短の間隔（発射 0.22秒・命中 0.07秒・撃破 0.08秒）を入れ直しています。

検査自身が誤判定した

作ったその日に踏みました。タイトル画面に「SOUND ON/OFF」のボタンを足したところ、START ボタンの位置が下にずれました。検査はボタンの座標を決め打ちしてタップしていたので、ゲームが始まらないままタイトル画面を撮り、こう言いました。

  ✗ 色の数: 1 種類（3 以上）

失敗 1 件

画面は正常です。検査が壊れていました。

// 🔴 検査用の入口：`?autostart=1` ですぐ始める。
//    ⚠️ 自動の検査がボタンの位置を決め打ちしていると、UI を変えるたびに壊れる
if (UrlHas("autostart=1")) StartBattle();

同じ考えで、計測用の入口も2つ用意しています（?nopool=1＝絵を使い回さない、?stress=1＝数を上限まで）。測るための入口は、ゲーム側に作るほうが安上がりでした。

検査が撮った画面

私は最初、見た目の確認を「人が見る作業」として 👤 で残すつもりでした。やめた理由は、自分が見落としたからです。見れば分かることを人に頼むと、忙しいときに飛ばされます。数にしておけば、飛ばされません。

何を人に残したか

まとめ

• テストが通っていても、見た目は誰も見ていないことがある
• 公開したページを撮って、明るさ・量・色・HUD・動き・音を数で見る
• 音は WebAudio の再生回数で「鳴っているか」を確かめられる（音量は人）
• 検査はゲーム側に入口（?autostart=1）を作って、UI の位置に依存させない