文档

Unity Engine

User Manual

Script Reference

Unity Engine

Web 中的缓存行为

Customize the Web cache behavior.
阅读时间4 分钟最后更新于 1 个月前
在 Unity Web 平台中，缓存 API 允许您将缓存在 
.data
文件和 AssetBundle 中的资产数据存储在浏览器缓存中。浏览器缓存的存储限制（例如最大文件大小、最大整体缓存大小和驱逐条件）取决于您使用的浏览器和平台。有关更多信息，请参阅浏览器存储限制和驱逐条件。

数据缓存

要访问数据缓存，请从文件 (File) > 构建设置 (Build Settings) > 播放器设置 (Player Settings) 中打开 Web 的发布设置 (Publishing Settings)。这样，浏览器会将主数据文件缓存到 IndexedDB 数据库中。
使用默认浏览器 HTTP 缓存并不能保证浏览器缓存特定响应。这是因为浏览器 HTTP 缓存空间有限，浏览器可能无法缓存过大的文件。
为了提高加载速度，
IndexedDB
允许您缓存超过浏览器限制的文件。当你缓存更多的文件时，就增加了在下一次运行该构建版本时，已下载的内容在用户机器上可用的几率。
数据缓存仅为 HTTP 响应缓存 IndexedDB 缓存中的 
.data
文件。要缓存 AssetBundle，需要启用数据缓存并覆盖 
unityInstance.Module.cacheControl()
。为此，请确保 
Module.cacheControl(url)
返回所请求的 AssetBundle URL 的 
must-revalidate
。例如，可以在 
createUnityInstance()
返回的 Promise 的实现回调中覆盖 
unityInstance.Module.cacheControl()
函数。有关 
createUnityInstance()
的更多信息，请参阅压缩构建和服务器配置。

自定义 Web 缓存行为

默认情况下，Web 缓存会存储资产数据文件 
.data
和 AssetBundle 文件 
.bundle
，并在从缓存加载它们之前重新验证它们。您可以通过添加新的 Web 模板来更改 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
    - 如果函数返回 immutable，则启用缓存并从缓存加载文件，无需重新验证。
  • no-store
    - 如果该函数返回 no-store，则禁用缓存。
浏览器会自动存储（缓存）某些文件类型，例如 .html、.js、.css、.json、.jpg、.png，因此它们不需要显式存储在 Web 缓存中。Web 缓存的典型候选对象包括大型文件和使用自定义文件格式的文件。