Game client/server interactions with Amazon GameLift

A new process of the game server executable starts running on a hosting resource.

The game server process calls the following server SDK operations in sequence:

1. InitSDK() to initialize the server SDK, authenticate the server process, and establish communication with the Amazon GameLift service.

2. ProcessReady() to communicate readiness to host a game session. This call also reports the process's connection information, which game clients use to connect to the game session, and other information.

The server process then waits for prompts from the Amazon GameLift service.

Amazon GameLift updates the status of the server process to ACTIVE and available to host a new game session.

Amazon GameLift begins periodically calling the onHealthCheck callback to request a health status from the server processes. These calls continue while the server process remains in active status. The server process must respond healthy or not healthy within one minute. If the server process responds not healthy or doesn't respond, at some point the Amazon GameLift service changes the server process's active status and stops sending requests to start game session.

A player using the game client asks to join a game session. Depending on how your game handles the player join process, the game client sends a request to the backend service.

If the player join process requires starting a new game session, the backend service sends a request for a new game session to the Amazon GameLift service. This request calls the service API operation StartGameSessionPlacement(). (As an alternative, the backend service might call StartMatchmaking(), or CreateGameSession().)

The Amazon GameLift service responds by creating a new GameSessionPlacement ticket with status PENDING. It returns ticket information to the backend service, so that it can track the placement ticket status and determine when the game session is ready for players. For more information, see Set up event notification for game session placement.

The Amazon GameLift service starts the game session placement process. It identifies which fleets to look at and searches those fleets for an active server process that's not hosting a game session. On locating an available server process, the Amazon GameLift service does the following:

1. Creates a GameSession object with the game session settings and player data from the placement request, and sets the status to ACTIVATING.

2. Prompts the server process to start a game session. The service invokes the server process's onStartGameSession callback and passes the GameSession object.

3. Changes the server process's number of game sessions to 1.

The server process runs its onStartGameSession callback function. When the server process is ready to accept player connections, it calls the server SDK operation ActivateGameSession() and waits for player connections.

The Amazon GameLift service updates the GameSession object with connection information for the server process (as reported in the call to ProcessReady()) and sets the game session status to ACTIVE. It also updates the GameSessionPlacement ticket status to FULFILLED.

The backend service calls DescribeGameSessionPlacement() to check ticket status and get game session information. When the game session is active, the backend service notifies the game client and passes the game session connection information.

The game client uses the connection information to connect directly to the game server process and join the game session.

The backend service calls the service API operation CreatePlayerSession() with a game session ID.

The Amazon GameLift service checks the game session status (must be ACTIVE), and looks for an open player slot in the game session. If a slot is available, then the service does the following:

1. Creates a new PlayerSession object and sets the status to RESERVED.

2. Responds to the backend service request with player session information.

The backend service passes player session information to the game client along with game session connection information.

The game client uses the connection information and player session ID to connect directly to the game server process and ask to join the game session.

In response to a game client join attempt, the game server process calls the service API operation AcceptPlayerSession() to validate the player session ID. The server process either accepts or rejects the connection.

The Amazon GameLift service does one of the following:

1. If the connection is accepted, then Amazon GameLift sets the PlayerSession status to ACTIVE and passes the PlayerSession to the game server process.

2. If the game server process doesn't call AcceptPlayerSession() for the player session ID within a certain time period after the original CreatePlayerSession() request, the Amazon GameLift service changes the PlayerSession status to TIMEDOUT and reopens the player slot in the game session.

A player disconnects from the game session.

The game server process detects the lost connection and calls the server SDK operation RemovePlayerSession().

The Amazon GameLift service changes the player session status to COMPLETED and reopens the player slot in the game session.

The game server process ends the game session and initiates process shut down by calling the server SDK operation ProcessEnding().

The Amazon GameLift service does the following:

1. Uploads game session logs to Amazon Simple Storage Service (Amazon S3).

2. Changes the game session status to TERMINATED.

3. Changes the server process status to TERMINATED.

4. Depending on how the hosting solution is designed, the newly available hosting resources are allocated to run a new game server process.