阅读(1522) (13)

QQ小程序 数据预拉取

2020-07-02 15:25:26 更新

基础库 1.14.0 版本开始支持。

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

使用流程

1. 配置数据下载地址

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

2. 设置 TOKEN

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

示例:

App({
  onLaunch() {
    qq.setBackgroundFetchToken({
      token: "xxx"
    });
  }
});

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); // 场景值
      }
    });
  }
});

5. 调试方法

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