抖音开放平台Logo
控制台

tt.setUserCloudStorage
收藏
我的收藏

基础库 1.11.0 开始支持本方法,低版本需做兼容处理。​
对用户存储的数据进行写入操作, 允许同时写多组 KV 数据。​

语法​

js
复制
tt.setUserCloudStorage(options);

参数说明​

options 为 object 类型, 属性如下:​
属性​
类型​
默认值​
必填​
说明​
KVDataList​
Array<KVData>​
是​
要修改的 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 字节。​