普通小游戏开发
开放能力(必读)
社交转发裂变
数据分析
视频拍摄器
API
多端支持

tt.loadSubpackage

基础库 1.88.0 开始支持本方法,低版本需做兼容处理

触发分包加载下载与加载(如果分包指定的是一个目录,则自动加载目录下的 game.js, 如果分包指定的是一个 js 文件,则自动加载该 js 文件),详见分包加载

语法

tt.loadSubpackage(options)

参数说明

object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
namestring分包的名字,可以填 game.json 中配置的 name 或者 root 值1.88.0
successFunction接口调用成功的回调函数1.88.0
failFunction接口调用失败的回调函数1.88.0
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)1.88.0

回调成功

object 类型,属性如下:

属性类型说明最低支持版本
errMsgstring"loadSubpackage: ok"1.88.0

回调失败

object 类型,属性如下:

属性类型说明最低支持版本
errMsgstring"loadSubpackage: fail" + 详细错误信息1.88.0

返回值

LoadSubpackageTask 加载分包任务实例,用于获取分包加载状态。

代码示例

const loadTask = tt.loadSubpackage({
  name: 'stage1',
  success: function(res) {
    console.log('success errMsg: ' + res.errMsg);
  },
  fail: function(res) {
    console.log('fail errMsg: ' + res.errMsg);
  }
});

loadTask.onProgressUpdate(res => {
  console.log('下载进度', res.progress);
  console.log('已经下载的数据长度', res.totalBytesWritten);
  console.log('预期需要下载的数据总长度', res.totalBytesExpectedToWrite);
});

Bug & Tip

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助