# 数据预拉取

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

# 使用流程

# 1. 配置数据下载地址

1. 登录小游戏 MP 管理后台，进入开发管理 -> 开发设置 -> 数据预加载，点击开启
2. 个人主体小游戏仅支持配置云开发环境
3. 非个人主体小游戏支持配置HTTPS数据下载地址、 云开发环境

# 2. 设置 TOKEN

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

示例：

App({
  onLaunch() {
    wx.setBackgroundFetchToken({
      token: 'xxx'
    })
  }
})

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

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

query 参数会使用 urlencode 处理

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

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

# 4. 读取数据

用户启动小游戏时，调用 wx.getBackgroundFetchData 和 wx.onBackgroundFetchData 获取已缓存到本地的数据。

示例：

App({
  onLaunch() {
    wx.onBackgroundFetchData(() => {
      console.log(res.fetchedData) // 缓存数据
      console.log(res.timeStamp) // 客户端拿到缓存数据的时间戳
    })
    wx.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) // 场景值
      }
    })
  }
})

# 调试方法

为了方便调试数据预拉取，工具提供了下面的调试能力给到开发者，具体可查看预拉取数据调试。