Amazon GameLift server SDK 4.x for C++: Data types

Unique game session identifier. Use this parameter to request all player sessions for the specified game session. Game session ID format is as follows: arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. The value of <ID string> is either a custom ID string or (if one was specified when the game session was created) a generated string.

Type: String

Required: No

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages. If a player session ID is specified, this parameter is ignored.

Type: Integer

Required: No

Token indicating the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To specify the start of the result set, do not specify a value. If a player session ID is specified, this parameter is ignored.

Type: String

Required: No

Unique identifier for a player. Player IDs are defined by the developer. See Generate player IDs.

Type: String

Required: No

Unique identifier for a player session.

Type: String

Required: No

Player session status to filter results on. Possible player session statuses include the following:

Type: String

Required: No

Directory paths to game server log files that you want Amazon GameLift to store for future access. These files are generated during each game session. File paths and names are defined in your game server and stored in the root game build directory. The log paths must be absolute. For example, if your game build stores game session logs in a path like MyGame\sessionlogs\, then the log path would be c:\game\MyGame\sessionLogs (on a Windows instance) or /local/game/MyGame/sessionLogs (on a Linux instance).

Type: std:vector<std::string>

Required: No

Port number the server process listens on for new player connections. The value must fall into the port range configured for any fleet deploying this game server build. This port number is included in game session and player session objects, which game sessions use when connecting to a server process.

Type: Integer

Required: Yes

Object with a list of directory paths to game session log files.

Type: Aws::GameLift::Server::LogParameters

Required: No

Name of callback function that the Amazon GameLift service invokes to activate a new game session. Amazon GameLift calls this function in response to the client request CreateGameSession. The callback function passes a GameSession object (defined in the Amazon GameLift Service API Reference).

Type: const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession

Required: Yes

Name of callback function that the Amazon GameLift service invokes to force the server process to shut down. After calling this function, Amazon GameLift waits five minutes for the server process to shut down and respond with a ProcessEnding() call. If no response is receive, it shuts down the server process.

Type: std::function<void()> onProcessTerminate

Required: No

Name of callback function that the Amazon GameLift service invokes to request a health status report from the server process. Amazon GameLift calls this function every 60 seconds. After calling this function Amazon GameLift waits 60 seconds for a response, and if none is received. records the server process as unhealthy.

Type: std::function<bool()> onHealthCheck

Required: No

Name of callback function that the Amazon GameLift service invokes to pass an updated game session object to the server process. Amazon GameLift calls this function when a match backfill request has been processed in order to provide updated matchmaker data. It passes a GameSession object, a status update (updateReason), and the match backfill ticket ID.

Type: std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession

Required: No

Unique game session identifier. The API action GetGameSessionId() returns the identifier in ARN format.

Type: String

Required: Yes

Unique identifier, in the form of an ARN, for the matchmaker to use for this request. To find the matchmaker that was used to create the original game session, look in the game session object, in the matchmaker data property. Learn more about matchmaker data in Word with matchmaker data.

Type: String

Required: Yes

A set of data representing all players who are currently in the game session. The matchmaker uses this information to search for new players who are good matches for the current players. See the Amazon GameLift API Reference Guide for a description of the Player object format. To find player attributes, IDs, and team assignments, look in the game session object, in the matchmaker data property. If latency is used by the matchmaker, gather updated latency for the current region and include it in each player's data.

Type: std:vector<player>

Required: Yes

Unique identifier for a matchmaking or match backfill request ticket. If no value is provided here, Amazon GameLift will generate one in the form of a UUID. Use this identifier to track the match backfill ticket status or cancel the request if needed.

Type: String

Required: No

Unique game session identifier associated with the request being canceled.

Type: String

Required: Yes

Unique identifier of the matchmaker this request was sent to.

Type: String

Required: Yes

Unique identifier of the backfill request ticket to be canceled.

Type: String

Required: Yes