#[non_exhaustive]pub struct GameSessionBuilder { /* private fields */ }
Expand description
A builder for GameSession
.
Implementations§
Source§impl GameSessionBuilder
impl GameSessionBuilder
Sourcepub fn game_session_id(self, input: impl Into<String>) -> Self
pub fn game_session_id(self, input: impl Into<String>) -> Self
A unique identifier for the game session. A game session ARN has the following format: arn:aws:gamelift:
.
Sourcepub fn set_game_session_id(self, input: Option<String>) -> Self
pub fn set_game_session_id(self, input: Option<String>) -> Self
A unique identifier for the game session. A game session ARN has the following format: arn:aws:gamelift:
.
Sourcepub fn get_game_session_id(&self) -> &Option<String>
pub fn get_game_session_id(&self) -> &Option<String>
A unique identifier for the game session. A game session ARN has the following format: arn:aws:gamelift:
.
Sourcepub fn name(self, input: impl Into<String>) -> Self
pub fn name(self, input: impl Into<String>) -> Self
A descriptive label that is associated with a game session. Session names do not need to be unique.
Sourcepub fn set_name(self, input: Option<String>) -> Self
pub fn set_name(self, input: Option<String>) -> Self
A descriptive label that is associated with a game session. Session names do not need to be unique.
Sourcepub fn get_name(&self) -> &Option<String>
pub fn get_name(&self) -> &Option<String>
A descriptive label that is associated with a game session. Session names do not need to be unique.
Sourcepub fn fleet_id(self, input: impl Into<String>) -> Self
pub fn fleet_id(self, input: impl Into<String>) -> Self
A unique identifier for the fleet that the game session is running on.
Sourcepub fn set_fleet_id(self, input: Option<String>) -> Self
pub fn set_fleet_id(self, input: Option<String>) -> Self
A unique identifier for the fleet that the game session is running on.
Sourcepub fn get_fleet_id(&self) -> &Option<String>
pub fn get_fleet_id(&self) -> &Option<String>
A unique identifier for the fleet that the game session is running on.
Sourcepub fn fleet_arn(self, input: impl Into<String>) -> Self
pub fn fleet_arn(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) associated with the GameLift fleet that this game session is running on.
Sourcepub fn set_fleet_arn(self, input: Option<String>) -> Self
pub fn set_fleet_arn(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) associated with the GameLift fleet that this game session is running on.
Sourcepub fn get_fleet_arn(&self) -> &Option<String>
pub fn get_fleet_arn(&self) -> &Option<String>
The Amazon Resource Name (ARN) associated with the GameLift fleet that this game session is running on.
Sourcepub fn creation_time(self, input: DateTime) -> Self
pub fn creation_time(self, input: DateTime) -> Self
A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn set_creation_time(self, input: Option<DateTime>) -> Self
pub fn set_creation_time(self, input: Option<DateTime>) -> Self
A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn get_creation_time(&self) -> &Option<DateTime>
pub fn get_creation_time(&self) -> &Option<DateTime>
A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn termination_time(self, input: DateTime) -> Self
pub fn termination_time(self, input: DateTime) -> Self
A time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn set_termination_time(self, input: Option<DateTime>) -> Self
pub fn set_termination_time(self, input: Option<DateTime>) -> Self
A time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn get_termination_time(&self) -> &Option<DateTime>
pub fn get_termination_time(&self) -> &Option<DateTime>
A time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn current_player_session_count(self, input: i32) -> Self
pub fn current_player_session_count(self, input: i32) -> Self
Number of players currently in the game session.
Sourcepub fn set_current_player_session_count(self, input: Option<i32>) -> Self
pub fn set_current_player_session_count(self, input: Option<i32>) -> Self
Number of players currently in the game session.
Sourcepub fn get_current_player_session_count(&self) -> &Option<i32>
pub fn get_current_player_session_count(&self) -> &Option<i32>
Number of players currently in the game session.
Sourcepub fn maximum_player_session_count(self, input: i32) -> Self
pub fn maximum_player_session_count(self, input: i32) -> Self
The maximum number of players that can be connected simultaneously to the game session.
Sourcepub fn set_maximum_player_session_count(self, input: Option<i32>) -> Self
pub fn set_maximum_player_session_count(self, input: Option<i32>) -> Self
The maximum number of players that can be connected simultaneously to the game session.
Sourcepub fn get_maximum_player_session_count(&self) -> &Option<i32>
pub fn get_maximum_player_session_count(&self) -> &Option<i32>
The maximum number of players that can be connected simultaneously to the game session.
Sourcepub fn status(self, input: GameSessionStatus) -> Self
pub fn status(self, input: GameSessionStatus) -> Self
Current status of the game session. A game session must have an ACTIVE
status to have player sessions.
Sourcepub fn set_status(self, input: Option<GameSessionStatus>) -> Self
pub fn set_status(self, input: Option<GameSessionStatus>) -> Self
Current status of the game session. A game session must have an ACTIVE
status to have player sessions.
Sourcepub fn get_status(&self) -> &Option<GameSessionStatus>
pub fn get_status(&self) -> &Option<GameSessionStatus>
Current status of the game session. A game session must have an ACTIVE
status to have player sessions.
Sourcepub fn status_reason(self, input: GameSessionStatusReason) -> Self
pub fn status_reason(self, input: GameSessionStatusReason) -> Self
Provides additional information about game session status.
-
INTERRUPTED
-- The game session was hosted on an EC2 Spot instance that was reclaimed, causing the active game session to be stopped. -
TRIGGERED_ON_PROCESS_TERMINATE
– The game session was stopped by callingTerminateGameSession
with the termination modeTRIGGER_ON_PROCESS_TERMINATE
. -
FORCE_TERMINATED
– The game session was stopped by callingTerminateGameSession
with the termination modeFORCE_TERMINATE
.
Sourcepub fn set_status_reason(self, input: Option<GameSessionStatusReason>) -> Self
pub fn set_status_reason(self, input: Option<GameSessionStatusReason>) -> Self
Provides additional information about game session status.
-
INTERRUPTED
-- The game session was hosted on an EC2 Spot instance that was reclaimed, causing the active game session to be stopped. -
TRIGGERED_ON_PROCESS_TERMINATE
– The game session was stopped by callingTerminateGameSession
with the termination modeTRIGGER_ON_PROCESS_TERMINATE
. -
FORCE_TERMINATED
– The game session was stopped by callingTerminateGameSession
with the termination modeFORCE_TERMINATE
.
Sourcepub fn get_status_reason(&self) -> &Option<GameSessionStatusReason>
pub fn get_status_reason(&self) -> &Option<GameSessionStatusReason>
Provides additional information about game session status.
-
INTERRUPTED
-- The game session was hosted on an EC2 Spot instance that was reclaimed, causing the active game session to be stopped. -
TRIGGERED_ON_PROCESS_TERMINATE
– The game session was stopped by callingTerminateGameSession
with the termination modeTRIGGER_ON_PROCESS_TERMINATE
. -
FORCE_TERMINATED
– The game session was stopped by callingTerminateGameSession
with the termination modeFORCE_TERMINATE
.
Sourcepub fn game_properties(self, input: GameProperty) -> Self
pub fn game_properties(self, input: GameProperty) -> Self
Appends an item to game_properties
.
To override the contents of this collection use set_game_properties
.
A set of key-value pairs that can store custom data in a game session. For example: {"Key": "difficulty", "Value": "novice"}
.
Sourcepub fn set_game_properties(self, input: Option<Vec<GameProperty>>) -> Self
pub fn set_game_properties(self, input: Option<Vec<GameProperty>>) -> Self
A set of key-value pairs that can store custom data in a game session. For example: {"Key": "difficulty", "Value": "novice"}
.
Sourcepub fn get_game_properties(&self) -> &Option<Vec<GameProperty>>
pub fn get_game_properties(&self) -> &Option<Vec<GameProperty>>
A set of key-value pairs that can store custom data in a game session. For example: {"Key": "difficulty", "Value": "novice"}
.
Sourcepub fn ip_address(self, input: impl Into<String>) -> Self
pub fn ip_address(self, input: impl Into<String>) -> Self
The IP address of the game session. To connect to a Amazon GameLift Servers game server, an app needs both the IP address and port number.
Sourcepub fn set_ip_address(self, input: Option<String>) -> Self
pub fn set_ip_address(self, input: Option<String>) -> Self
The IP address of the game session. To connect to a Amazon GameLift Servers game server, an app needs both the IP address and port number.
Sourcepub fn get_ip_address(&self) -> &Option<String>
pub fn get_ip_address(&self) -> &Option<String>
The IP address of the game session. To connect to a Amazon GameLift Servers game server, an app needs both the IP address and port number.
Sourcepub fn dns_name(self, input: impl Into<String>) -> Self
pub fn dns_name(self, input: impl Into<String>) -> Self
The DNS identifier assigned to the instance that is running the game session. Values have the following format:
-
TLS-enabled fleets:
.. .amazongamelift.com -
Non-TLS-enabled fleets:
ec2-
. (See Amazon EC2 Instance IP Addressing.).compute.amazonaws.com
When connecting to a game session that is running on a TLS-enabled fleet, you must use the DNS name, not the IP address.
Sourcepub fn set_dns_name(self, input: Option<String>) -> Self
pub fn set_dns_name(self, input: Option<String>) -> Self
The DNS identifier assigned to the instance that is running the game session. Values have the following format:
-
TLS-enabled fleets:
.. .amazongamelift.com -
Non-TLS-enabled fleets:
ec2-
. (See Amazon EC2 Instance IP Addressing.).compute.amazonaws.com
When connecting to a game session that is running on a TLS-enabled fleet, you must use the DNS name, not the IP address.
Sourcepub fn get_dns_name(&self) -> &Option<String>
pub fn get_dns_name(&self) -> &Option<String>
The DNS identifier assigned to the instance that is running the game session. Values have the following format:
-
TLS-enabled fleets:
.. .amazongamelift.com -
Non-TLS-enabled fleets:
ec2-
. (See Amazon EC2 Instance IP Addressing.).compute.amazonaws.com
When connecting to a game session that is running on a TLS-enabled fleet, you must use the DNS name, not the IP address.
Sourcepub fn port(self, input: i32) -> Self
pub fn port(self, input: i32) -> Self
The port number for the game session. To connect to a Amazon GameLift Servers game server, an app needs both the IP address and port number.
Sourcepub fn set_port(self, input: Option<i32>) -> Self
pub fn set_port(self, input: Option<i32>) -> Self
The port number for the game session. To connect to a Amazon GameLift Servers game server, an app needs both the IP address and port number.
Sourcepub fn get_port(&self) -> &Option<i32>
pub fn get_port(&self) -> &Option<i32>
The port number for the game session. To connect to a Amazon GameLift Servers game server, an app needs both the IP address and port number.
Sourcepub fn player_session_creation_policy(
self,
input: PlayerSessionCreationPolicy,
) -> Self
pub fn player_session_creation_policy( self, input: PlayerSessionCreationPolicy, ) -> Self
Indicates whether the game session is accepting new players.
Sourcepub fn set_player_session_creation_policy(
self,
input: Option<PlayerSessionCreationPolicy>,
) -> Self
pub fn set_player_session_creation_policy( self, input: Option<PlayerSessionCreationPolicy>, ) -> Self
Indicates whether the game session is accepting new players.
Sourcepub fn get_player_session_creation_policy(
&self,
) -> &Option<PlayerSessionCreationPolicy>
pub fn get_player_session_creation_policy( &self, ) -> &Option<PlayerSessionCreationPolicy>
Indicates whether the game session is accepting new players.
Sourcepub fn creator_id(self, input: impl Into<String>) -> Self
pub fn creator_id(self, input: impl Into<String>) -> Self
A unique identifier for a player. This ID is used to enforce a resource protection policy (if one exists), that limits the number of game sessions a player can create.
Sourcepub fn set_creator_id(self, input: Option<String>) -> Self
pub fn set_creator_id(self, input: Option<String>) -> Self
A unique identifier for a player. This ID is used to enforce a resource protection policy (if one exists), that limits the number of game sessions a player can create.
Sourcepub fn get_creator_id(&self) -> &Option<String>
pub fn get_creator_id(&self) -> &Option<String>
A unique identifier for a player. This ID is used to enforce a resource protection policy (if one exists), that limits the number of game sessions a player can create.
Sourcepub fn game_session_data(self, input: impl Into<String>) -> Self
pub fn game_session_data(self, input: impl Into<String>) -> Self
A set of custom game session properties, formatted as a single string value. This data is passed to a game server process with a request to start a new game session. For more information, see Start a game session.
Sourcepub fn set_game_session_data(self, input: Option<String>) -> Self
pub fn set_game_session_data(self, input: Option<String>) -> Self
A set of custom game session properties, formatted as a single string value. This data is passed to a game server process with a request to start a new game session. For more information, see Start a game session.
Sourcepub fn get_game_session_data(&self) -> &Option<String>
pub fn get_game_session_data(&self) -> &Option<String>
A set of custom game session properties, formatted as a single string value. This data is passed to a game server process with a request to start a new game session. For more information, see Start a game session.
Sourcepub fn matchmaker_data(self, input: impl Into<String>) -> Self
pub fn matchmaker_data(self, input: impl Into<String>) -> Self
Information about the matchmaking process that resulted in the game session, if matchmaking was used. Data is in JSON syntax, formatted as a string. Information includes the matchmaker ID as well as player attributes and team assignments. For more details on matchmaker data, see Match Data. Matchmaker data is updated whenever new players are added during a successful backfill (see StartMatchBackfill).
Sourcepub fn set_matchmaker_data(self, input: Option<String>) -> Self
pub fn set_matchmaker_data(self, input: Option<String>) -> Self
Information about the matchmaking process that resulted in the game session, if matchmaking was used. Data is in JSON syntax, formatted as a string. Information includes the matchmaker ID as well as player attributes and team assignments. For more details on matchmaker data, see Match Data. Matchmaker data is updated whenever new players are added during a successful backfill (see StartMatchBackfill).
Sourcepub fn get_matchmaker_data(&self) -> &Option<String>
pub fn get_matchmaker_data(&self) -> &Option<String>
Information about the matchmaking process that resulted in the game session, if matchmaking was used. Data is in JSON syntax, formatted as a string. Information includes the matchmaker ID as well as player attributes and team assignments. For more details on matchmaker data, see Match Data. Matchmaker data is updated whenever new players are added during a successful backfill (see StartMatchBackfill).
Sourcepub fn location(self, input: impl Into<String>) -> Self
pub fn location(self, input: impl Into<String>) -> Self
The fleet location where the game session is running. This value might specify the fleet's home Region or a remote location. Location is expressed as an Amazon Web Services Region code such as us-west-2
.
Sourcepub fn set_location(self, input: Option<String>) -> Self
pub fn set_location(self, input: Option<String>) -> Self
The fleet location where the game session is running. This value might specify the fleet's home Region or a remote location. Location is expressed as an Amazon Web Services Region code such as us-west-2
.
Sourcepub fn get_location(&self) -> &Option<String>
pub fn get_location(&self) -> &Option<String>
The fleet location where the game session is running. This value might specify the fleet's home Region or a remote location. Location is expressed as an Amazon Web Services Region code such as us-west-2
.
Sourcepub fn build(self) -> GameSession
pub fn build(self) -> GameSession
Consumes the builder and constructs a GameSession
.
Trait Implementations§
Source§impl Clone for GameSessionBuilder
impl Clone for GameSessionBuilder
Source§fn clone(&self) -> GameSessionBuilder
fn clone(&self) -> GameSessionBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for GameSessionBuilder
impl Debug for GameSessionBuilder
Source§impl Default for GameSessionBuilder
impl Default for GameSessionBuilder
Source§fn default() -> GameSessionBuilder
fn default() -> GameSessionBuilder
Source§impl PartialEq for GameSessionBuilder
impl PartialEq for GameSessionBuilder
impl StructuralPartialEq for GameSessionBuilder
Auto Trait Implementations§
impl Freeze for GameSessionBuilder
impl RefUnwindSafe for GameSessionBuilder
impl Send for GameSessionBuilder
impl Sync for GameSessionBuilder
impl Unpin for GameSessionBuilder
impl UnwindSafe for GameSessionBuilder
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);