普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

tt.setUserCloudStorage

基础库 1.11.0 开始支持本方法,低版本需做兼容处理

对用户存储的数据进行写入操作, 允许同时写多组 KV 数据。

语法

tt.setUserCloudStorage(options);

参数说明

options 为 object 类型, 属性如下:

属性类型默认值必填说明
KVDataListArray<KVData>要修改的 KV 数据列表
successFunction接口调用成功回调函数
failFunction接口调用失败回调函数
completeFunction接口调用结束回调函数

回调函数的参数说明

参数为 object 类型, 属性说明如下:

属性类型说明
errMsgstring调用接口的状态信息

返回值

代码示例

开发者工具中预览

tt.setUserCloudStorage({
  KVDataList: [
    {
      key: "ranlList",
      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 字节。
点击纠错
评价此篇文档