const managerConfig = {
    DATA_CDN: '',
    preloadDataList: [
        // 'DATA_CDN/StreamingAssets/WebGL/textures_005b9e6b32e22099edc38cba5b3d11de',
        // '/WebGL/bundles_e1af572c458eda6944e73db25cae88d5'
        
    ],
 };
GameGlobal.managerConfig = managerConfig;

手动配置

可以直接修改打包产物中 game.js 文件进行修改。格式如上。

运行时配置

引擎初始化完成后

通过C#接口 TT.SetPreloadList 修改

private IEnumerator GetPreloadList()
{
    using (UnityWebRequest www = UnityWebRequest.Get("https://api.example.com/preloadlist"))
    {
        yield return www.SendWebRequest();
        if (www.result != UnityWebRequest.Result.Success)
        {
            Debug.Log(www.error);
        }
        else
        {
            string json = www.downloadHandler.text;
            PreloadListData preloadListData = JsonUtility.FromJson<PreloadListData>(json);

            // 获取URL列表
            TT.SetPreloadList(preloadListData.list);
        }
    }
}

[System.Serializable]
public class PreloadListData
{
    public List<string> list;
}

预下载时机

Unity小游戏会在引擎初始化完成前（对应wasm 代码编译以及 callmain 阶段）开始进行预下载。

并发数

在引擎初始化完成前，默认并发 10 个预下载。已发起但未完成的下载任务，以及列表中尚未发起的任务，会在引擎初始化完成后继续进行，但并发数改为 1 个。可通过 Csharp 接口TT.PreloadConcurrent 修改引擎初始化后的预下载并发数。

•

默认值：引擎初始化完成前 10 个；引擎初始化完成后 1 个

•

最大值：10 个

如何验证

Unity小游戏

可以通过测试版本的vconsole日志观察：接入预下载后，日志中会包含JSFW_PreloadManager：相关的日志描述，其中会包含请求成功或者失败等字样，开发者可根据日志进行调试。

Unity小游戏还可以在抖音开发者工具中进行验证，需抖音开发者工具版本>=4.3.8, 可在模拟器预览时，观察日志描述。获取接入情况。

注意事项

预下载最大数量为30个。超出会取前30个作为预下载列表

添加到预下载列表中的文件，在预下载完成后会保留60s，随后删除引用。如果您没有持有数据的引用，会被回收导致下载浪费。

会按照列表顺序发起预下载，请将优先需要的资源放到列表前面。

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