Skip to main content

排行榜快速入门 · C#

本文档展示了如何快速接入排行榜功能。

创建排行榜​

首先通过控制台创建一个世界排行榜：

  • 排行榜名称 statisticName 设置为 world。
  • 玩家成绩降序排列。
  • 更新策略选择 better，即保留用户最好的成绩。
  • 每月自动重置。

image

点击完成后，我们在控制台看到一个已经创建好的排行榜。

SDK 安装​

请参考 C# SDK 安装指南，获取 SDK 的数据存储模块，完成安装、初始化。

更新成绩​

这里在客户端模拟注册两个玩家 A 和 B 并更新自己的成绩。首先运行以下代码注册玩家 A 并更新排行榜中的成绩：

var user = new AVUser();
user.Username = "playerA";
user.Password = "passwordA";
await user.SignUp();
var statistic = new Dictionary<string, double> {
 { "world", 20 }
};
await LCLeaderboard.UpdateStatistics(user, statistic);

接下来换玩家 B 登录并更新成绩，将以上代码中 AVUser.SignUp 的参数换成玩家 B 的用户名 playerB 和密码 passwordB 后再次运行代码，运行成功后排行榜中也就有了玩家 B 的成绩。

获取名次​

接下来我们获取排行榜中前 10 的名次，由于当前排行榜中只有 2 个玩家，所以结果是这两个玩家的数据。

var leaderboard = LCLeaderboard.CreateWithoutData("world");
var rankings = await leaderboard.GetResults(limit: 10, selectUserKeys: new List<string> {"username", "age"});
foreach(var ranking in rankings) {
    Debug.Log(ranking.User.Username);
    Debug.Log(ranking.Rank.ToString());
    Debug.Log(ranking.Value);
}

使用指南​

更详细的使用方式，请参考C# 排行榜开发指南。