Struct aws_sdk_gamelift::client::fluent_builders::CreatePlayerSessions

pub struct CreatePlayerSessions<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* fields omitted */ }

Fluent builder constructing a request to CreatePlayerSessions.

Reserves open slots in a game session for a group of players. New player sessions can be created in any game session with an open slot that is in ACTIVE status and has a player creation policy of ACCEPT_ALL. To add a single player to a game session, use CreatePlayerSession.

To create player sessions, specify a game session ID and a list of player IDs. Optionally, provide a set of player data for each player ID.

If successful, a slot is reserved in the game session for each player, and new PlayerSession objects are returned with player session IDs. Each player references their player session ID when sending a connection request to the game session, and the game server can use it to validate the player reservation with the GameLift service. Player sessions cannot be updated.

Available in Amazon GameLift Local.

Related actions

CreatePlayerSession | CreatePlayerSessions | DescribePlayerSessions | StartGameSessionPlacement | DescribeGameSessionPlacement | All APIs by task

Implementations

impl<C, M, R> CreatePlayerSessions<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub async fn send(
    self
) -> Result<CreatePlayerSessionsOutput, SdkError<CreatePlayerSessionsError>> where
    R::Policy: SmithyRetryPolicy<CreatePlayerSessionsInputOperationOutputAlias, CreatePlayerSessionsOutput, CreatePlayerSessionsError, CreatePlayerSessionsInputOperationRetryAlias>, 

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn game_session_id(self, inp: impl Into<String>) -> Self

A unique identifier for the game session to add players to.

pub fn set_game_session_id(self, input: Option<String>) -> Self

A unique identifier for the game session to add players to.

pub fn player_ids(self, inp: impl Into<String>) -> Self

Appends an item to PlayerIds.

To override the contents of this collection use set_player_ids.

List of unique identifiers for the players to be added.

pub fn set_player_ids(self, input: Option<Vec<String>>) -> Self

List of unique identifiers for the players to be added.

pub fn player_data_map(self, k: impl Into<String>, v: impl Into<String>) -> Self

Adds a key-value pair to PlayerDataMap.

To override the contents of this collection use set_player_data_map.

Map of string pairs, each specifying a player ID and a set of developer-defined information related to the player. Amazon GameLift does not use this data, so it can be formatted as needed for use in the game. Any player data strings for player IDs that are not included in the PlayerIds parameter are ignored.

pub fn set_player_data_map(self, input: Option<HashMap<String, String>>) -> Self

Map of string pairs, each specifying a player ID and a set of developer-defined information related to the player. Amazon GameLift does not use this data, so it can be formatted as needed for use in the game. Any player data strings for player IDs that are not included in the PlayerIds parameter are ignored.

Trait Implementations

impl<C: Debug, M: Debug, R: Debug> Debug for CreatePlayerSessions<C, M, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.