qg.setUserCloudStorage (Object object)

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

代码示例

qg.setUserCloudStorage({
  KVDataList: [
    {
      user: "value",
      result: {
        gameResult: {
          score: 60
        },
        totalScore: 120
      }
    }
  ],
  success: res => {
    console.log("调用成功");
  },
  fail: res => {
    console.log("调用失败");
  },
  complete: res => {
    console.log("调用完成");
  }
});

qg.getUserCloudStorage (Object object)

获取当前用户托管数据当中对应 key 的数据。

keyList

代码示例

qg.getUserCloudStorage({
  keyList: ["user", "result"], // 要获取的 key 列表
  success: res => {
    console.log("调用成功");
    console.log(res.KVDataList);
  },
  fail: res => {
    console.log("调用失败");
  },
  complete: res => {
    console.log("调用完成");
  }
});

qg.getUserCloudStorageKeys(Object object)

获取当前用户托管数据当中所有的 key。该接口需要用户授权，且只在开放数据域下可用。

object.success(Object res) 回调函数

qg.removeUserCloudStorage (Object object)

删除当前游戏的用户托管数据当中对应 key 的数据。

代码示例

qg.removeUserCloudStorage({
  keyList: ["user", "result"], // 要删除的 key 列表,
  success: res => {
    console.log("调用成功");
  },
  fail: res => {
    console.log("调用失败");
  },
  complete: res => {
    console.log("调用完成");
  }
});

错误码

QA

1、是否所有游戏都需要接？

我们要求所有涉及到将游戏进度数据存储在本地的游戏，接入该 API，实现游戏进度的云端存储，避免在用户清除手机缓存或者换手机登录时出现游戏进度丢失的情况。由于每个游戏每个用户最大存储上限为 1M，所以请存储必要的数据。请不要将该接口当成数据备份使用，需要确保本地和云端的数据始终保持一致，在本地数据丢失的情况下，使用云端数据恢复。

2、是否必须登录状态下才能调用？

是的，存储数据时需要用户的登录状态，来区分不同的用户身份。接入登录很方便，可以参考各厂商的登录服务