メインコンテンツへスキップ
見出し画像

Web製ゲームをGodotへ移植して実機の遅さと無音を消す手順【実録#33・Godot移植】

    Canvas+TypeScriptで作ったミニゲームを、実機Androidで動かしたら「絶望的に遅い」「音が鳴らない」というフィードバックが10件届きました。

    この記事は、Web技術で作ったゲームがスマホ実機で遅くて詰まっている人向けです。私が実際に1エンジンだけGodotへ移植して、その日のうちに検証まで終えた記録を、失敗も込みで全部書きます。

    結論から言います。移植版を署名APK(27MB)にして実機へ入れたら、オーナー評価は「旧版に比べて圧倒的にいい」でした。速度・音・操作性がまとめて直りました。

    でも一番の学びは、そこではありません。「エンジンに載せ替えると、狙って作ったバグ挙動まで直ってしまう」という、移植ならではの落とし穴でした。

    この記事を読むと手に入るもの

    章扉カード01

    読み終わると、次の状態になります。

    • Web製ゲームがスマホで遅い・無音になる根本原因を切り分けられる

    • 「エンジンに載せると壊れるロジック」を事前に見極められる

    • CRT/グリッチ表現を、WebGLの手書きシェーダより短いコードでGodotに移植できる

    • 表示なしで物理を確定検証する、CIっぽい自己テストの型を持てる

    Web製ゲームをネイティブ化したいけど、Unityは重いしReact Nativeでは物理が辛い。そんな中途半端な場所で止まっている人に、ちょうど刺さる内容だと思います。

    あなたも「WebViewで動いてるから、そのまま実機でも動くだろう」と思っていませんか。私はそう思っていて、見事に裏切られました。

    きっかけは実機フィードバック10件

    章扉カード02

    もともとのゲームは、HTML5のCanvasとTypeScriptで書いた、ドット絵のミニゲームです。Capacitorでラップして実機Androidアプリにしていました。

    ブラウザで動かす分には、何の問題もありませんでした。60fpsでヌルヌル動くし、効果音も鳴る。「WebViewに入れるだけだから、実機でも同じだろう」と、私は完全に油断していました。

    ところが実機で動かすと、フィードバックが10件。内容は主に2つに集約されました。

    • 絶望的に遅い(カクついてゲームにならない)

    • 音が鳴らない(効果音が出たり出なかったり)

    ブラウザでは起きない。実機のWebViewでだけ起きる。この時点で「WebViewの合成コストか、AudioContextか」と当たりはつきました。でも対症療法でパッチを当て続ける未来が、まったく楽そうに見えませんでした。

    私の価値観は「将来手のかからない方法を選ぶ」です。ここで一度、土台から作り直す判断をしました。

    遅さと無音の原因はWebViewの構造にあった

    章扉カード03

    原因を切り分けると、2つともWebViewというサンドボックスの構造的な制約でした。ここは無料で全部説明します。理解に金は取りません。

    まず遅さ。UIのガラス質感を出すために、CSSのbackdrop-filterを多用していました。これがWebViewでは毎フレーム背景を再計算する合成コストになります。デスクトップのGPUなら誤魔化せても、モバイルのWebViewでは毎フレームの負荷が致命的でした。

    次に無音。WebのオーディオはAudioContextで鳴らしますが、モバイルのWebViewではAudioContextがsuspend状態に固着することがあります。ユーザー操作で一度resumeしても、また眠る。だから「鳴ったり鳴らなかったり」になっていたわけです。

    つまり両方とも、私のコードのバグではなく、WebViewの上で動かすこと自体が原因でした。パッチでは根治しない。だからエンジンを変える、という判断に至りました。

    Web製ゲームのネイティブ化で悩んでいる人、この「WebViewの合成コストとAudioContext固着」の2点、心当たりありませんか。

    なぜGodotを選んだか

    章扉カード04

    選択肢はいくつかありました。Unity、React Native + ゲームエンジン、あるいはWebViewのまま最適化。私が選んだのはGodot 4.6です。

    理由はシンプルで、2Dのドット絵ゲームに対してオーバースペックでなく、かつネイティブに描画・発音できるからです。Unityは3Dパーティー向けの別プロジェクトで使っていますが、この2Dミニゲームには重すぎる。将来の共通基盤化まで見据えて、軽い方を選びました。

    ただし、いきなり全部を移植するのはリスクが高い。そこでまず1エンジンだけのパイロット移植を実施しました。ゴールは2つ。

    • グリッチ(意図的なバグ表現)がGodotで再現できるか

    • 移植の工数がどれくらいか

    これを1日で実測して、全面移行の是非を判断する。この「小さく試して測る」段取りが、結果的に正解でした。

    最大の罠:エンジンに載せると「バグ」が直ってしまう

    章扉カード05

    ここが、この記事で一番伝えたい話です。

    このゲームの面白さの核は、「意図的なバグ挙動」でした。たとえば後ろ向きに加速すると速度上限をすり抜けて異常な速さで飛ぶ、という有名な「BLJ」的な挙動です。プレイヤーはこれを見つけて楽しむ。バグが仕様であり、コンテンツなのです。

    さて、GodotにはCharacterBody2Dとmove_and_slide()という便利な移動関数があります。普通に移植するなら、これを使いたくなる。

    でも、ここに罠があります。物理をmove_and_slideに載せ替えると、狙って作った「速度上限すり抜け」が、Godotの物理エンジンの副作用に化けて、再現不能になるのです。

    エンジンは「正しく」衝突を解決してしまう。だから、意図的なバグが「直って」しまう。移植して品質が上がったのに、面白さが消える。これは笑えない事故です。

    そこで私が取った設計判断が、ハイブリッド構成でした。

    • 物理だけは自前で残す:タイル衝突・移動・ジャンプは、元のTypeScriptのphysicsStepをそのままGDScriptへ移植し、_physics_process(60fps固定)で1ステップずつ回す

    • 周辺はGodotネイティブ化:CRT/グリッチ表現、画面揺れ、破片パーティクル、UI、効果音は全部Godotの標準機能で作り直す

    「エンジンに全部任せる」でも「全部自前」でもない。壊れると困る部分だけ自前で守り、それ以外はエンジンに任せる。この線引きが、移植の成否を分けました。

    あなたのゲームに、「エンジンに載せたら再現できなくなる挙動」はありませんか。それを移植前に洗い出せるかどうかが、勝負の分かれ目です。

    Godotのスクリーンシェーダは、想像以上に強かった

    章扉カード06

    移植して一番「これは楽だ」と感じたのが、CRT/グリッチのポストプロセスです。

    Web版では、WebGLで7タップの手書きCRTシェーダを書いていました。走査線、色収差、歪み。それなりの行数でした。

    Godotでは、これが劇的に短くなります。仕組みはこうです。

    • CanvasLayer(最前面)の下に

    • BackBufferCopy(画面をコピー)を置き

    • その下に全画面ColorRect(ShaderMaterial付き)を敷く

    シェーダ側はhint_screen_textureで画面全体を読み取り、走査線やグリッチを乗せるだけ。画面まるごとに後処理をかける構造が、ノード3つで組めるのです。WebGLで自前フレームバッファを管理していた頃と比べると、別世界でした。

    効果音も同じく楽でした。Web版のAudioContext固着問題は、Godotではそもそも発生しません。しかもファイルを1つも用意せず、AudioStreamWAVにコードでsin波やノイズを書き込んで、手続き的に効果音を生成できました。アセット管理から解放されたわけです。

    ヘッドレス自己検証で、物理を確定アサートする

    移植でもう1つ効いたのが、表示なしの自己検証です。

    Godotは--headlessで起動して、SceneTreeを継承したスクリプトを走らせられます。ゲームのロジックを.new()して、ツリーの外で物理を1ステップずつ叩き、結果を確定的にアサートする。表示なしで、CIのように回せます。

    パイロットでは、この方式で8項目の物理テストを書き、全てPASSさせました。中でも象徴的だったのが、「BLJで速度が12.0に達し、速度上限をすり抜けることを実証」したテストです。意図的なバグ挙動が、移植後も数値で保証されている。これは安心感が違いました。

    「面白さ=バグ挙動」を移植するなら、そのバグをテストで守る。逆説的ですが、これが正解でした。

    この記事の全体像(アーキテクチャは全部見せます)

    ここまでで、移植の設計思想は全部説明しました。整理すると、こうです。

    • 描画:480×288固定・60fps固定。物理は_physics_processで1ステップ

    • 物理:意図的バグを守るため自前実装(move_and_slideは使わない)

    • 後処理:CanvasLayer > BackBufferCopy > ColorRect(ShaderMaterial)のスクリーンシェーダ

    • 効果音:AudioStreamWAVを手続き生成し、プールで再生

    • 検証:--headlessでSceneTreeを回し、物理を確定アサート

    「なぜ動くか」はこれで全部です。ここから先は、実際に手を動かすと数時間〜十数回のリトライで溶かす、具体的な手順とコードと罠を出します。

    有料部分の目次(隠さず全部見せます)

    有料部分では、次を扱います。

    1. 設計判断の理由:move_and_slideを捨ててハイブリッドにした損益分岐
    2. ハマりどころ全リスト:BackBufferCopyなしでscreen_texture空/ヘッドレスはシェーダ非コンパイル/レベルロード時の入力リセット漏れ/マップ固定幅クラッシュ/全画面背景が入力を奪う
    3. Androidエクスポートの沼:無言のconfiguration errorsに10回はまった原因と、一撃で抜ける1行
    4. 運用で分かった実数値:ヘッドレス8項目の中身、署名APK27MBの内訳、リトライ回数
    5. そのまま動くコード一式:CRTスクリーンシェーダ全文、AudioStreamWAV手続き生成、ヘッドレス検証スクリプト、BackBufferCopy構成手順
    6. カスタマイズの勘所:自分のゲームに合わせる3点

    自分でゼロから試すと、Androidエクスポートの無言エラーだけで軽く半日は溶けます(私は原因特定に10回のリトライを要しました)。この記事は、その試行錯誤を¥500で省略するものです。CRTシェーダの構成順、BackBufferCopyの必須設定、ヘッドレスでシェーダが検証できない理由、入力状態のリセット漏れ、Androidの無言エラーの正体——自力なら1つずつ踏み抜く罠を、全部先回りして置いておきます(コード一式付き)。

    ◀ 前回: 使うほど赤字のAIアプリを広告eCPM連動で無人黒字化する監査手順【実録#32・採算自動化】

    📚 シリーズ全話はまとめマガジンへ

    https://note.com/lazy_engineer/m/m03a726b1673c

    💡 ここから先は有料です(¥500)
    Web製ゲームのGodot移植で、私が実際に溶かした「無言エラー10回・screen_texture空・レベル切替クラッシュ」の回避手順とコード一式を、答え合わせできる形で全部渡します。

     
     
    ITエンジニア9年目 / AI自動化 / note副業実録 AIを使えば、もっと楽できると気づいた。 noteで月10万円を目指す過程を、売上スクショ付きで全部公開します。 うまくいかない月も、ちゃんと出します。 「重い副業はしたくない」エンジニア・IT系の人に届けたい。

    あなたへのおすすめ