bl.setUserCloudStorage(Object object)
对用户托管数据进行写数据操作。允许同时写多组 KV 数据。
调用该 API 前需要当前小游戏已经成功调用过bl.login(建议在 onLaunch 生命周期内调用bl.login)
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| KVDataList | Array.<KVData> | 是 | 要修改的 KV 数据列表 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
托管数据的限制
- 每个 openid 所标识的用户在每个游戏上托管的数据不能超过 128 个 key-value 对。
- 上报的 key-value 列表当中每一项的 key+value 长度都不能超过 1K(1024)字节。
- 上报的 key-value 列表当中每一个 key 长度都不能超过 128 字节。
- 与微信不同的是,b 站小游戏的 KVData 除了
key、value属性外,还需要一个order属性,用于bl.getAllCloudStorage时的排序,order值越大,排名越靠前