ドキュメント

Unity Engine

Unity Engine

ウェブでのキャッシュ動作

ウェブキャッシュの動作をカスタマイズします。
読み終わるまでの所要時間 7 分最終更新 5日前

Unity ウェブプラットフォームでは、Cache API により、.データファイルやブラウザーキャッシュ内のアセットバンドルにキャッシュされたアセットデータを保存できます。最大ファイルサイズ、全体的な最大キャッシュサイズ、および除外基準などのブラウザーキャッシュのストレージ制限は、使用しているブラウザーとプラットフォームによって異なります。詳細については、ブラウザーストレージ制限と回避基準 を参照してください。

データ キャッシング

データキャッシングにアクセスするには、ファイル> ビルドプロファイル > [
プレイヤー設定

?

] からウェブの公開設定を開きます。これにより、ブラウザーは主要データファイルを IndexedDB データベースにキャッシュできます。
デフォルトのブラウザー HTTP キャッシュを使用しても、ブラウザーが特定の反応をキャッシュするとは限りません。これは、ブラウザーの HTTP キャッシュのスペースが限られており、ブラウザーが大きすぎるファイルをキャッシュできない可能性があるためです。
ロードスピードを向上させるために、
IndexedDB
ではブラウザー制限を超えるファイルをキャッシュできます。より多くのファイルをキャッシュすると、ダウンロードしたコンテンツをユーザーのマシンで次回のビルド実行時に使用できる可能性が高まります。
ブラウザーが
IndexedDB
キャッシュ内の主要データファイル (.data) をキャッシュできるようにするには、プレイヤー設定でデータキャッシュを有効にします (メニュー:編集>
プロジェクト設定

?

> プレイヤー)。デフォルトでは、標準のウェブローダー設定もアセットバンドルをキャッシュし、再検証します。このデフォルトを変更する場合 (例えば、バンドルのキャッシュの停止や他のファイルタイプのキャッシュなど) を除き、キャッシュ動作をオーバーライドする必要はありません。
インスタンスを介してキャッシュコントロールを直接カスタマイズする場合は、要求されたアセットバンドル URL の
must-revalidate
が
Module.cacheControl(url)
によって返され、キャッシュが有効になっていることを確認してください。例えば、
createUnityInstance()
が返す Promise の履行コールバックの
unityInstance.Module.cacheControl()
機能をオーバーライドできます。
createUnityInstance()
の詳細については、「 圧縮ビルドとサーバー設定 」を参照してください。

ウェブ Cache の動作をカスタマイズする

デフォルトでは、キャッシュ設定はアセットデータファイル .data とアセットバンドルファイル .bundle を格納し、キャッシュからロードする前に再検証します。この動作を変更するには、
UnityLoader
設定を変更する新しいウェブテンプレートを追加します。
以下の例は、
index.html
ファイル内の
UnityLoader
設定にカスタム
cacheControl
機能を追加する方法を示しています。
var config = { // ...#if USE_DATA_CACHING cacheControl: function (url) { // Caching enabled for .data and .bundle files. // Revalidate if file is up to date before loading from cache if (url.match(/\.data/) || url.match(/\.bundle/)) { return "must-revalidate"; } // Caching enabled for .mp4 and .custom files // Load file from cache without revalidation. if (url.match(/\.mp4/) || url.match(/\.custom/)) { return "immutable"; } // Disable explicit caching for all other files. // Note: the default browser cache may cache them anyway. return "no-store"; #endif // ...}
cacheControl
機能は、リクエストのURLをパラメーターとして受け取り、以下のいずれかを返します。
  • must-revalidate
    - 関数が must-revalidate を返すと、キャッシュは有効ステートに戻り、ファイルはキャッシュからロードされる前に再検証されます。
  • immutable
    - 機能が不変を返す場合、キャッシュが有効になり、ファイルは再検証なしでキャッシュからロードされます。
  • no-store
    - 機能が no-store を返す場合、キャッシュは無効になります。
ブラウザーは、.html、.js、.css、.json、.jpg、.png などの特定のファイルタイプを自動的に保存 (キャッシュ) するため、ウェブ Cache に明示的に的に保存する必要はありません。ウェブ キャッシュの典型的な候補には、大きなファイルやカスタムファイル形式を使用するファイルなどがあります。