UI ToolkitだけでUnityのWebゲームを作る方法

3本目のゲームで、uGUI をプロジェクトから外しました。UI は UI Toolkit だけ。動くところまで行きましたが、道は平らではありませんでした。

EventSystem は uGUI の型だった

最初に書いたシーン生成スクリプトは、こうでした。

using UnityEngine.EventSystems;          // ← ここでコンパイルエラー
using UnityEngine.InputSystem.UI;

new GameObject("EventSystem", typeof(EventSystem), typeof(InputSystemUIInputModule));

error CS0234: The type or namespace name 'EventSystems' does not exist in the namespace 'UnityEngine'

EventSystem は uGUI パッケージ（com.unity.ugui）が持っている型です。uGUI を外したプロジェクトには存在しません。「UI Toolkit のボタンには EventSystem が要る」という話を前提にしていたので、ここで詰まりました。

調べ直すと、Unity 6.1 以降には PanelInputConfiguration があります。これをシーンに置くだけで、ボタンはブラウザでも反応しました（UNDO / RETRY / 面の選択、すべて実機の Chrome で確認）。

「UI Toolkit には EventSystem が必要」は、いまのバージョンでは当てはまらない。

PanelSettings を置く場所で2回失敗した

UI Toolkit を実行時に使うには PanelSettings が要ります。ここで3手かかりました。

最終的にはこれだけです。

static PanelSettings CreatePanelSettings()
{
    var settings = ScriptableObject.CreateInstance<PanelSettings>();
    settings.themeStyleSheet = Resources.Load<ThemeStyleSheet>("DefaultRuntimeTheme");
    settings.scaleMode = PanelScaleMode.ScaleWithScreenSize;
    settings.referenceResolution = new Vector2Int(1080, 1920);
    settings.match = 0.5f;
    return settings;
}

@import url("unity-theme://default");

消せていないエラーを、そのまま書いておく

3手目まで来ても、Web ビルドの起動時に出るエラーは消えていません。

A scripted object (probably UnityEngine.UIElements.PanelInputConfiguration?)
has a different serialization layout when loading. (Read 32 bytes but expected 60 bytes)

やったことと結果：

表示も入力も正常で、遊びには影響していませんでした。Unity 側の作り（エディターと実行時で持っている情報が違う）に見えますが、確かめきれなかったので、ここは「未解決」として公開しました。

RESULT 全件=77 serialization=0

画面はこうなった

UI Toolkit を触ってみて、良かったところと引っかかったところを並べます。

サイズについて、言えることと言えないこと

このビルドは 6,963,556 バイト（Brotli・Managed Stripping High・IL2CPP サイズ優先）でした。2本目（uGUI のみ）は 7,524,439 バイトです。

ただし、これを「UI Toolkit のほうが軽い」とは書けません。2本のゲームは中身が違い、パッケージの数も違います（11件 と 16件）。

ちなみに、ビルド設定の効果ははっきり出ました。unity projects create の直後（Stripping 最小・速度優先）が 9,080,745 バイト、2本目と同じ設定（Stripping High・サイズ優先・スプラッシュ停止）にして 6,958,566 バイト。−23.4% です。

まとめ

• EventSystem は uGUI の型。uGUI を外したら使えないが、PanelInputConfiguration で入力は届く
• PanelSettings は実行時に作るのがいちばん確実だった（シーンに保存できない／アセットだとエラー）
• テーマ（.tss）が無いと文字が出ない。中身は @import 1行
• 起動時の serialization エラーは、作り直したビルドで消えた（原因は不明・動作に影響は無かった）
• サイズの比較は、同じゲームで UI だけ入れ替えないと言えない