抖音开放平台Logo
开发者文档
控制台

tt.setUserCloudStorage
收藏
我的收藏

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

语法​

tt.setUserCloudStorage(options);

参数说明​

options 为 object 类型, 属性如下:​
属性​
类型​
默认值​
必填​
说明​
KVDataList​
Array<KVData>​
是​
要修改的 KV 数据列表​
success​
Function​
否​
接口调用成功回调函数​
fail​
Function​
否​
接口调用失败回调函数​
complete​
Function​
否​
接口调用结束回调函数​

回调函数的参数说明​

参数为 object 类型, 属性说明如下:​
属性​
类型​
说明​
errMsg​
string​
调用接口的状态信息​

返回值​

代码示例​

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 字节。​