qq.setUserCloudStorage

qq.setUserCloudStorage(Object object)

对用户托管数据进行写数据操作。允许同时写多组 KV 数据。

参数

Object object

托管数据的限制

• 每个openid所标识的QQ用户在每个游戏上托管的数据不能超过128个key-value对。
• 上报的key-value列表当中每一项的key+value长度都不能超过1K(1024)字节。
• 上报的key-value列表当中每一个key长度都不能超过128字节。

qq.removeUserCloudStorage

qq.removeUserCloudStorage(Object object)

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

参数

Object object

qq.getUserCloudStorage

qq.getUserCloudStorage(Object object)

获取当前用户托管数据当中对应 key 的数据。该接口只可在开放数据域下使用

参数

Object object

object.success 回调函数

参数

Object res

qq.getSharedCanvas

Canvas qq.getSharedCanvas()

获取主域和开放数据域共享的 sharedCanvas。只有开放数据域能调用。

返回值

Canvas

qq.getGroupCloudStorage

qq.getGroupCloudStorage(Object object)

获取群同玩成员的游戏数据。小游戏通过群分享卡片打开的情况下才可以调用。该接口只可在开放数据域下使用。

参数

Object object

object.success 回调函数

参数

Object res

qq.getFriendCloudStorage

qq.getFriendCloudStorage(Object object)

拉取当前用户所有同玩好友的托管数据。该接口只可在开放数据域下使用

参数

Object object

object.success 回调函数

参数

Object res

UserGameData

托管数据

属性

string avatarUrl

用户的QQ头像 url

string nickname

用户的QQ昵称

string openid

用户的 openid

Array.<KVData> KVDataList

用户的托管 KV 数据列表

KVData

托管的 KV 数据

属性

string key

数据的 key

string value

数据的 value

举例

比如某小游戏有一个分数排行榜，分数排行榜需要记录分数以及获得分数的耗时（游戏内的排行榜需要展示耗时），可以在qqgame同级别定义一个cost_ms字段，存储耗时的毫秒数。分配一个不和已定义的托管数据的key相冲突的key作为分数排行榜的key，如 "score"。

在玩家耗时36500ms后，获得本周最高分16分，则需要更新分数，假设当前时间戳为1513080573， 则完整 value在序列化之前的内容如下：

{
  "qqgame": {
    "score": 16,
    "update_time": 1513080573
  },
  "cost_ms": 36500
}

最终序列化为string后，value为"{"qqgame":{"score":16,"update_time": 1513080573},"cost_ms":36500}"。

OpenDataContext-qq.getUserInfo

qq.getUserInfo(Object object)

在无须用户授权的情况下，批量获取用户信息。该接口只在开放数据域下可用

参数

Object object

object.lang 的合法值

object.success 回调函数

参数

Object res

res.data 的结构

示例代码

获取当前用户和其他几个用户的用户信息

qq.getUserInfo({
  openIdList: ['selfOpenId', 'ownAP0b9qt6AzvYOSWOX8VX8KMq0', 'ownAP0QJHIN2w3X60EUsj2Vah5Ig', 'ownAP0f8ANWUCcloXN1oZPfxtz0g'],
  lang: 'zh_CN',
  success: (res) => {
    console.log('success', res.data)
  },
  fail: (res) => {
    reject(res)
  }
})