文档

Unity 引擎

Unity 引擎

Web 中的缓存行为

自定义 Web 缓存行为。
阅读时间4 分钟最后更新于 5 天前

在 Unity Web 平台中,缓存 API 允许您将缓存在 . 数据文件和 AssetBundles 中的资源数据存储在浏览器缓存中。浏览器缓存的存储限制(例如最大文件大小、最大整体缓存大小和驱逐条件)取决于您使用的浏览器和平台。有关更多信息,请参阅浏览器存储限制和驱逐条件。

数据缓存

要访问数据缓存,请从文件 > 生成配置文件 >
Player Settings(播放器设置)

?

Open the Publishing Settings for Web。这使浏览器能够将主要数据文件缓存到 IndexedDB 数据库中。
使用默认浏览器 HTTP 缓存并不能保证浏览器缓存特定的响应。这是因为浏览器的 HTTP 缓存 Space 有限,浏览器可能无法缓存太大的文件。
为了提高加载中的速度,
IndexedDB
允许您缓存超过浏览器 Limit 的文件。缓存更多文件When,下载的内容在Next一次版本运行时ON用户计算机上可用的可能性会增加。
要允许浏览器缓存
IndexedDB
缓存中的主要数据文件(.数据),请在 Player Settings 中启用 Data Caching(菜单:编辑 >
项目设置

?

> Player)。默认情况下,标准 Web 加载器配置也会缓存 AssetBundles 并重新验证它们。除非要Change默认(例如,停止缓存捆绑包或缓存Other文件类型),否则无需重载缓存行为。
如果您确实想直接通过实例自定义缓存 Control,请确保
Module.cacheControl(url)
返回所请求 AssetBundle 网址的
must-revalidate
以保持已启用缓存。例如,可以在
createUnityInstance()
返回的 Promise 的实现回调中重载
unityInstance.Module.cacheControl()
函数。
有关 ON
createUnityInstance()
的更多信息,请参阅经压缩的构建和 Server 配置。

自定义 Web 缓存行为

默认情况下,缓存配置会存储资源数据文件 .data 和 AssetBundle 文件 .bundle,并在从缓存加载中之前重新验证它们。要更改此行为,请添加可更改
UnityLoader
配置的新建网页模板。
以下示例展示了如何将自定义
cacheControl
函数添加到
index.html
文件中的
UnityLoader
配置。
var config = { // ...#if USE_DATA_CACHING cacheControl: 函数 网址 { // 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
    - 如果函数返回无存储,则禁用缓存。
浏览器会自动存储(缓存)某些文件类型,例如 .html、.js、.CSS、.json、.jpg、.PNG,因此它们不需要显式存储在 Web 缓存中。Web 缓存的典型候选对象包括大型文件和使用自定义定义File Format的文件。