抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

使用预下载功能

收藏
我的收藏

简介

通过启动加载时序我们知道,在小游戏加载过程中“加载性能”的阶段,存在网络空闲的情况,我们可以在此阶段提前下载游戏内资源。
预下载功能的原理是提前通过网络下载资源并缓存到本地,下次使用时从本地缓存中读取文件,以此提高资源加载速度。
目前仅支持Unity小游戏,需在抖音33.6.0及以上版本验证

配置方式

主要配置入口在预加载选项中。(TTSDK版本>=6.3.1)
    文件列表:使用;间隔,支持模糊匹配(资源文件名中包含文件列表中字符串,即可将资源文件匹配进资源列表中),在构建时会将文件列表生成到 game.js 的 managerConfig 配置中
    游戏资源CDN: 部署资源的CDN前缀,构建时会生成到 game.js 的 managerConfig 配置中,在运行时,会拼接游戏资源CDN与文件列表中的文件路径进行预下载。拼接规则:{DATA_CDN}/StreamingAssets/{FilePath}
在Unity转换导出插件填写文件列表,生成时工具会自动从webgl/StreamingAssets目录找资源并填充到game.js。 运行时将根据列表内容在网络空闲期下载。
若在构建面板有配置内容,且匹配到了资源,那么会在game.js 中存在以下类似配置的内容:
const managerConfig = { DATA_CDN: '', preloadDataList: [ // 'DATA_CDN/StreamingAssets/WebGL/textures_005b9e6b32e22099edc38cba5b3d11de', // '/WebGL/bundles_e1af572c458eda6944e73db25cae88d5' ], }; GameGlobal.managerConfig = managerConfig;

预下载时机

Unity小游戏会在 wasm 代码编译以及 callmain 时进行预下载

如何验证

Unity小游戏

可以通过测试版本的vconsole日志观察:接入预下载后,日志中会包含JSFW_PreloadManager:相关的日志描述,其中会包含请求成功或者失败等字样,开发者可根据日志进行调试。
Unity小游戏还可以在抖音开发者工具中进行验证,需抖音开发者工具版本>=4.3.8, 可在模拟器预览时,观察日志描述。获取接入情况。

注意事项

抖音开发者工具4.3.6版本在 game.json 新增了预下载的代码提示,可以升级获得更好支持。