ウェブでのキャッシュ動作
ウェブキャッシュの動作をカスタマイズします。
読み終わるまでの所要時間 7 分最終更新 5日前
Unity ウェブプラットフォームでは、Cache API により、.データファイルやブラウザーキャッシュ内のアセットバンドルにキャッシュされたアセットデータを保存できます。最大ファイルサイズ、全体的な最大キャッシュサイズ、および除外基準などのブラウザーキャッシュのストレージ制限は、使用しているブラウザーとプラットフォームによって異なります。詳細については、ブラウザーストレージ制限と回避基準 を参照してください。
データ キャッシング
データキャッシングにアクセスするには、ファイル> ビルドプロファイル > [] からウェブの公開設定を開きます。これにより、ブラウザーは主要データファイルを IndexedDB データベースにキャッシュできます。
プレイヤー設定
?
デフォルトのブラウザー HTTP キャッシュを使用しても、ブラウザーが特定の反応をキャッシュするとは限りません。これは、ブラウザーの HTTP キャッシュのスペースが限られており、ブラウザーが大きすぎるファイルをキャッシュできない可能性があるためです。
ロードスピードを向上させるために、 ではブラウザー制限を超えるファイルをキャッシュできます。より多くのファイルをキャッシュすると、ダウンロードしたコンテンツをユーザーのマシンで次回のビルド実行時に使用できる可能性が高まります。
IndexedDBブラウザーがキャッシュ内の主要データファイル (.data) をキャッシュできるようにするには、プレイヤー設定でデータキャッシュを有効にします (メニュー:編集> > プレイヤー)。デフォルトでは、標準のウェブローダー設定もアセットバンドルをキャッシュし、再検証します。このデフォルトを変更する場合 (例えば、バンドルのキャッシュの停止や他のファイルタイプのキャッシュなど) を除き、キャッシュ動作をオーバーライドする必要はありません。
IndexedDBプロジェクト設定
?
インスタンスを介してキャッシュコントロールを直接カスタマイズする場合は、要求されたアセットバンドル URL のが によって返され、キャッシュが有効になっていることを確認してください。例えば、 が返す Promise の履行コールバックの 機能をオーバーライドできます。
must-revalidateModule.cacheControl(url)createUnityInstance()unityInstance.Module.cacheControl()createUnityInstance()ウェブ Cache の動作をカスタマイズする
デフォルトでは、キャッシュ設定はアセットデータファイル .data とアセットバンドルファイル .bundle を格納し、キャッシュからロードする前に再検証します。この動作を変更するには、設定を変更する新しいウェブテンプレートを追加します。
UnityLoader以下の例は、 ファイル内の設定にカスタム 機能を追加する方法を示しています。
index.htmlUnityLoadercacheControlvar 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-
- 関数が must-revalidate を返すと、キャッシュは有効ステートに戻り、ファイルはキャッシュからロードされる前に再検証されます。
must-revalidate -
- 機能が不変を返す場合、キャッシュが有効になり、ファイルは再検証なしでキャッシュからロードされます。
immutable -
- 機能が no-store を返す場合、キャッシュは無効になります。
no-store
ブラウザーは、.html、.js、.css、.json、.jpg、.png などの特定のファイルタイプを自動的に保存 (キャッシュ) するため、ウェブ Cache に明示的に的に保存する必要はありません。ウェブ キャッシュの典型的な候補には、大きなファイルやカスタムファイル形式を使用するファイルなどがあります。