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

78 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters!

This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.

要做这个好友排行榜.必然要有好友的战绩比分,然后再做排序,最后将数据呈现在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)