GodotのWeb書き出しで注意すること｜C#・描画・スレッド・配信条件

1. 言語とレンダラーの条件から確認する

確認時のGodot公式資料では、Godot 4のC#プロジェクトはWebへ書き出せないとされています。WebではCompatibilityの描画方式によるWebGL 2が対象で、Forward+とMobileの描画方式は対象外です。ネイティブ版で使える選択肢を、そのままWeb版の条件と考えないようにします。

企画の段階で、使用言語、描画方式、必須の拡張機能を一覧にします。ブラウザで遊べることを優先するなら、この段階でWeb向け構成を試しましょう。後から制限に気付いてゲーム全体の作り方を変えるより、主人公一体と小さな地形だけで基本の表示を確認する方が、判断を早くできます。

2. 単一スレッドと、分離が必要な構成を比べる

公式資料はGodot 4.3以降の単一スレッドでのWeb書き出しを案内し、既定の方式としています。スレッドを利用する構成ではSharedArrayBufferやクロスオリジン分離の条件が関係します。ヘッダーを自分で設定できる配信先か、外部素材をどう読むかも含めて検討する必要があります。

この記事の提案は、初期版を単一スレッドで試し、足りない処理を具体的に測定してから複雑な構成を検討する順序です。スレッドを増やすこと自体を目的にせず、物理、探索、音のどこに要件があるかを調べます。配信先が制御できないヘッダーを必須にすると、エディターで動く作品でも公開先で開始できない可能性があります。

分離を使う検証では、ゲーム本体だけでなく周囲のページも確認します。案内ページの外部フォントや別のサービスの埋め込みを含め、必要な素材が読めるかを見ます。設定を複数箇所に増やす前に、どのURLでどのヘッダーを返すのかを表にすると、担当者や配信環境が変わっても見直せます。

3. 書き出したファイルの組を、そのまま配信する

公式資料は書き出しにindex.htmlを使うことを勧め、生成時の名前に依存するファイルを後から変更すると問題が起きる可能性を説明しています。生成したHTMLを直接編集しても、次の書き出しで失われる変更があります。継続するカスタマイズにはCustom HTML shellの仕組みを使う方針が案内されています。

公開作業では、HTMLだけをコピーして完了とせず、生成されたファイル一式を同じ版の組として扱います。更新前後のファイルが混ざると、エンジンとゲームデータの組み合わせを追いにくくなります。配信を切り替える前に、初めて開く場合と以前に開いた場合の両方を確認し、古いファイルが残る状態も見直しましょう。

Web書き出し確認メモ
Godotの版／書き出しテンプレート：
言語とレンダラー：
スレッド・拡張機能の設定：
生成ファイル一覧：
配信先のヘッダー設定：
最初の場面が開始できる端末：

4. 音の演出は、Web版で必要な効果を選ぶ

公式Web資料は、Sampleの音再生とStreamを使う再生の違いを説明しています。Sampleでは一部の音声効果などに制限があり、Streamを選ぶ場合には遅延との関係も変わります。ネイティブ版で使った全効果を必須にする前に、Web版でゲームの操作や情報を伝えるために必要な音を決めます。

最小の確認用作品には、開始、移動、決定の音と、短いBGMを入れます。音がなくても操作が分かる表示を用意し、音の設定を変えて戻れるようにします。空間的な演出が必要な3D作品では、その場面を追加で試します。ここでの項目は当ブログの設計案です。資料の制限を踏まえた確認ができたら、次にステージ数や素材量を増やすと、問題の原因を分けやすくなります。

検証記録には、ネイティブ版では表示されるがWeb版では外した演出も書きます。単に不具合として残すのではなく、ブラウザ向けの構成として採用した差を明示します。主人公の位置や重要な目印が同じように読めるなら、装飾を調整した版を提供する判断もできます。Web版を完成形の小型版として設計しておくと、後からネイティブ版の機能を増やした場合にも、必要な要素を選び直せます。

• 最小シーンを配信先で開く
• 必要な拡張がWeb向けに使えるか確認する
• 音の再生方式と必要な効果を記録する
• 初回表示と更新後の表示を両方確認する