gamecircle.Leaderboard.GetScoresReturn

Overview

Table that encapulates the error values and return values from the [GetScores][plugin.gamecircle.Leaderboard.GetScores] function.

Properties

• isError - Boolean
  If the GameCircle SDK encountered an error, this value will be true.
• errorMessage - String
  If the GameCircle SDK encountered an error, this string will be populated with an error message.
• leaderboard - Leaderboard The Leaderboard from the GetScores request.
• num - Number_
  The number of leaderboards scores with the request.
• [] Square Bracket Accessor - Score
  The returned scores are stored as numerically-indexed entires on the table, ranging in value from 1 to “num”. They can also be access using an ipairs interation, as in the example below.

Example

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("-Leaderboard ID" .. returnValue.id)  
        print("-name" .. returnValue.name)  
        print("-displayText" .. returnValue.displayText)  
        print("-num" .. returnValue.num)  
        print("-scoreFormat" .. returnValue.scoreFormat)  
        print("-scores:")  
        for i, score in ipairs(returnValue) do  
            print("--Rank " .. score.rank)  
            print("---" .. score.scoreString .. " by " .. score.player.alias)  
        end  
    end  
end  
gamecircle.Leaderboard.GetScores(leaderboardId, "GLOBAL_WEEK", LeaderboardCallback)