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
值越大,排名越靠前