你的下一项功能
排行榜
每局结束后保存分数并展示领先者。
Unity

可见的结果
测试分数在一局结束后出现在排行榜中。
查看排行榜排名3:54
此教程以英语播放。
单独打开视频 ↗准备同一个项目
在仪表盘中选择与游戏配置相同的项目。
排行榜 →在控制台表单中创建或复用这些测试条目。这些是示例值,并非项目当前数据。
- Key(slug)
weekly- 排序方式
DESC- 只接受已验证游戏局的分数
false
运行示例前先保存、重新加载并核对条目。保留其他定义。
实现此功能
你可以预览指南。运行需要有效的项目密钥。 准备项目
已安装 SDK、导入项目配置,且玩家已登录。
保存C#文件并挂到GameObject,进入Play后检查Console。
C#
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4
5// 将此脚本挂到第一个场景中的某个 GameObject 上。
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // 准备:初始化、连接并登录玩家。
11 HorizonApp.Initialize();
12 await new HorizonServer().Connect();
13 if (!UserManager.Instance.IsSignedIn)
14 {
15 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
16 ? await UserManager.Instance.RestoreAnonymousSession()
17 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
18 if (!authenticated) return;
19 }
20
21 // horizOn:提交分数,读取排行榜和自己的排名。
22 var boards = LeaderboardManager.Instance;
23 bool submitted = await boards.SubmitScore(12500, boardKey: "weekly");
24 if (!submitted) { Debug.LogWarning(boards.LastErrorCode); return; }
25 var top = await boards.GetTop(10, useCache: false, boardKey: "weekly");
26 if (top == null) return;
27 foreach (var entry in top) Debug.Log($"#{entry.position} {entry.username}: {entry.score}");
28 var rank = await boards.GetRank(boardKey: "weekly");
29 if (rank != null) Debug.Log($"Your rank: {rank.position}");
30 }
31}
测试你的新功能。
测试分数在一局结束后出现在排行榜中。
在仪表盘中选择与游戏配置相同的项目。
接口
- POST
/leaderboard/submit - GET
/leaderboards/{boardKey}/top - GET
/leaderboards/{boardKey}/rank - GET
/leaderboards/{boardKey}/around

