leaderboards.loadScores()

类型 函数
返回值
修订版 发行版 2024.3703
关键字 Google Play 游戏服务、游戏网络、gpgs、排行榜、loadScores
另请参阅 gpgs.leaderboards
gpgs.*

概述

从已指定排行榜中获取得分。

语法

gpgs.leaderboards.loadScores( params )
params (必填)

表格. 包含调用的参数 — 详情见下一部分。

参数参考

params 表格包含调用的参数。

leaderboardId (必填)

字符串. 要从中加载得分的排行榜 ID。

位置 (可选)

字符串. 以下值之一

  • "top" — 最高得分(默认)。
  • "single" — 当前玩家的得分。
  • "centered" — 当前玩家得分附近的得分。
friendsOnly (可选)

布尔值. 如果为 true,只加载当前玩家好友的得分。

限制 (可选)

数字. 要加载的得分数量。最大值和默认值为 25

时间跨度 (可选)

字符串. 以下值之一

  • "all time" — 所有得分(默认)。
  • "weekly" — 本周得分。
  • "daily" — 今日得分。
重新加载 (可选)

布尔值. 如果为 true,将刷新数据,而不是从缓存中获取。

侦听器 (可选)

侦听器. 接收到 loadScores 事件的侦听器函数。