文档

# 数据预拉取

基础库 1.14.0 版本开始支持。

预拉取能够在小程序冷启动的时候通过 QQ 后台提前向第三方服务器拉取业务数据，当代码包加载完时可以更快地渲染页面，减少用户等待时间，从而提升小程序的打开速度。

# 使用流程

# 1. 配置数据下载地址

登录小程序管理后台，进入设置 -> 开发设置 -> 数据预拉取，点击启用，填写数据下载地址，只支持 HTTPS。

数据预拉取

# 2. 设置 TOKEN

第一次启动小程序时，调用 qq.setBackgroundFetchToken() 设置一个 TOKEN 字符串，可以跟用户态相关，会在后续 QQ 客户端向开发者服务器请求时带上，便于给后者校验请求合法性。

示例：

App({
  onLaunch() {
    qq.setBackgroundFetchToken({
      token: "xxx"
    });
  }
});
1
2
3
4
5
6
7

# 3. QQ 客户端提前拉取数据

当用户打开小程序时，QQ 服务器将向开发者服务器（上面配置的数据下载地址）发起一个 HTTP GET 请求，其中包含的 query 参数如下，数据获取到后会将整个 HTTP body 缓存到本地。

属性 类型 必填 说明
appid String 是 小程序标识
token String 否 前面设置的 TOKEN
code String 否 用户登录凭证，未设置 TOKEN 时由 QQ 侧预生成，可在开发者后台调用 auth.code2Session，换取 openid 等信息
timestamp Number 是 时间戳，QQ 客户端发起请求的时间
path String 否 打开小程序的路径
query String 否 打开小程序的 query
scene Number 否 打开小程序的场景值

query 参数会使用 urlencode 处理

token 和 code 只会存在一个，用于标识用户身份

开发者服务器接口返回的数据类型应为字符串，且大小应不超过 256KB，否则将无法缓存数据

# 4. 读取数据

用户启动小程序时，调用 qq.getBackgroundFetchData() 获取已缓存到本地的数据。

示例：

App({
  onLaunch() {
    qq.getBackgroundFetchData({
      fetchType: "pre",
      success(res) {
        console.log(res.fetchedData); // 缓存数据
        console.log(res.timeStamp); // 客户端拿到缓存数据的时间戳
        console.log(res.path); // 页面路径
        console.log(res.query); // query 参数
        console.log(res.scene); // 场景值
      }
    });
  }
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 5. 调试方法

暂不支持,开发者工具后续版本将进行更新

← CDN 资源预加载 →