FindPlayersWithAttributesUsingScript

Finds matchmaking enabled players using optionally specified filter script, optional player rating override and additional attributes. 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.

This call is cloud-code only.

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
jsonAttributes	Attributes match criteria
playerRating	Player rating override
scriptName	Name of filter script
jsonExtraParms	Parameters to be passed to the filter

Usage

http://localhost:3000

C#

// N/A

C++

// N/A

Objective-C

// N/A

Java

// N/A

JavaScript

// N/A

Dart

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

Cloud Code

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

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

Raw

{
  "rangeDelta": 10,
  "numMatches": 1,
  "attributes": {
    "key": "value"
  },
  "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
            }
        ]
    }
}