Package software.amazon.awssdk.services.gamelift.model

Class GameSessionPlacement

java.lang.Object

software.amazon.awssdk.services.gamelift.model.GameSessionPlacement

All Implemented Interfaces:

StructuredPojo, ToCopyableBuilder<GameSessionPlacement.Builder,GameSessionPlacement>

@Generated("software.amazon.awssdk:codegen")
public class GameSessionPlacement
extends Object
implements StructuredPojo, ToCopyableBuilder<GameSessionPlacement.Builder,GameSessionPlacement>

Object that describes a StartGameSessionPlacement request. This object includes the full details of the original request plus the current status and start/end time stamps.

Game session placement-related operations include:

• StartGameSessionPlacement

• DescribeGameSessionPlacement

• StopGameSessionPlacement

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	GameSessionPlacement.Builder

Method Summary

Modifier and Type	Method	Description
static GameSessionPlacement.Builder	builder()
Date	endTime()	Time stamp indicating when this request was completed, canceled, or timed out.
boolean	equals(Object obj)
List<GameProperty>	gameProperties()	Set of developer-defined properties for a game session.
String	gameSessionArn()	Identifier for the game session created by this placement request.
String	gameSessionId()	Unique identifier for the game session.
String	gameSessionName()	Descriptive label that is associated with a game session.
String	gameSessionQueueName()	Descriptive label that is associated with queue.
String	gameSessionRegion()	Name of the region where the game session created by this placement request is running.
int	hashCode()
String	ipAddress()	IP address of the game session.
void	marshall(ProtocolMarshaller protocolMarshaller)	Marshalls this structured data using the given ProtocolMarshaller.
Integer	maximumPlayerSessionCount()	Maximum number of players that can be connected simultaneously to the game session.
List<PlacedPlayerSession>	placedPlayerSessions()	Collection of information on player sessions created in response to the game session placement request.
String	placementId()	Unique identifier for a game session placement.
List<PlayerLatency>	playerLatencies()	Set of values, expressed in milliseconds, indicating the amount of latency that players are experiencing when connected to AWS regions.
Integer	port()	Port number for the game session.
static Class<? extends GameSessionPlacement.Builder>	serializableBuilderClass()
Date	startTime()	Time stamp indicating when this request was placed in the queue.
String	status()	Current status of the game session placement request.
GameSessionPlacement.Builder	toBuilder()	Take this object and create a builder that contains all of the current property values of this object.
String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

placementId

public String placementId()

Unique identifier for a game session placement.

Returns:

Unique identifier for a game session placement.

gameSessionQueueName

public String gameSessionQueueName()

Descriptive label that is associated with queue. Queue names must be unique within each region.

Returns:

Descriptive label that is associated with queue. Queue names must be unique within each region.

status

public String status()

Current status of the game session placement request.

• PENDING – The placement request is currently in the queue waiting to be processed.

• FULFILLED – A new game session and player sessions (if requested) have been successfully created. Values for GameSessionArn and GameSessionRegion are available.

• CANCELLED – The placement request was canceled with a call to StopGameSessionPlacement.

• TIMED_OUT – A new game session was not successfully created before the time limit expired. You can resubmit the placement request as needed.

Returns:

Current status of the game session placement request.

• PENDING – The placement request is currently in the queue waiting to be processed.

• FULFILLED – A new game session and player sessions (if requested) have been successfully created. Values for GameSessionArn and GameSessionRegion are available.

• CANCELLED – The placement request was canceled with a call to StopGameSessionPlacement.

• TIMED_OUT – A new game session was not successfully created before the time limit expired. You can resubmit the placement request as needed.

See Also:

GameSessionPlacementState

gameProperties

public List<GameProperty> gameProperties()

Set of developer-defined properties for a game session. These properties are passed to the server process hosting the game session.

Returns:

Set of developer-defined properties for a game session. These properties are passed to the server process hosting the game session.

maximumPlayerSessionCount

public Integer maximumPlayerSessionCount()

Maximum number of players that can be connected simultaneously to the game session.

Returns:

Maximum number of players that can be connected simultaneously to the game session.

gameSessionName

public String gameSessionName()

Descriptive label that is associated with a game session. Session names do not need to be unique.

Returns:

Descriptive label that is associated with a game session. Session names do not need to be unique.

gameSessionId

public String gameSessionId()

Unique identifier for the game session. This value is set once the new game session is placed (placement status is Fulfilled).

Returns:

Unique identifier for the game session. This value is set once the new game session is placed (placement status is Fulfilled).

gameSessionArn

public String gameSessionArn()

Identifier for the game session created by this placement request. This value is set once the new game session is placed (placement status is Fulfilled). This identifier is unique across all regions. You can use this value as a GameSessionId value as needed.

Returns:

Identifier for the game session created by this placement request. This value is set once the new game session is placed (placement status is Fulfilled). This identifier is unique across all regions. You can use this value as a GameSessionId value as needed.

gameSessionRegion

public String gameSessionRegion()

Name of the region where the game session created by this placement request is running. This value is set once the new game session is placed (placement status is Fulfilled).

Returns:

Name of the region where the game session created by this placement request is running. This value is set once the new game session is placed (placement status is Fulfilled).

playerLatencies

public List<PlayerLatency> playerLatencies()

Set of values, expressed in milliseconds, indicating the amount of latency that players are experiencing when connected to AWS regions.

Returns:

Set of values, expressed in milliseconds, indicating the amount of latency that players are experiencing when connected to AWS regions.

startTime

public Date startTime()

Time stamp indicating when this request was placed in the queue. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").

Returns:

Time stamp indicating when this request was placed in the queue. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057").

endTime

public Date endTime()

Time stamp indicating when this request was completed, canceled, or timed out.

Returns:

Time stamp indicating when this request was completed, canceled, or timed out.

ipAddress

public String ipAddress()

IP address of the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number. This value is set once the new game session is placed (placement status is Fulfilled).

Returns:

IP address of the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number. This value is set once the new game session is placed (placement status is Fulfilled).

port

public Integer port()

Port number for the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number. This value is set once the new game session is placed (placement status is Fulfilled).

Returns:

Port number for the game session. To connect to a Amazon GameLift game server, an app needs both the IP address and port number. This value is set once the new game session is placed (placement status is Fulfilled).

placedPlayerSessions

public List<PlacedPlayerSession> placedPlayerSessions()

Collection of information on player sessions created in response to the game session placement request. These player sessions are created only once a new game session is successfully placed (placement status is Fulfilled). This information includes the player ID (as provided in the placement request) and the corresponding player session ID. Retrieve full player sessions by calling DescribePlayerSessions with the player session ID.

Returns:

Collection of information on player sessions created in response to the game session placement request. These player sessions are created only once a new game session is successfully placed (placement status is Fulfilled). This information includes the player ID (as provided in the placement request) and the corresponding player session ID. Retrieve full player sessions by calling DescribePlayerSessions with the player session ID.

toBuilder

public GameSessionPlacement.Builder toBuilder()

Description copied from interface: ToCopyableBuilder

Take this object and create a builder that contains all of the current property values of this object.

Specified by:

toBuilder in interface ToCopyableBuilder<GameSessionPlacement.Builder,GameSessionPlacement>

Returns:

a builder for type T

builder

public static GameSessionPlacement.Builder builder()

serializableBuilderClass

public static Class<? extends GameSessionPlacement.Builder> serializableBuilderClass()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

marshall

public void marshall(ProtocolMarshaller protocolMarshaller)

Description copied from interface: StructuredPojo

Marshalls this structured data using the given ProtocolMarshaller.

Specified by:

marshall in interface StructuredPojo

Parameters:

protocolMarshaller - Implementation of ProtocolMarshaller used to marshall this object's data.