排行榜是每款游戏的必备功能,通过 LeanCloud 可以非常简单的实现排行榜,帮助您迅速提升用户活跃。
每一个排行榜由名称(statisticName)及所有玩家的成绩(statisticValue)组成,并可以设置排序、更新策略及重置周期。我们推荐您在控制台提前创建排行榜,客户端更新分数时,通过指定排行榜名称(statisticName)来更新分数。
statisticName 是排行榜唯一名称,不可修改,只能包含字母、数字、下划线,并且以字母或数字开头。
statisticValue 是用户在客户端产生的成绩,可以是整数,也可以带有小数点。
updateStrategy 代表成绩的更新策略,一个排行榜可以选择下列更新策略之一:
排行榜可以被重置,重置后线上所有数据清零。例如您可以每月开展赛季,赛季结束后所有数据清零,所有玩家重新开始比赛排名;也可以在发现当前比赛数据有失平衡时清零数据重新开始。从重置时间开始的一刻起,所有老数据被清理,客户端再发起的更新分数的请求将自动进入新版本的数据中。
versionChangeInterval 代表数据重置周期,共有以下选项:
请注意,国内版和国际版重置时间不同,对于需要在凌晨 00:00 重置的周期(day/week/month):
排行榜重置后,您可以通过 API 查询最新一个历史版本的数据,例如重置后当前版本为 3,那么版本为 2 的历史数据可以通过查询请求获取到,版本为 1 及 0 的数据查询会报错。
价格请参考官网。
C#
为了能及时解答大家的疑问,进一步了解游戏开发者的需求和使用场景,我们建立了游戏开发群,欢迎各位游戏开发者加入。详情 >>>
排行榜服务总览
排行榜是每款游戏的必备功能,通过 LeanCloud 可以非常简单的实现排行榜,帮助您迅速提升用户活跃。
功能简介
功能详解
每一个排行榜由名称(statisticName)及所有玩家的成绩(statisticValue)组成,并可以设置排序、更新策略及重置周期。我们推荐您在控制台提前创建排行榜,客户端更新分数时,通过指定排行榜名称(statisticName)来更新分数。
名称
statisticName 是排行榜唯一名称,不可修改,只能包含字母、数字、下划线,并且以字母或数字开头。
成绩
statisticValue 是用户在客户端产生的成绩,可以是整数,也可以带有小数点。
排序策略
更新策略
updateStrategy 代表成绩的更新策略,一个排行榜可以选择下列更新策略之一:
数据重置
重置时间及周期
排行榜可以被重置,重置后线上所有数据清零。例如您可以每月开展赛季,赛季结束后所有数据清零,所有玩家重新开始比赛排名;也可以在发现当前比赛数据有失平衡时清零数据重新开始。从重置时间开始的一刻起,所有老数据被清理,客户端再发起的更新分数的请求将自动进入新版本的数据中。
versionChangeInterval 代表数据重置周期,共有以下选项:
重置时间
请注意,国内版和国际版重置时间不同,对于需要在凌晨 00:00 重置的周期(day/week/month):
历史数据
查询
排行榜重置后,您可以通过 API 查询最新一个历史版本的数据,例如重置后当前版本为 3,那么版本为 2 的历史数据可以通过查询请求获取到,版本为 1 及 0 的数据查询会报错。
归档
价格
价格请参考官网。
开始使用
JavaScript
C#
在线交流
为了能及时解答大家的疑问,进一步了解游戏开发者的需求和使用场景,我们建立了游戏开发群,欢迎各位游戏开发者加入。详情 >>>