FindPlayersUsingScript

Finds matchmaking enabled players using optionally specified filter script and optional player rating override. Passing empty string (i.e. "") for scriptName will not run a script filter. Passing null will invoke the configured script similar to findPlayersUsingFilter.

Similarly passing null for player rating will use the players current rating.

Additional information of filters can be found under Matchmaking Filters.

Service	Operation
matchMaking	FIND_PLAYERS_USING_SCRIPT

Method Parameters

Parameter	Description
rangeDelta	How close an opponents rating must be to yours
numMatches	The maximum number of matches to return
playerRating	Player rating override
scriptName	Name of filter script
jsonExtraParms	Parameters to be passed to the filter

Usage

http://localhost:3000

C#

// Cloud Code only. To view example, switch to the Cloud Code tab

C++

// Cloud Code only. To view example, switch to the Cloud Code tab

Objective-C

// Cloud Code only. To view example, switch to the Cloud Code tab

Java

// Cloud Code only. To view example, switch to the Cloud Code tab

JavaScript

// Cloud Code only. To view example, switch to the Cloud Code tab

Dart

// Cloud Code only. To view example, switch to the Cloud Code tab

Cloud Code

var rangeDelta = 10;
var numMatches = 1;
var playerRating = 10;
var scriptName = "script";
var jsonExtraParms = {
    "parm1": 10
};
var matchMakingProxy = bridge.getMatchMakingServiceProxy();

var postResult = matchMakingProxy.findPlayersUsingScript(rangeDelta, numMatches, playerRating, scriptName, jsonExtraParms);
if (postResult.status == 200) {
    // Success!
}

Raw

{
  "rangeDelta": 10,
  "numMatches": 1,
  "playerRating": 10,
  "scriptName": "script",
  "extraParms": {
    "parm1": 10
  }
}

JSON Response

{
    "status": 200,
    "data": {
        "matchesFound": [
            {
                "pictureUrl": null,
                "playerName": "UserC-1239941736",
                "playerId": "c2b88d3f-2s32-43a6-9a71-0f0157e46505",
                "playerRating": 0,
                "summaryFriendData": null
            },
            {
                "pictureUrl": null,
                "playerName": "UserA-914307852",
                "playerId": "96afefc7-02b2-4148-8d36-c62855d917b6",
                "playerRating": 0,
                "summaryFriendData": null
            }
        ]
    }
}