- API 概览
- 开放能力
- 基础
- 渲染
- 设备
- 文件
- 位置
- 媒体
- 网络
- 游戏转发分享
- 实时语音
- 数据缓存
- 系统
- 广告
- 界面
- 支付
- Worker
tt.setUserCloudStorage收藏我的收藏
收藏
我的收藏对用户存储的数据进行写入操作, 允许同时写多组 KV 数据。
语法
js复制tt.setUserCloudStorage(options);
参数说明
options 为 object 类型, 属性如下:
属性 | 类型 | 默认值 | 必填 | 说明 |
KVDataList | | 是 | 要修改的 KV 数据列表 | |
success | Function | | 否 | 接口调用成功回调函数 |
fail | Function | | 否 | 接口调用失败回调函数 |
complete | Function | | 否 | 接口调用结束回调函数 |
回调函数的参数说明
参数为 object 类型, 属性说明如下:
属性 | 类型 | 说明 |
errMsg | string | 调用接口的状态信息 |
返回值
无
代码示例
js复制tt.setUserCloudStorage({
KVDataList: [
{
key: "xxx",
value: JSON.stringify({
ttgame: {
score: 100,
update_time: 1557813466,
},
progress: 10,
}),
},
],
success: (res) => {
console.log("调用成功");
console.log(res.errMsg);
},
fail: (res) => {
console.log("调用失败");
},
complete: (res) => {
console.log("调用完成");
},
});
Bug & Tips
- •Tip: 上报的 value 值必须是 string,开发者可以针对 value 使用 JSON.stringify 进行处理。
- •Tip:每个 openid 所标识的用户在每个游戏上托管的数据不能超过 128 个 key-value 对。
- •Tip:上报的 key-value 列表当中每一项的 key+value 长度都不能超过 1K(1024)字节。
- •Tip:上报的 key-value 列表当中每一个 key 长度都不能超过 128 字节。
点击纠错