ゲームの最適化ガイド
ロード時間を縮め、スマホで軽く動かすための設定とコツをまとめたページです。Unity と Godot のおすすめのビルド設定と、エンジンを問わず守ってほしい一時停止・セーブ・タッチ操作の約束も載せています。
1. まず見るところ
GameRush のプレイヤーは、フィードを流しながらスマホでゲームを次々に開きます。読み込みが長いゲームは遊ばれる前に飛ばされ、重いゲームは端末が熱くなったりページごと落ちたりします。次の項目から順に見てください。
- Unity は Compression Format を Brotli、Decompression Fallback を切る
- Unity は Managed Stripping Level を Medium 以上、Strip Engine Code を有効、IL2CPP Code Generation を Faster (smaller) builds
- Unity は Enable Multithreading を切る。Godot は 4.3 以降で Thread Support を切る(スレッドありのビルドは GameRush で起動しない)
- 合計のビルドサイズは 15MB 以下 を目安にする。30MB 以上は危険(上限は 50MB)
- テクスチャと音声を圧縮し、使っていないアセットとパッケージを消す
- 最初のシーンは小さく作り、残りは後から読み込む
- ファイル数を少なくし、1ファイルは 25MB 未満 にする(先読みに載せる)
- ゲームが止められたとき(
visibilityStateが hidden になったとき)にセーブする(一時停止とセーブ) - スマホでは描画解像度とエフェクトを絞る
Unity と Godot の設定は SDK からまとめて適用してビルドできます(推奨設定でビルドする)。
2. GameRush が自動でやること
配信側で縮められる部分は GameRush が受け持ちます。作者が設定する必要はありません。
- 圧縮して配信する。 Studio の画面から上げたビルドは、圧縮せずに上げたファイルも、起動に要るもの(
wasm/data/jsなど)をこちらで圧縮して配信します。Unity Editor や API から上げたファイルは上げた形のまま配信するので、Brotli で書き出してください。Unityv1.14.0以降の Editor から上げた.unitywebのビルドだけは、確定のときに Brotli へ圧縮し直します。 - 次に流れるゲームを先に読んでおく。 エンジンを問わず、いま遊んでいるゲームの裏で、次のゲームのファイルを端末に取っておきます。間に合えば、開いたときにはダウンロードがほぼ終わっています。先読みされない条件は 先読みに載せる にあります。
- Unity の起動を急がせる。 Studio の画面と Unity
v1.14.0以降の Unity Editor の GameRush メニューから上げた Unity のビルドは、GameRush のプレイヤーで起動します。プレイヤーはwasmとdataのダウンロードを最優先で並行して始め、ローディングバーを出し、ビルドに同梱された Service Worker を止めます。 - エッジにキャッシュする。 ビルドは書き換わらない URL で配信され、各地のエッジに置かれます。
ビルドそのものの重さ(wasm と data の大きさ、圧縮の設定、起動時にやる処理)は、配信側では削れません。ここから先は作者側の設定で決まります。
3. ロード時間を縮める
先読みが間に合っているとき、ロード時間はほぼ「wasm のコンパイル + 起動処理」の時間です。どちらも端末の CPU で決まり、ビルドが大きいほど長くなります。つまり体感を決めるのは主にビルドの大きさです。
| 合計のビルドサイズ | 体感 |
|---|---|
| 〜15MB | 目安。快適に遊べる |
| 15〜30MB | 先読みが間に合わなかったとき、モバイル回線で待ちが目立ち始める |
| 30MB 以上 | 危険。飛ばされやすく、スマホでは読み込み中にページが落ちることもある |
| 50MB | アップロードの上限(超えると受け付けない) |
データを小さくする
- テクスチャ: 表示サイズより大きい画像を持ち込まない(スマホなら 1024px〜2048px が上限の目安)。圧縮フォーマットを使い、非圧縮のテクスチャを残さない。
- 音声: BGM は長いので圧縮率を上げる(Unity は Vorbis の Quality を下げる、Godot は Ogg Vorbis を使う)。短い効果音は小さく保つ。
- 使っていないもの: 試しに入れたパッケージやアセットは書き出し前に消す。Unity は Build Report や Editor.log の Build Report 節で、何が大きいかを確かめられる。
- 最初のシーン: 最初のシーンが参照するアセットは、起動時に必ず読まれるデータ(Unity の
.data、Godot の.pck)に入る。タイトル画面だけで起動し、残りは Addressables や後からの読み込みに回すと、起動が軽くなる。
先読みに載せる
先読みが間に合えば、ダウンロードの待ちはほぼ消えます。次の条件に当たると先読みされず、遊び始めてからネットワークで読み込みます。
- ファイルの一覧(ファイルごとのパスと大きさ)が 4096 バイトを超える作品は、先読みしません。一覧は1ファイルあたり 50〜60 バイトほどなので、目安は 70〜80 ファイルまでです。パスが長いほど少なくなります。
- iPhone と iPad では、25MB を超えるファイルは先読みしません。
- iPhone・iPad と、回線が遅いときやデータセーバーがオンのときは、先読みするのは次の1件だけです。
ファイル数を少なくし、1ファイルは 25MB 未満にしてください。画像はスプライトシートにまとめると数が減ります。
ロード画面を早く外す
GameRush は、ゲームが最初の1枚を描いた時点でロード画面を外します。数えるのは WebGL の描画と、DOM に載っていて大きさのある 2D の canvas への描画です。canvas を使わず DOM だけで描くゲームや、画面に載せていない canvas にだけ描くゲームはこれを検出できないので、起動し終えたら次の1行を呼んでください。
parent.postMessage({ type: "grush:ready" }, "*");描画を検出できず合図も来ないと、ロード画面はページの load の5秒後か、読み込みを始めてから15秒のどちらか早いほうまで外れません。Studio の画面から上げて Unity と判別されたビルドは、GameRush のプレイヤーがこの合図を自動で送ります。
4. 処理負荷を下げる
スマホのブラウザは、同じ端末のネイティブアプリより使える CPU・GPU・メモリがずっと少なく、フィードの画面と同じタブの中で動きます。重いゲームはフレームが落ちるだけでなく、端末が熱くなって性能がさらに下がったり、メモリが足りずにページごと再読み込みされたりします。
フレームレートと解像度
- Unity の WebGL は
Application.targetFrameRateが既定の-1のとき、ブラウザの描画タイミング(requestAnimationFrame)に合わせて動く。ふつうはこのままにして、重い端末でだけ 30 に下げる。 - Godot は
Engine.max_fpsで上限を決められる。既定の 0 は上限なしで、ブラウザの描画タイミングに合わせて動く。熱や電池が気になるスマホでだけ 30 にする。 - 高解像度の画面で等倍に描くと、ピクセル数は 3〜4 倍になる。GPU が重いゲームは描画解像度を下げるのがいちばん効く。
- フルスクリーンのポストエフェクト(ブルーム・被写界深度・SSAO など)と、リアルタイムの影は、スマホでは真っ先に削る候補。
void Awake()
{
if (Application.isMobilePlatform)
{
Application.targetFrameRate = 30;
}
}func _ready() -> void:
if OS.has_feature("web_android") or OS.has_feature("web_ios"):
Engine.max_fps = 30CPU とメモリ
- 毎フレームの割り当てを減らす。 Unity の WebGL はガベージコレクションがフレームの合間にまとめて走るので、
Updateでnewや文字列の連結を繰り返すと、定期的にカクつく。弾や敵はオブジェクトプールで使い回す。 - スレッドに頼らない。 GameRush ではマルチスレッドの書き出しが動かないので、重い計算は複数フレームに分けるか、事前に済ませておく。
- メモリを使い切らない。 iPhone の Safari は1つのタブが使えるメモリに上限があり、超えるとページごと再読み込みされる。大きなテクスチャや音声を一度に全部読み込まず、使い終わったシーンのアセットは解放する。
- 物理とパーティクルの数を絞る。 同時に動かすオブジェクトの数が、そのまま CPU の負荷になる。
測る
Studio のアナリティクスには、実際のプレイヤーの端末で測ったロード時間(平均・95%の読み込みが収まる時間・途中離脱率)とフレームレートが出ます。API からも取れます(アナリティクス)。設定を変えたら、次のビルドで数字がどう動いたかを見てください。
手元で確かめるときは、パソコンのブラウザではなく実際のスマホで、できれば数年前の機種で開いてください。パソコンで快適なゲームがスマホで重いのはよくあることです。
5. Unity のおすすめ設定
Player Settings > WebGL で設定します。SDK の GameRush > 推奨設定でビルド を使うと、下の表をまとめて適用してビルドできます(推奨設定でビルドする)。
| 設定 | おすすめ | 理由 |
|---|---|---|
| Publishing Settings > Compression Format | Brotli | いちばん小さくなる。GameRush は正しいヘッダーを付けて配信する |
| Publishing Settings > Decompression Fallback | オフ | オンにすると、ダウンロードとコンパイルが並行しなくなる |
| Publishing Settings > Data Caching | オフ | GameRush が自分で先読みとキャッシュをするので二重になる |
| Other Settings > Managed Stripping Level | Medium(High でも可) | 使っていないコードを削って wasm を小さくする |
| Other Settings > Strip Engine Code | オン | 使っていないエンジンの機能を削る |
| Other Settings > IL2CPP Code Generation | Faster (smaller) builds | 実行速度よりサイズを優先する |
| Other Settings > C++ Compiler Configuration | Release | デバッグ用の情報を載せない |
| Build Settings > Code Optimization(2022 以降) | Disk Size(Unity 6 は Disk Size with LTO) | wasm が小さくなる |
| Publishing Settings > Enable Exceptions | Explicitly Thrown Exceptions Only | 例外の検査を減らして小さく速くする。None にするとエラーの原因が追えなくなる |
| Other Settings > Graphics APIs | WebGL 2 だけ | WebGL 1 向けの分を持たない |
| Publishing Settings > Enable Multithreading | オフ | GameRush の配信ではスレッドが動かず、オンのビルドは起動しない |
| Build Settings > Development Build | オフ | 開発用ビルドは大きく遅い |
Managed Stripping Level を High にすると、リフレクションで呼んでいるコードまで削られて動かなくなることがあります。そのときは Medium に戻すか、link.xml で残す型を指定してください。
レンダーパイプラインは Built-in か URP を使ってください。HDRP は WebGL に対応していません。
6. Godot のおすすめ設定
Godot 4.3 以降の Project > Export の Web プリセットで設定します。SDK の GameRush SDK Build プラグインを使うと、下の設定の「GameRush Web」プリセットを作って書き出せます(推奨設定でビルドする)。
| 設定 | おすすめ | 理由 |
|---|---|---|
| Variant > Thread Support | オフ | GameRush の配信ではスレッドが動かず、オンのビルドは起動しない |
| Variant > Extensions Support | オフ | GDExtension を使わないなら要らない |
| VRAM Texture Compression > For Mobile | オン | スマホの GPU が読める形式(ETC2 / ASTC)のテクスチャを入れる |
| VRAM Texture Compression > For Desktop | オン | パソコンのブラウザで遊ぶ人向け |
| Progressive Web App > Enabled | オフ | Studio は PWA の部品を捨て、GameRush のプレイヤーは Service Worker を登録しないので使われない |
| Export Path | 任意の名前 | Studio は書き出した名前のまま受け取る。ServiceWorker と __ で始まる名前は使えない |
- レンダラーは Compatibility を使ってください。Web への書き出しで動くのは Compatibility だけです。
- For Mobile をオンにするには、Project Settings の Rendering > Textures > VRAM Compression > Import ETC2 ASTC もオンにします。テクスチャの取り込み直しが走り、
.pckは大きくなります。2D で Lossless のテクスチャしか使っていないなら影響はほとんどありません。 .pckは起動時に丸ごと読まれます。使わないリソースは Export の Resources タブで除外してください。- Godot 4.5.1 で音を鳴らし続けると、iOS の Safari でページが落ちるという報告があります。公開前に iPhone の実機で通して遊んでください。
7. Phaser と Web(その他のツール)
- アセットの参照は相対パスにする(Vite なら
base: "./")。 - 本番用にビルドして minify する。ソースマップは上げない。
- 画像はスプライトシートにまとめ、
webpを使う。音声はogg/m4aにする。 - 起動に要らないアセットは、タイトル画面を出してから読み込む。
- GameRush のローディングバーは出ないので、読み込み中の表示はゲームの側で用意する。
書き出しの手順とアップロードで弾かれる条件は 対応エンジンと書き出しガイド にあります。
8. 一時停止とセーブ
エンジンを問わず、どのゲームにも当てはまる約束です。
- プレイヤーが閲覧モードへ切り替えたときや、次のゲームへ送り始めたとき、GameRush はゲームを止めます。
requestAnimationFrameとタイマー、音の再生を止め、再開すると続きから動かします。 - 止めるとき、ゲームからは
visibilityStateが hidden に見え、visibilitychangeが届きます。セーブは hidden になったときに行ってください。 - 画面から離れたゲームは、ページごと捨てます。戻ってきたときは最初から起動し直すので、続きから遊ばせたいゲームは hidden の時点でセーブしておいてください。
9. タッチ操作とスクショ
GameRush はエンジンを問わずどのゲームにも、スワイプで文字が選択されたり、画面が引っ張られて LINE のミニアプリが閉じかけたりしないための設定を自動で入れます。ゲームの側で次のことを守ると、確実に効きます。
- スクロールさせたい部分は
overflow: autoの要素にする。 スワイプで画面ごと動くことはなくなりますが、overflow: autoやscrollの要素の中だけは、その向きに指で普通にスクロールできます。入力欄の上も止めません。 touchmoveをstopPropagationしない。 止めると、GameRush の側で画面の引っ張りを止められなくなります。既定動作を止めたいときはpreventDefaultを使ってください。- 文字を選ばせたいところだけ
user-select: textと-webkit-user-select: textを書く。 GameRush の設定は要素の一つ一つに当たるので、選ばせたい要素とその子孫の両方(.log, .log *のように)に書いてください。詳細度は 0 なので、ゲームのスタイルが常に優先されます。入力欄はもとから選択できます。 - スクショに映したいものは canvas に描く。 コメントに添付するスクショには、基準の canvas と、それに重なっている見えている canvas が映りますが、HTML の要素で出した文字や画像は映りません(映すには、下の「HTML の要素ごと撮る」の
domを使います。GameRush のアプリでコメントに添付するスクショには、何もしなくても映ります)。WebGL の canvas を重ねている場合は、基準の canvas と同じ処理の中で描いた canvas か、preserveDrawingBuffer: trueで作った canvas だけが映ります。基準の canvas の選ばれ方と、見た目どおりに撮られないときの直し方は、下の「スクショの撮られ方」にあります。 - 別のオリジンの画像は、CORS を許可して読み込んでから canvas に描く。 許可なしに描いた canvas はブラウザが読み出しを禁じるので、スクショに映りません。基準の canvas がそうなると、スクショを添付できなくなります。
スクショの撮られ方
コメントに添付するスクショと、ゲームからの共有 の "screen" は、同じ画像です(GameRush のアプリのコメントのスクショは、下の「アプリでコメントに添付するスクショ」)。GameRush がプレイ中のゲームの canvas から、1 秒に 1〜4 回撮ります。撮るのは、requestAnimationFrame かタイマー(setTimeout・setInterval)のコールバックが済んだ直後と、WebGL の描画の直後です。2D の canvas だけのゲームが、どちらのコールバックも使わずに描くと、撮られません。ゲームを止めた後には撮らないので、コメントに添付されるのは止める直前の 1 枚です(dom を使うゲームは、下の「HTML の要素ごと撮る」のとおり、止めた後の画面です)。
- 映るのは canvas だけです。 HTML の要素で出した文字や画像は映りません。HTML の要素も映したいときは、下の
domを使ってください。GameRush のアプリでコメントに添付するスクショだけは、画面そのものから作ります(下の「アプリでコメントに添付するスクショ」)。 - 基準になるのは、見えている 2D か WebGL の canvas のうち、画面上でいちばん大きく映っているものです。 その半分以上の大きさで映っている canvas がほかにあれば、その中で画素数(
width×height)がいちばん多いものを選びます。display: noneの画面の中にある canvas、透明にした canvas、画面の外へ出した canvas は選びません。スクショに映る範囲と縦横比は、基準の canvas で決まります(幅 1080px、総画素数 120 万までに縮めます)。 - 基準に重なっている見えている canvas を、画面上の位置と大きさに合わせて重ねます。 重ねる順は、canvas 自身の
z-indexの小さい順で、同じなら HTML に書いた順です。 - 重ねる順に、親の要素の重なり順は入りません。 canvas の手前にある HTML の要素は映らず、CSS の
mask・clip-path・半透明のopacityも反映しません。画面では吹き出しの奥にある立ち絵が、スクショでは手前に出ることがあります。
見た目どおりに撮られないときは、data-grush-capture 属性で撮り方を指定してください。値は小文字の only・ignore・dom です。only と ignore は canvas に、dom は canvas を包む要素に付けます。ゲームの途中で付け外しできます。
| 値 | 撮り方 |
|---|---|
data-grush-capture="only" | この canvas だけを撮ります。ほかの canvas を重ねません。display: none などで表示していなくても撮りますが、HTML の中に置いてください(document.createElement で作っただけの canvas は撮りません) |
data-grush-capture="ignore" | この canvas を基準にも、重ねる canvas にもしません |
data-grush-capture="dom" | <body> か、ゲームの画面を包む要素に付けます。コメントに添付するスクショと共有の "screen" を、その要素が画面に占める範囲の HTML ごと撮ります |
<!-- 画面全体を自分で描いた canvas。表示しなくても、これだけがスクショになる -->
<canvas id="shot" width="720" height="1280" data-grush-capture="only" hidden></canvas>
<!-- 吹き出しの奥にある立ち絵。スクショには重ねない -->
<canvas id="portrait" width="256" height="384" data-grush-capture="ignore"></canvas>- 画面全体を 1 枚の canvas に描いているなら、その canvas に
onlyを付けると、その canvas の中身がそのままスクショになります。 - HTML の要素で画面を作っているゲームは、
<body>にdomを付けてください(次の節)。スクショにしたい絵を自分で canvas に描けるなら、その canvas にonlyを付ける方法もあります。プレイ中に撮るので、その canvas はプレイ中に描き直し続ける必要があります。 - 立ち絵や演出の canvas が、スクショで手前に出て困るときは、その canvas に
ignoreを付けてください。 onlyを付ける canvas は 1 枚にしてください。複数に付けると、画面上でいちばん大きく映っているものを撮り、どれも表示していなければ最初にgetContextを呼んだものを撮ります。
HTML の要素ごと撮る
data-grush-capture="dom" を付けた要素があると、コメントに添付するスクショと共有の "screen" は、canvas の合成ではなく、HTML の要素を含む画面から作ります。撮るのは、プレイヤーがコメントのシートを開いたときと、ゲームが共有を呼んだときの 1 回だけです。コメントでは、止めた後の画面が映ります。プレイ中に増える処理は、WebGL の canvas を別の canvas に重ねているゲームで、WebGL の canvas の写しを 1 秒に 1〜4 回取ることだけです。
<!-- HTML の要素で作った画面を、見た目のまま撮る -->
<body data-grush-capture="dom">
<div id="message">HTML で出した吹き出し</div>
<canvas id="portrait" width="256" height="384"></canvas>
</body>- 映る範囲は、属性を付けた要素が画面に占める矩形です。
<html>か<body>に付けると、画面の全体になります。付ける要素は 1 つにしてください。 - CSS の重なり順・
mask・opacity・transformは、画面のとおりに映ります。 CSS のアニメーションとトランジションは、撮った瞬間の見た目で止めて撮ります。入力欄には、入力されている値が映ります(パスワードの欄に入力した値は映りません)。 - canvas は、撮った瞬間の中身が映ります。 WebGL の canvas は、GameRush が最後に撮ったときの絵(最大で 1 秒前)が映ります。
ignoreを付けた canvas は、中身を映しません。 - 画像・スタイルシート・フォントは、ビルドに含めたファイルと
blob:の URL から読んだものだけが映ります。 Google Fonts のフォントで出した文字は、代わりのフォントで映ります。別のサイトから読んだ画像(プレイヤーのアバターなど)は、映らないことがあります。 - 映らないもの: 要素の中のスクロール位置(先頭の位置で映ります。ページ全体のスクロールは映ります)、
:hoverと:focusの見た目、shadow DOM の中身、<iframe>の中身、showModal()で開いた<dialog>の位置と背景、popover、JavaScript のFontFaceで足したフォント。 <!DOCTYPE html>で始まる文書にしてください。 無い文書(互換モード)は、高さの決まり方が変わり、画面と違うレイアウトで映ることがあります。- 作れなかったときは、canvas だけのスクショに戻ります。 要素が 2 万個を超える画面や、2.5 秒で作り終わらない画面です。作り終わるまで(ふつうは 0.5 秒以内)は、コメントのシートに canvas だけの画像が出ます。
- コメントのシートで選べる直前の数秒のコマは、
domを付けても canvas だけの画像です。そのコマの撮り方は、onlyとignoreで指定できます。
アプリでコメントに添付するスクショ
GameRush の iOS・Android のアプリでは、コメントに添付するスクショを、ゲームを止める直前の画面そのものから作ります。HTML の要素で出した文字や画像も、属性を付けなくても、画面のとおりの重なり順で映ります。Web と LINE では、上の撮られ方で作ります。アプリでも、共有の "screen" と、コメントのシートで選べる直前の数秒のコマは、上の撮られ方で作ります。
- canvas だけで描いているゲームは、Web と同じ画像になります。 canvas のほかに、文字・画像(
<img>・<svg>・<video>)・操作部品(<button>・<input>など)が画面に出ているときに、画面から作ります。背景色や背景画像だけの要素と、疑似要素(::before・::after)で出した文字は数えません。それらで出した UI も映したいときは、domを付けてください。 - 映る範囲は、基準の canvas が画面に占める範囲です。 基準の canvas の外にも文字・画像・操作部品が出ているときと、canvas が無いゲームでは、ゲームの画面の全体になります。
domを付けた要素があれば、その要素が画面に占める範囲が映ります。 範囲を決めたいときに使ってください。onlyを付けた canvas があれば、その canvas が画面に占める範囲が映ります。 その canvas を表示していないときは、Web と同じく、canvas の中身がそのままスクショになります。ignoreを付けた canvas が画面に出ているときも、画面から作ります。 その canvas も映ります。画面のとおりの重なり順で映るので、手前に出ることはありません。- 画面から作れなかったとき(Android 7 以前の端末など)は、Web と同じ画像になります。