游戏创意与功能

你的下一项功能

排行榜

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

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

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

查看排行榜排名3:54

此教程以英语播放。

单独打开视频 ↗

准备同一个项目

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

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

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

实现此功能

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

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

保存GDScript并挂到主场景节点,运行后检查Output。

GDScript
res://scripts/leaderboard.gd
horizOn 调用准备
1# 将此脚本挂到主场景中的某个节点上。
2extends Node
3​
4​
5func _ready() -> void:
6 # 准备:初始化、连接并登录玩家。
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn:提交分数,读取排行榜和自己的排名。
21 var submitted: bool = await Horizon.leaderboard.submitScore(12500, "weekly")
22 if not submitted:
23 push_warning(Horizon.leaderboard.getLastErrorCode())
24 return
25 var top = await Horizon.leaderboard.getTop(10, false, "weekly")
26 for entry in top:
27 print("#%d %s: %d" % [entry.position, entry.username, entry.score])
28 var rank = await Horizon.leaderboard.getRank("weekly")
29 if rank != null:
30 print("Your rank: ", rank.position)
打开完整SDK示例 ↗

测试你的新功能。

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

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

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