游戏创意与功能

你的下一项功能

排行榜

每局结束后保存分数并展示领先者。

需要玩家会话
Unity
排行榜功能示意图
可见的结果

测试分数在一局结束后出现在排行榜中。

查看排行榜排名3:54

此教程以英语播放。

单独打开视频 ↗

准备同一个项目

  1. 在仪表盘中选择与游戏配置相同的项目。

    排行榜 →
  2. 在控制台表单中创建或复用这些测试条目。这些是示例值,并非项目当前数据。

    Key(slug)
    weekly
    排序方式
    DESC
    只接受已验证游戏局的分数
    false
  3. 运行示例前先保存、重新加载并核对条目。保留其他定义。

实现此功能

你可以预览指南。运行需要有效的项目密钥。 准备项目

已安装 SDK、导入项目配置,且玩家已登录。

保存C#文件并挂到GameObject,进入Play后检查Console。

C#
Assets/Scripts/LeaderboardDemo.cs
horizOn 调用准备
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}
打开完整SDK示例 ↗

测试你的新功能。

测试分数在一局结束后出现在排行榜中。

在仪表盘中选择与游戏配置相同的项目。

接口
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
API 参考中的全部接口