QQ玩一玩好友排行榜与世界排行榜

QQ玩一玩好友排行榜与世界排行榜

1、开发环境

  • CocosCreator V2.0.5

  • 手Q版本 V7.9.0.3820(目前市场中最新版本)

  • qqPlayCore.js buildTime:'Fri Nov 09 2018 13:20:45 GMT+0800 (GMT+08:00)'上出现,此版本的qqPlayCore.js也是最新能正常使用的版本。

2、常见问题

  • 如何实现好友排行榜
  • 如何实现世界排行榜
  • 如何上报玩家成绩
  • 如何获取用户图像
  • 在CocosCreator中如何加载用户的图像

3、实现好友排行榜

QQ轻游戏平台提供成绩上报与排行榜接口,用于游戏内成绩的上报与排行。

开发者通过使用上报接口进行数据上报后,通过排行榜接口进行成绩的拉取与展示。

3.1 错误码列表

排行榜/云端存储错误码

3.2 支持两种特性
  • 支持多榜单同时上报

    scoreInfo中score字段为默认榜单,a1,a2,……,a16为开发者可使用的 榜单key字段,不允许使用其他key

    目前最多支持16个榜单scoreInfo中的key字段值类型必须是整型数

  • 支持多榜单排序方式

    对应data.attr中的字段

    1: 从大到小,即每次上报的分数都会与本周期的最高得分比较,如果大于最高得分则覆盖,否则忽略

    2: 从小到大,即每次上报的分数都会与本周期的最低得分比较,如果低于最低得分则覆盖,否则忽略

    比如酷跑类游戏的耗时,时间越短越好

    3: 累积,即每次上报的积分都会累积到本周期已上报过的积分上(本质上是从大到小的一种特例)

    4: 直接覆盖,每次上报的积分都会将本周期的得分覆盖,不管大小

3.3 成绩数据上报
/**
 * 成绩上报
 * @param {*} level 
 * @param {*} callback 
 */
function uploadScore(level, callback) {
    if (cc.sys.platform != cc.sys.QQ_PLAY) {
        if (callback) {
            callback(-1, "此接口只支持QQ玩一玩平台");
        }
        return;
    }

    var data = {
        userData: [{
            openId: GameStatusInfo.openId,
            startMs: Global.startGameTime,
            endMs: ((new Date()).getTime()).toString(),
            scoreInfo: {
                score: level,//分数,类型必须是整型数
                // 多榜单附加属性(选填),最多16个,且名称必须为a1 ~ a16,类型必须是整型数
                //a1: 100,
                //...
                //a16: 100
            },
        }, ],
        // type 描述附加属性的用途
        // order 排序的方式,
        // 1: 从大到小,即每次上报的分数都会与本周期的最高得分比较,如果大于最高得分则覆盖,否则忽略
        // 2: 从小到大,即每次上报的分数都会与本周期的最低得分比较,如果低于最低得分则覆盖,否则忽略
        // 3: 累积,即每次上报的积分都会累积到本周期已上报过的积分上(本质上是从大到小的一种特例)
        // 4: 直接覆盖,每次上报的积分都会将本周期的得分覆盖,不管大小
        // 如score字段对应,上个属性.
        attr: {
            score: {
                type: 'rank',
                order: 1,
            }
            //如果要支持多榜单在此添加 a1~a16
            //a1: {
            //    type: 'rank',
            //    order: 2,
        	//}
        },
    };
    // gameMode: 游戏模式 1:普通,2:挑战,如果没有模式区分,直接填1 
	// 必须配置好周期规则后,才能使用数据上报和排行榜功能
    BK.QQ.uploadScoreWithoutRoom(1, data, function (errCode, cmd, data) {
        log("uploadScoreWithoutRoom callback  cmd" + cmd + " errCode:" + errCode + "  data:" + JSON.stringify(data));
        if (callback) {
            callback(errCode, data);
        }
    });
}
3.4 何时上报玩家成绩

建议在以下两个时间点上报玩家成绩

  • 当局游戏结束时
  • 退出游戏时

当局游戏结束时需要开发者主动调用上报操作,退出游戏时上报需要监听QQ玩一玩生命周期来实现,参考示例如下。

 _gameCloseListener() {

        //上报操作
        let score = Utils.getRandomInt(0, 100);
        BKTools.log('关闭游戏:' + score);
        BKTools.uploadScore(score, function (errorCode) {
            if (errorCode == 0) {
                BKTools.log("数据上报成功......");
            } else {
                BKTools.log("数据上报失败......");
            }
        });
    },

QQ玩一玩生命周期监听具体实现逻辑参考之前写的博客 QQ玩一玩广告与音效使用总结

3.5 拉取排行榜数据

排行榜数据提供 昵称头像url积分 三种数据。此接口不提供openId与昵称、头像的对应关系

图像URL参考:http://thirdqq.qlogo.cn/g?b=sdk&k=OiaMLzXmbEwq5trqsR6zd1A&s=100&t=1483310911

如果要获取多榜单数据可以多次调用此接口,只是 attr、order 这两个参数需要根据实际排行榜需求设置不同的值,rankType 目前为固定值0(好友排行榜)

/**
 * 拉取排行榜数据
 * @param {*} callback 
 */
function getRankList(callback,attr,order) {
    if (cc.sys.platform != cc.sys.QQ_PLAY) {
        if (callback) {
            callback(-1, "此接口只支持QQ玩一玩平台");
        }
        return;
    }
    if(!attr){
       attr = "score";//使用哪一种上报数据做排行,可传入score,a1,a2等
    }
    if(!order){
       order = 1;//排序的方法:[ 1: 从大到小(单局),2: 从小到大(单局),3: 由大到小(累积)]
    }
    let rankType = 0;//要查询的排行榜类型,0: 好友排行榜 目前是固定值
    BK.QQ.getRankListWithoutRoom(attr, order, rankType, function (errCode, cmd, data) {
        log("getRankListWithoutRoom callback  cmd" + cmd + " errCode:" + errCode);
        if (errCode != 0) {
            callback(errCode);
            return;
        }
        if (data) {
            let rankList = data.data.ranking_list;
            log("data not null " + rankList.length);
            log(JSON.stringify(data));
            // rankList.forEach(element => {
            //   log("....华丽的分割线....");
            //   log("score:" + element.score);
            //   log("nick:" + element.nick);
            //   log("....华丽的分割线....");
            // });
            if (callback) {
                callback(errCode, rankList);
            }
        }
    });
}
3.6 拉取排行榜使用示例
BKTools.getRankList(function (errorCode, rankList) {
    if (errorCode == 0) {
        if (rankList && rankList.length > 0) {
            rankList.forEach(element => {
                BKTools.log("item:" + JSON.stringify(element));
            });
        } else {
            BKTools.log("....排行榜为空....");
        }
    } else {
        BKTools.log("....获取排行榜失败....");
    }
}.bind(this));
3.7 好友排行榜图像显示
Utils.loadImgByUrl(this.image, "http://thirdqq.qlogo.cn/g?b=sdk&k=OiaMLzXmbEwq5trqsR6zd1A&s=100&t=1483310911");

具体实现可以参考之前写的博客 QQ 玩一玩获取用户图像昵称以及CocosCreator动态加载网络图片

4、实现世界排行榜

实现世界排行榜就需要后台的支持了,简单的介绍一下实现逻辑

  • 玩家打开游戏时通过全局参数获取到openId
  • 通过openId获取用户的昵称
  • 将openId以及用户信息关联上报后台
  • 游戏结束时调用后台接口上报成绩
  • 获取世界排行榜就可以通过后台提供的接口来查询到所有玩家的openId、昵称等(全局参数能获取到的数据都能作为排行榜排序的依据)
  • 获取图像可以使用 BK.MQQ.Account.getHeadEx(openID,callback) 此接口会获取头像并写到本地目录

全局参考获取可以参考 QQ玩一玩广告与音效使用总结

获取用户图像并显示可以参考 QQ 玩一玩获取用户图像昵称以及CocosCreator动态加载网络图片

5、相关参考资料

CocosCreator开发小游戏示例:Brickengine_Guide

  • QQPlay为旧版本QQ玩一玩示例
  • QQPlay_New为新版本QQ玩一玩示例

官方文档 关系链与用户信息

官方文档 成绩上报与排行榜

官方文档 排行榜/云端存储错误码

到这里就介绍完了,个人能力有限如有错误欢迎指正,如有遗漏欢迎补充。如有疑问欢迎留言一起交流讨论。

展开阅读全文

150讲轻松搞定Python网络爬虫

05-16
【为什么学爬虫?】        1、爬虫入手容易,但是深入较难,如何写出高效率的爬虫,如何写出灵活性高可扩展的爬虫都是一项技术活。另外在爬虫过程中,经常容易遇到被反爬虫,比如字体反爬、IP识别、验证码等,如何层层攻克难点拿到想要的数据,这门课程,你都能学到!        2、如果是作为一个其他行业的开发者,比如app开发,web开发,学习爬虫能让你加强对技术的认知,能够开发出更加安全的软件和网站 【课程设计】 一个完整的爬虫程序,无论大小,总体来说可以分成三个步骤,分别是: 网络请求:模拟浏览器的行为从网上抓取数据。 数据解析:将请求下来的数据进行过滤,提取我们想要的数据。 数据存储:将提取到的数据存储到硬盘或者内存中。比如用mysql数据库或者redis等。 那么本课程也是按照这几个步骤循序渐进的进行讲解,带领学生完整的掌握每个步骤的技术。另外,因为爬虫的多样性,在爬取的过程中可能会发生被反爬、效率低下等。因此我们又增加了两个章节用来提高爬虫程序的灵活性,分别是: 爬虫进阶:包括IP代理,多线程爬虫,图形验证码识别、JS加密解密、动态网页爬虫、字体反爬识别等。 Scrapy和分布式爬虫:Scrapy框架、Scrapy-redis组件、分布式爬虫等。 通过爬虫进阶的知识点我们能应付大量的反爬网站,而Scrapy框架作为一个专业的爬虫框架,使用他可以快速提高我们编写爬虫程序的效率和速度。另外如果一台机器不能满足你的需求,我们可以用分布式爬虫让多台机器帮助你快速爬取数据。   从基础爬虫到商业化应用爬虫,本套课程满足您的所有需求! 【课程服务】 专属付费社群+每周三讨论会+1v1答疑
©️2020 CSDN 皮肤主题: 成长之路 设计师: Amelia_0503 返回首页
实付0元
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值