GetPlayerScores

Retrieves up to maxResults scores data for user for arcade-style leaderboard.

Service	Operation
leaderboard	GET_PLAYER_SCORES

Method Parameters

Parameter	Description
leaderboardId	The leaderboard to retrieve the score from.
versionId	The version of the leaderboard. Use -1 to specify the currently active leaderboard version.
maxResults	The maximum number of player scores to retrieve.

Usage

http://localhost:3000

C#

string leaderboardId = "anArcadeLeaderboardId";
int versionId = -1;
int maxResults = 10;
SuccessCallback successCallback = (response, cbObject) =>
{
    Debug.Log(string.Format("Success | {0}", response));
};
FailureCallback failureCallback = (status, code, error, cbObject) =>
{
    Debug.Log(string.Format("Failed | {0}  {1}  {2}", status, code, error));
};

_bc.LeaderboardService.GetPlayerScores(leaderboardId, versionId, maxResults, successCallback, failureCallback);

C++

const char *leaderboardId = "anArcadeLeaderboardId";
int versionId = -1;
int maxResults = 10;
_bc->getLeaderboardService()->getPlayerScores(leaderboardId, versionId, maxResults, this);

Objective-C

NSString *leaderboardId = @"anArcadeLeaderboardId";
int versionId = -1;
int maxResults = 10;
BCCompletionBlock successBlock;      // define callback
BCErrorCompletionBlock failureBlock; // define callback

[[_bc leaderboardService] getPlayerScores:leaderboardId
                  versionId:versionId
                 maxResults:maxResults
            completionBlock:successBlock
       errorCompletionBlock:failureBlock
                   cbObject:nil];

Java

String leaderboardId = "anArcadeLeaderboardId";
int versionId = -1;
int maxResults = 10;
this; // implements IServerCallback

_bc.getLeaderboardService().getPlayerScores(leaderboardId, versionId, maxResults, this);

public void serverCallback(ServiceName serviceName, ServiceOperation serviceOperation, JSONObject jsonData)
{
    System.out.print(String.format("Success | %s", jsonData.toString()));
}
public void serverError(ServiceName serviceName, ServiceOperation serviceOperation, int statusCode, int reasonCode, String jsonError)
{
    System.out.print(String.format("Failed | %d %d %s", statusCode,  reasonCode, jsonError.toString()));
}

JavaScript

var leaderboardId = "anArcadeLeaderboardId";
var versionId = -1;
var maxResults = 10;
_bc.leaderboard.getPlayerScores(leaderboardId, versionId, maxResults, result =>
{
    var status = result.status;
    console.log(status + " : " + JSON.stringify(result, null, 2));
});

Dart

var  leaderboardId = "anArcadeLeaderboardId";
var  versionId = -1;
var  maxResults = 10;

ServerResponse result = await _bc.leaderboardService.getPlayerScores(leaderboardId:leaderboardId, versionId:versionId, maxResults:maxResults);

if (result.statusCode == 200) {
    print("Success");
} else {
    print("Failed ${result.error['status_message'] ?? result.error}");
}

Cloud Code

var leaderboardId = "anArcadeLeaderboardId";
var versionId = -1;
var maxResults = 10;
var leaderboardProxy = bridge.getLeaderboardServiceProxy();

var postResult = leaderboardProxy.getPlayerScores(leaderboardId, versionId, maxResults);
if (postResult.status == 200) {
    // Success!
}

Raw

{
    "service": "leaderboard",
    "operation": "GET_PLAYER_SCORES",
    "data": {
        "leaderboardId": "anArcadeLeaderboardId",
        "versionId": -1,
        "maxResults": 10
    }
}

JSON Response

{
  "data": {
    "versionId": 1,
    "scores": [
      {
        "score": 10101,
        "data": {
          "nickname": "batman"
        },
        "createdAt": 1613678944374,
        "updatedAt": 1613678944374
      },
      {
        "score": 101,
        "data": {
          "nickname": "batman"
        },
        "createdAt": 1613678939147,
        "updatedAt": 1613678939147
      },
      {
        "score": 10,
        "data": {
          "nickname": "batman"
        },
        "createdAt": 1613678933679,
        "updatedAt": 1613678933679
      }
    ],
    "leaderboardId": "anArcadeLeaderboardId"
  },
  "status": 200
}