MatchUpdatedMessage
A message indicating that there has been an update to a pending match request, but it is not yet complete
Request Parameters
Parameter | Required | Type | Description |
---|---|---|---|
addedPlayers | No | string[] | The players that joined this match |
matchData | No | JSON | The arbitrary data that is stored on a pendingMatch in the matchData field |
matchGroup | No | string | The group the player was assigned in the matchmaking request |
matchId | No | string | The id for this match instance |
matchShortCode | No | string | The shortCode of the match type this message for |
messageId | No | string | A unique identifier for this message. |
notification | No | boolean | Flag indicating whether this message could be sent as a push notification or not. |
participants | No | Participant[] | The participants in this match |
removedPlayers | No | string[] | The players that left this match |
scriptData | No | ScriptData[] | ScriptData is arbitrary data that can be stored in a message by a Cloud Code script. |
subTitle | No | string | A textual title for the message. |
summary | No | string | A textual summary describing the message's purpose. |
title | No | string | A textual title for the message. |
Nested types
Participant
A nested object that represents a participant in a match.
Parameter | Type | Description |
---|---|---|
achievements | string[] | The achievements of the Player |
displayName | string | The display name of the Player |
externalIds | JSON | The external Id's of the Player |
id | string | The Id of the Player |
online | boolean | The online status of the Player |
participantData | JSON | A JSON Map of any data that was associated to this user |
peerId | number | The peerId of this participant within the match |
scriptData | JSON | The script data of the Player |
virtualGoods | string[] | The virtual goods of the Player |
ScriptData
A collection of arbitrary data that can be added to a message via a Cloud Code script.
Parameter | Type | Description |
---|---|---|
myKey | string | An arbitrary data key |
myValue | JSON | An arbitrary data value. |
Code Samples
C#
MatchUpdatedMessage.Listener = (message) => {
IList<string> addedPlayers = message.AddedPlayers;
GSData matchData = message.MatchData;
string matchGroup = message.MatchGroup;
string matchId = message.MatchId;
string matchShortCode = message.MatchShortCode;
string messageId = message.MessageId;
bool? notification = message.Notification;
GSEnumerable<MatchUpdatedMessage._Participant> participants = message.Participants;
IList<string> removedPlayers = message.RemovedPlayers;
GSEnumerable<GSData> scriptData = message.ScriptData;
string subTitle = message.SubTitle;
string summary = message.Summary;
string title = message.Title;
};
ActionScript 3
gs.getMessageHandler().setHandler(
".MatchUpdatedMessage",
function (message:MatchUpdatedMessage):void {
var addedPlayers:Vector.<String> = message.getAddedPlayers();
var matchData:Object = message.getMatchData();
var matchGroup:String = message.getMatchGroup();
var matchId:String = message.getMatchId();
var matchShortCode:String = message.getMatchShortCode();
var messageId:String = message.getMessageId();
var notification:Boolean = message.getNotification();
var participants:Vector.<Participant> = message.getParticipants();
var removedPlayers:Vector.<String> = message.getRemovedPlayers();
var scriptData:Vector.<ScriptData> = message.getScriptData();
var subTitle:String = message.getSubTitle();
var summary:String = message.getSummary();
var title:String = message.getTitle();
}
);
Objective-C
[listener onGSMatchUpdatedMessage:^(GSMatchUpdatedMessage* message) {
NSArray* addedPlayers = [message getAddedPlayers];
NSDictionary* matchData = [message getMatchData];
NSString* matchGroup = [message getMatchGroup];
NSString* matchId = [message getMatchId];
NSString* matchShortCode = [message getMatchShortCode];
NSString* messageId = [message getMessageId];
BOOL notification = [message getNotification];
NSArray* participants = [message getParticipants];
NSArray* removedPlayers = [message getRemovedPlayers];
NSArray* scriptData = [message getScriptData];
NSString* subTitle = [message getSubTitle];
NSString* summary = [message getSummary];
NSString* title = [message getTitle];
}];
Java
gs.getMessageHandler().setMatchUpdatedMessageListener(
new GSEventConsumer<MatchUpdatedMessage>() {
public void onEvent(MatchUpdatedMessage message) {
List<String> addedPlayers = message.getAddedPlayers();
GSData matchData = message.getMatchData();
String matchGroup = message.getMatchGroup();
String matchId = message.getMatchId();
String matchShortCode = message.getMatchShortCode();
String messageId = message.getMessageId();
Boolean notification = message.getNotification();
List<Participant> participants = message.getParticipants();
List<String> removedPlayers = message.getRemovedPlayers();
String subTitle = message.getSubTitle();
String summary = message.getSummary();
String title = message.getTitle();
}
}
);
C++
using namespace GameSparks::Core;
using namespace GameSparks::Api::Messages;
...
void OnMatchUpdatedMessage(GS& gsInstance, const MatchUpdatedMessage& message)
{
gsstl:vector<gsstl::string> addedPlayers = message.getAddedPlayers();
GSData matchData = message.getMatchData();
gsstl::string matchGroup = message.getMatchGroup();
gsstl::string matchId = message.getMatchId();
gsstl::string matchShortCode = message.getMatchShortCode();
gsstl::string messageId = message.getMessageId();
Optional::t_BoolOptional notification = message.getNotification();
gsstl:vector<Types::Participant*> participants = message.getParticipants();
gsstl:vector<gsstl::string> removedPlayers = message.getRemovedPlayers();
gsstl:vector<GSData> scriptData = message.getScriptData();
gsstl::string subTitle = message.getSubTitle();
gsstl::string summary = message.getSummary();
gsstl::string title = message.getTitle();
}
...
GS.SetMessageListener(OnMatchUpdatedMessage);