egret-docs-master/extension/matchvs/wxgame/wxrank/README.md

78 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2024-06-19 13:32:32 +08:00
要做这个好友排行榜.必然要有好友的战绩比分,然后再做排序,最后将数据呈现在UI上 , 可以分为下面几个步骤:
1.保存每个用户的分数
2.获取好友列表,并获取好友的分数
3.渲染排行榜
![friendlist](http://imgs.matchvs.com/static/res/rank.jpg)
## 保存每个用户的分数
保存每个用户的分数,需要调用微信的云存储API,将用户的分数持久化的存起来 .
```
// 保存用户数据,注意限制单条数据容量不得超过1024字节,
// 单个用户数据总条数不得超过128条
wx.setUserCloudStroage(Object)
```
![save](http://imgs.matchvs.com/static/res/save.png)
```javascript
//存储最高分
var score = 100;
var kvScore = {"key":"score","value":score};
wx.setUserCloudStroage({"KVDataList":[kvScore]},"success":function(){
//
});
```
## 获取好友列表,并获取好友的分数
游戏中将玩家的分数保存起来以后,需要调用微信的云存储API `wx.getFirendCloudStorage`, 获取玩家的微信好友数据,这样就拿到了每个好友的最高分.
值得一提的是,微信的这个接口在内部隐蔽的使用其微信的社交关系链 .
返回列表中的包含的 调用过`wx.setUserCloudStroage` 这个接口的用户.
![friendlist](http://imgs.matchvs.com/static/res/friendlist.png)
## 渲染排行榜
对分数进行排序 , 得到一个排行榜
```JavaScript
let sharedCanvas = wx.getSharedCanvas()
function drawRankList (data) {
data.forEach((item, index) => {
// ...
})
}
wx.getFriendCloudStorage({
success: res => {
let data = res.data
drawRankList(data)
}
})
```
注意这个 `sharedCanvas` , 这是独有的画布 ,与小游戏中的画布不是同一个东东.
![draw](http://imgs.matchvs.com/static/res/draw.png)
使用sharedCanvas来自定义显示玩家的用户排行榜
## 重要说明
上述所涉及的微信接口 , 都只能在微信小游戏的 `子域` 使用 , 微信官网也称之为`开放数据域` , 其实应该称之为 `封闭数据域` .
为什么这么说呢?
因为子域的js代码执行环境和小游戏本身的代码执行环境是隔离的. 两者之间不能相通 , 子域只能接收外部的消息(如游戏的最高分),不能往外发消息(不能把用户的好友关系链数据发给开发者服务器) , 内存不共享,也就意味着,开发者拿不到微信的社交关系链数据 . 在这样的封闭条件下,开发者能做的只能是在子域的画布上将排行榜数据以个性化的UI元素展示出来 .
## 参考资料
[Cocos Creator 实现微信好友排行榜](http://docs.cocos.com/creator/manual/zh/publish/publish-wechatgame-sub-domain.html)
[微信小游戏关系链数据使用指南](https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/open-data.html)