gamecircle.Leaderboard.GetLocalPlayerScore

类型 函数
库 gamecircle.*
返回值 无
版本 版本 2024.3703
关键字 排行榜、分数、获取

概览

使用此函数在给定的排行榜中获取本地玩家得分和排名，并筛选常量。

语法

gamecircle.Leaderboard.GetLocalPlayerScore( id, LF_constant, callback )
id (必需)

字符串. 排行榜的 GameCircle ID。

LF_constant (必需)

字符串. 这是排行榜筛选常量，用于关联到 GameCircle SDK 的内部枚举器。它有四个有效值：“GLOBAL_ALL_TIME”、“GLOBAL_WEEK”、“GLOBAL_DAY”和“FRIENDS_ALL_TIME”。如果将不匹配这四个字符串中的任何一个的字符串放入此参数，则该函数将默认使用“GLOBAL_ALL_TIME”。

callback (必需)

函数. 在获取成就信息时使用的回调函数。回调函数将接收一个参数类型为 LocalPlayerScoreReturn

示例

local leaderboardId = "myFirstLeaderboard"  
local gamecircle = require("plugin.gamecircle")  
gamecircle.Init(false, true, false)  
function LeaderboardCallback(returnValue)  
    if returnValue.isError == true then  
        print("Get Scores request returned with error message: " .. returnValue.errorMessage)  
    else  
        print("Score information recieved for Leaderboard!")  
        print("The local player is rank " .. returnValue.rank .. " with a score of " .. returnValue.score .. ".")  
    end  
end  
gamecircle.Leaderboard.GetLocalPlayerScore(leaderboardId, "GLOBAL_WEEK", LeaderboardCallback)