/// <summary>
/// Attempts to locate a game session matching the given parameters. If the goal is to match the player into a specific active session, only the LobbyId is required. Otherwise, the BuildVersion, GameMode, and Region are all required parameters. Note that parameters specified in the search are required (they are not weighting factors). If a slot is found in a server instance matching the parameters, the slot will be assigned to that player, removing it from the availabe set. In that case, the information on the game session will be returned, otherwise the Status returned will be GameNotFound. Note that EnableQueue is deprecated at this time.
/// </summary>
public static void Matchmake(MatchmakeRequest request, ProcessApiCallback<MatchmakeResult> resultCallback, ErrorCallback errorCallback, object customData = null)
{
if (_authKey == null) throw new Exception("Must be logged in to call this method");
string serializedJson = SimpleJson.SerializeObject(request, Util.ApiSerializerStrategy);
Action<CallRequestContainer> callback = delegate(CallRequestContainer requestContainer)
{
ResultContainer<MatchmakeResult>.HandleResults(requestContainer, resultCallback, errorCallback, null);
};
PlayFabHTTP.Post("/Client/Matchmake", serializedJson, "X-Authorization", _authKey, callback, request, customData);
}
/// <summary>
/// Attempts to locate a game session matching the given parameters. Note that parameters specified in the search are required (they are not weighting factors). If a slot is found in a server instance matching the parameters, the slot will be assigned to that player, removing it from the availabe set. In that case, the information on the game session will be returned, otherwise the Status returned will be GameNotFound. Note that EnableQueue is deprecated at this time.
/// </summary>
public static void Matchmake(MatchmakeRequest request, MatchmakeCallback resultCallback, ErrorCallback errorCallback)
{
if (AuthKey == null) throw new Exception ("Must be logged in to call this method");
string serializedJSON = JsonConvert.SerializeObject(request, Util.JsonFormatting, Util.JsonSettings);
Action<string,string> callback = delegate(string responseStr, string errorStr)
{
MatchmakeResult result = null;
PlayFabError error = null;
ResultContainer<MatchmakeResult>.HandleResults(responseStr, errorStr, out result, out error);
if(error != null && errorCallback != null)
{
errorCallback(error);
}
if(result != null)
{
if(resultCallback != null)
{
resultCallback(result);
}
}
};
PlayFabHTTP.Post(PlayFabSettings.GetURL()+"/Client/Matchmake", serializedJSON, "X-Authorization", AuthKey, callback);
}
/// <summary>
/// Attempts to locate a game session matching the given parameters. Note that parameters specified in the search are required (they are not weighting factors). If a slot is found in a server instance matching the parameters, the slot will be assigned to that player, removing it from the availabe set. In that case, the information on the game session will be returned, otherwise the Status returned will be GameNotFound. Note that EnableQueue is deprecated at this time.
/// </summary>
public static async Task<PlayFabResult<MatchmakeResult>> MatchmakeAsync(MatchmakeRequest request)
{
if (AuthKey == null) throw new Exception ("Must be logged in to call this method");
object httpResult = await PlayFabHTTP.DoPost(PlayFabSettings.GetURL() + "/Client/Matchmake", request, "X-Authorization", AuthKey);
if(httpResult is PlayFabError)
{
PlayFabError error = (PlayFabError)httpResult;
if (PlayFabSettings.GlobalErrorHandler != null)
PlayFabSettings.GlobalErrorHandler(error);
return new PlayFabResult<MatchmakeResult>
{
Error = error,
};
}
string resultRawJson = (string)httpResult;
var serializer = JsonSerializer.Create(PlayFabSettings.JsonSettings);
var resultData = serializer.Deserialize<PlayFabJsonSuccess<MatchmakeResult>>(new JsonTextReader(new StringReader(resultRawJson)));
MatchmakeResult result = resultData.data;
return new PlayFabResult<MatchmakeResult>
{
Result = result
};
}