# 数据预拉取

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

# 使用流程

# 1. 配置数据下载地址

数据来源为开发者服务器时支持配置灰度比例，灰度数据下载地址可以区别于数据下载地址，灰度比例不可回退，且 100% 灰度视为更新数据地址为灰度数据地址, 如需进行测试，可将灰度比例改为百分之 0，即只对开发者体验者进行灰度。

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

# 2. 设置 TOKEN

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

示例：

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

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

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

参数	类型	必填	说明
appid	String	是	小游戏标识。
token	String	否	前面设置的 TOKEN。
code	String	否	用户登录凭证，未设置TOKEN时由微信侧预生成，可在开发者后台调用 auth.code2Session，换取 openid 等信息。注意：云开发模式时，不提供 code，但会提供 userinfo ，包含 openid 信息，请以实际为准。
timestamp	Number	是	时间戳，微信客户端发起请求的时间
path	String	否	打开小游戏的路径。
query	String	否	打开小游戏的query。
scene	Number	否	打开小游戏的场景值。

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

# 调试方法

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