微信用户的关系链数据组成
包括两部分:
该用户好友的用户数据
该用户所在的某个群的群成员的用户数据。
获取关系链数据的API:
wx.getFriendCloudStorage()获取当前用户也玩该小游戏的好友的用户数据
wx.getGroupCloudStorage() 获取当前用户在某个群中也玩该小游戏的成员的用户数据
API返回的结果为一个对象数组,数组的每一个元素都是一个表示用户数据的对象。
属性 | 类型 | 说明 |
---|---|---|
openId | string | 用户的openId |
avatarUrI | string | 用户的微信头像url |
nickName | string | 用户的微信昵称 |
data | Object | 用户的游戏数据 |
关系链数据的应用场景
例如 用户的段位、战绩、积分等排行榜,这些游戏业务特有的数据,都可以用到这个功能。
通过调用 wx.setUserCloudStorage() 可以将当前用户的游戏数据托管在微信后台。只有被托管过数据的用户,才会被视为 玩过
该小游戏的用户,才会出现在 wx.getFriendCloudStorage() 和 wx.getGroupCloudStorage()返回的对象数组中。
除此之外,我们还提供了以下 API:
- wx.removeUserCloudStorage() 删除用户托管数据中指定字段的数据
- wx.getUserCloudStorage() 获取当前用户的托管数据
wx.getUserCloudStorage、wx.getFriendCloudStorage() 和 wx.getGroupCloudStorage() 只能在 开放数据域
中调用。
wx.setUserCloudStorage() 和 wx.removeUserCloudStorage() 可以同时在 主域
和开放数据域中调用。
展示关系链数据
如果想要展示通过关系链 API 获取到的用户数据,如绘制排行榜等业务场景,需要将排行榜绘制到 sharedCanvas
上,再在主域将 sharedCanvas 渲染上屏。