使用预下载功能
简介
预下载功能的原理是提前通过网络下载资源并缓存到本地,下次使用时从本地缓存中读取文件,以此提高资源加载速度。
目前仅支持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 新增了预下载的代码提示,可以升级获得更好支持。