#[non_exhaustive]pub struct StartStreamSessionInputBuilder { /* private fields */ }
Expand description
A builder for StartStreamSessionInput
.
Implementations§
Source§impl StartStreamSessionInputBuilder
impl StartStreamSessionInputBuilder
Sourcepub fn client_token(self, input: impl Into<String>) -> Self
pub fn client_token(self, input: impl Into<String>) -> Self
A unique identifier that represents a client request. The request is idempotent, which ensures that an API request completes only once. When users send a request, Amazon GameLift Streams automatically populates this field.
Sourcepub fn set_client_token(self, input: Option<String>) -> Self
pub fn set_client_token(self, input: Option<String>) -> Self
A unique identifier that represents a client request. The request is idempotent, which ensures that an API request completes only once. When users send a request, Amazon GameLift Streams automatically populates this field.
Sourcepub fn get_client_token(&self) -> &Option<String>
pub fn get_client_token(&self) -> &Option<String>
A unique identifier that represents a client request. The request is idempotent, which ensures that an API request completes only once. When users send a request, Amazon GameLift Streams automatically populates this field.
Sourcepub fn description(self, input: impl Into<String>) -> Self
pub fn description(self, input: impl Into<String>) -> Self
A human-readable label for the stream session. You can update this value later.
Sourcepub fn set_description(self, input: Option<String>) -> Self
pub fn set_description(self, input: Option<String>) -> Self
A human-readable label for the stream session. You can update this value later.
Sourcepub fn get_description(&self) -> &Option<String>
pub fn get_description(&self) -> &Option<String>
A human-readable label for the stream session. You can update this value later.
Sourcepub fn identifier(self, input: impl Into<String>) -> Self
pub fn identifier(self, input: impl Into<String>) -> Self
The stream group to run this stream session with.
This value is an Amazon Resource Name (ARN) or ID that uniquely identifies the stream group resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4
. Example ID: sg-1AB2C3De4
.
Sourcepub fn set_identifier(self, input: Option<String>) -> Self
pub fn set_identifier(self, input: Option<String>) -> Self
The stream group to run this stream session with.
This value is an Amazon Resource Name (ARN) or ID that uniquely identifies the stream group resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4
. Example ID: sg-1AB2C3De4
.
Sourcepub fn get_identifier(&self) -> &Option<String>
pub fn get_identifier(&self) -> &Option<String>
The stream group to run this stream session with.
This value is an Amazon Resource Name (ARN) or ID that uniquely identifies the stream group resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4
. Example ID: sg-1AB2C3De4
.
Sourcepub fn protocol(self, input: Protocol) -> Self
pub fn protocol(self, input: Protocol) -> Self
The data transport protocol to use for the stream session.
This field is required.Sourcepub fn set_protocol(self, input: Option<Protocol>) -> Self
pub fn set_protocol(self, input: Option<Protocol>) -> Self
The data transport protocol to use for the stream session.
Sourcepub fn get_protocol(&self) -> &Option<Protocol>
pub fn get_protocol(&self) -> &Option<Protocol>
The data transport protocol to use for the stream session.
Sourcepub fn signal_request(self, input: impl Into<String>) -> Self
pub fn signal_request(self, input: impl Into<String>) -> Self
A WebRTC ICE offer string to use when initializing a WebRTC connection. Typically, the offer is a very long JSON string. Provide the string as a text value in quotes.
Amazon GameLift Streams also supports setting the field to "NO_CLIENT_CONNECTION". This will create a session without needing any browser request or Web SDK integration. The session starts up as usual and waits for a reconnection from a browser, which is accomplished using CreateStreamSessionConnection.
This field is required.Sourcepub fn set_signal_request(self, input: Option<String>) -> Self
pub fn set_signal_request(self, input: Option<String>) -> Self
A WebRTC ICE offer string to use when initializing a WebRTC connection. Typically, the offer is a very long JSON string. Provide the string as a text value in quotes.
Amazon GameLift Streams also supports setting the field to "NO_CLIENT_CONNECTION". This will create a session without needing any browser request or Web SDK integration. The session starts up as usual and waits for a reconnection from a browser, which is accomplished using CreateStreamSessionConnection.
Sourcepub fn get_signal_request(&self) -> &Option<String>
pub fn get_signal_request(&self) -> &Option<String>
A WebRTC ICE offer string to use when initializing a WebRTC connection. Typically, the offer is a very long JSON string. Provide the string as a text value in quotes.
Amazon GameLift Streams also supports setting the field to "NO_CLIENT_CONNECTION". This will create a session without needing any browser request or Web SDK integration. The session starts up as usual and waits for a reconnection from a browser, which is accomplished using CreateStreamSessionConnection.
Sourcepub fn application_identifier(self, input: impl Into<String>) -> Self
pub fn application_identifier(self, input: impl Into<String>) -> Self
An Amazon Resource Name (ARN) or ID that uniquely identifies the application resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
. Example ID: a-9ZY8X7Wv6
.
Sourcepub fn set_application_identifier(self, input: Option<String>) -> Self
pub fn set_application_identifier(self, input: Option<String>) -> Self
An Amazon Resource Name (ARN) or ID that uniquely identifies the application resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
. Example ID: a-9ZY8X7Wv6
.
Sourcepub fn get_application_identifier(&self) -> &Option<String>
pub fn get_application_identifier(&self) -> &Option<String>
An Amazon Resource Name (ARN) or ID that uniquely identifies the application resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6
. Example ID: a-9ZY8X7Wv6
.
Sourcepub fn user_id(self, input: impl Into<String>) -> Self
pub fn user_id(self, input: impl Into<String>) -> Self
An opaque, unique identifier for an end-user, defined by the developer.
Sourcepub fn set_user_id(self, input: Option<String>) -> Self
pub fn set_user_id(self, input: Option<String>) -> Self
An opaque, unique identifier for an end-user, defined by the developer.
Sourcepub fn get_user_id(&self) -> &Option<String>
pub fn get_user_id(&self) -> &Option<String>
An opaque, unique identifier for an end-user, defined by the developer.
Sourcepub fn locations(self, input: impl Into<String>) -> Self
pub fn locations(self, input: impl Into<String>) -> Self
Appends an item to locations
.
To override the contents of this collection use set_locations
.
A list of locations, in order of priority, where you want Amazon GameLift Streams to start a stream from. For example, us-east-1
. Amazon GameLift Streams selects the location with the next available capacity to start a single stream session in. If this value is empty, Amazon GameLift Streams attempts to start a stream session in the primary location.
For a complete list of locations that Amazon GameLift Streams supports, refer to Regions, quotas, and limitations in the Amazon GameLift Streams Developer Guide.
Sourcepub fn set_locations(self, input: Option<Vec<String>>) -> Self
pub fn set_locations(self, input: Option<Vec<String>>) -> Self
A list of locations, in order of priority, where you want Amazon GameLift Streams to start a stream from. For example, us-east-1
. Amazon GameLift Streams selects the location with the next available capacity to start a single stream session in. If this value is empty, Amazon GameLift Streams attempts to start a stream session in the primary location.
For a complete list of locations that Amazon GameLift Streams supports, refer to Regions, quotas, and limitations in the Amazon GameLift Streams Developer Guide.
Sourcepub fn get_locations(&self) -> &Option<Vec<String>>
pub fn get_locations(&self) -> &Option<Vec<String>>
A list of locations, in order of priority, where you want Amazon GameLift Streams to start a stream from. For example, us-east-1
. Amazon GameLift Streams selects the location with the next available capacity to start a single stream session in. If this value is empty, Amazon GameLift Streams attempts to start a stream session in the primary location.
For a complete list of locations that Amazon GameLift Streams supports, refer to Regions, quotas, and limitations in the Amazon GameLift Streams Developer Guide.
Sourcepub fn connection_timeout_seconds(self, input: i32) -> Self
pub fn connection_timeout_seconds(self, input: i32) -> Self
Length of time (in seconds) that Amazon GameLift Streams should wait for a client to connect or reconnect to the stream session. Applies to both connection and reconnection scenarios. This time span starts when the stream session reaches ACTIVE
state. If no client connects before the timeout, Amazon GameLift Streams terminates the stream session. Default value is 120.
Sourcepub fn set_connection_timeout_seconds(self, input: Option<i32>) -> Self
pub fn set_connection_timeout_seconds(self, input: Option<i32>) -> Self
Length of time (in seconds) that Amazon GameLift Streams should wait for a client to connect or reconnect to the stream session. Applies to both connection and reconnection scenarios. This time span starts when the stream session reaches ACTIVE
state. If no client connects before the timeout, Amazon GameLift Streams terminates the stream session. Default value is 120.
Sourcepub fn get_connection_timeout_seconds(&self) -> &Option<i32>
pub fn get_connection_timeout_seconds(&self) -> &Option<i32>
Length of time (in seconds) that Amazon GameLift Streams should wait for a client to connect or reconnect to the stream session. Applies to both connection and reconnection scenarios. This time span starts when the stream session reaches ACTIVE
state. If no client connects before the timeout, Amazon GameLift Streams terminates the stream session. Default value is 120.
Sourcepub fn session_length_seconds(self, input: i32) -> Self
pub fn session_length_seconds(self, input: i32) -> Self
The maximum duration of a session. Amazon GameLift Streams will automatically terminate a session after this amount of time has elapsed, regardless of any existing client connections. Default value is 43200 (12 hours).
Sourcepub fn set_session_length_seconds(self, input: Option<i32>) -> Self
pub fn set_session_length_seconds(self, input: Option<i32>) -> Self
The maximum duration of a session. Amazon GameLift Streams will automatically terminate a session after this amount of time has elapsed, regardless of any existing client connections. Default value is 43200 (12 hours).
Sourcepub fn get_session_length_seconds(&self) -> &Option<i32>
pub fn get_session_length_seconds(&self) -> &Option<i32>
The maximum duration of a session. Amazon GameLift Streams will automatically terminate a session after this amount of time has elapsed, regardless of any existing client connections. Default value is 43200 (12 hours).
Sourcepub fn additional_launch_args(self, input: impl Into<String>) -> Self
pub fn additional_launch_args(self, input: impl Into<String>) -> Self
Appends an item to additional_launch_args
.
To override the contents of this collection use set_additional_launch_args
.
A list of CLI arguments that are sent to the streaming server when a stream session launches. You can use this to configure the application or stream session details. You can also provide custom arguments that Amazon GameLift Streams passes to your game client.
AdditionalEnvironmentVariables
and AdditionalLaunchArgs
have similar purposes. AdditionalEnvironmentVariables
passes data using environment variables; while AdditionalLaunchArgs
passes data using command-line arguments.
Sourcepub fn set_additional_launch_args(self, input: Option<Vec<String>>) -> Self
pub fn set_additional_launch_args(self, input: Option<Vec<String>>) -> Self
A list of CLI arguments that are sent to the streaming server when a stream session launches. You can use this to configure the application or stream session details. You can also provide custom arguments that Amazon GameLift Streams passes to your game client.
AdditionalEnvironmentVariables
and AdditionalLaunchArgs
have similar purposes. AdditionalEnvironmentVariables
passes data using environment variables; while AdditionalLaunchArgs
passes data using command-line arguments.
Sourcepub fn get_additional_launch_args(&self) -> &Option<Vec<String>>
pub fn get_additional_launch_args(&self) -> &Option<Vec<String>>
A list of CLI arguments that are sent to the streaming server when a stream session launches. You can use this to configure the application or stream session details. You can also provide custom arguments that Amazon GameLift Streams passes to your game client.
AdditionalEnvironmentVariables
and AdditionalLaunchArgs
have similar purposes. AdditionalEnvironmentVariables
passes data using environment variables; while AdditionalLaunchArgs
passes data using command-line arguments.
Sourcepub fn additional_environment_variables(
self,
k: impl Into<String>,
v: impl Into<String>,
) -> Self
pub fn additional_environment_variables( self, k: impl Into<String>, v: impl Into<String>, ) -> Self
Adds a key-value pair to additional_environment_variables
.
To override the contents of this collection use set_additional_environment_variables
.
A set of options that you can use to control the stream session runtime environment, expressed as a set of key-value pairs. You can use this to configure the application or stream session details. You can also provide custom environment variables that Amazon GameLift Streams passes to your game client.
If you want to debug your application with environment variables, we recommend that you do so in a local environment outside of Amazon GameLift Streams. For more information, refer to the Compatibility Guidance in the troubleshooting section of the Developer Guide.
AdditionalEnvironmentVariables
and AdditionalLaunchArgs
have similar purposes. AdditionalEnvironmentVariables
passes data using environment variables; while AdditionalLaunchArgs
passes data using command-line arguments.
Sourcepub fn set_additional_environment_variables(
self,
input: Option<HashMap<String, String>>,
) -> Self
pub fn set_additional_environment_variables( self, input: Option<HashMap<String, String>>, ) -> Self
A set of options that you can use to control the stream session runtime environment, expressed as a set of key-value pairs. You can use this to configure the application or stream session details. You can also provide custom environment variables that Amazon GameLift Streams passes to your game client.
If you want to debug your application with environment variables, we recommend that you do so in a local environment outside of Amazon GameLift Streams. For more information, refer to the Compatibility Guidance in the troubleshooting section of the Developer Guide.
AdditionalEnvironmentVariables
and AdditionalLaunchArgs
have similar purposes. AdditionalEnvironmentVariables
passes data using environment variables; while AdditionalLaunchArgs
passes data using command-line arguments.
Sourcepub fn get_additional_environment_variables(
&self,
) -> &Option<HashMap<String, String>>
pub fn get_additional_environment_variables( &self, ) -> &Option<HashMap<String, String>>
A set of options that you can use to control the stream session runtime environment, expressed as a set of key-value pairs. You can use this to configure the application or stream session details. You can also provide custom environment variables that Amazon GameLift Streams passes to your game client.
If you want to debug your application with environment variables, we recommend that you do so in a local environment outside of Amazon GameLift Streams. For more information, refer to the Compatibility Guidance in the troubleshooting section of the Developer Guide.
AdditionalEnvironmentVariables
and AdditionalLaunchArgs
have similar purposes. AdditionalEnvironmentVariables
passes data using environment variables; while AdditionalLaunchArgs
passes data using command-line arguments.
Sourcepub fn build(self) -> Result<StartStreamSessionInput, BuildError>
pub fn build(self) -> Result<StartStreamSessionInput, BuildError>
Consumes the builder and constructs a StartStreamSessionInput
.
Source§impl StartStreamSessionInputBuilder
impl StartStreamSessionInputBuilder
Sourcepub async fn send_with(
self,
client: &Client,
) -> Result<StartStreamSessionOutput, SdkError<StartStreamSessionError, HttpResponse>>
pub async fn send_with( self, client: &Client, ) -> Result<StartStreamSessionOutput, SdkError<StartStreamSessionError, HttpResponse>>
Sends a request with this input using the given client.
Trait Implementations§
Source§impl Clone for StartStreamSessionInputBuilder
impl Clone for StartStreamSessionInputBuilder
Source§fn clone(&self) -> StartStreamSessionInputBuilder
fn clone(&self) -> StartStreamSessionInputBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Default for StartStreamSessionInputBuilder
impl Default for StartStreamSessionInputBuilder
Source§fn default() -> StartStreamSessionInputBuilder
fn default() -> StartStreamSessionInputBuilder
Source§impl PartialEq for StartStreamSessionInputBuilder
impl PartialEq for StartStreamSessionInputBuilder
Source§fn eq(&self, other: &StartStreamSessionInputBuilder) -> bool
fn eq(&self, other: &StartStreamSessionInputBuilder) -> bool
self
and other
values to be equal, and is used by ==
.impl StructuralPartialEq for StartStreamSessionInputBuilder
Auto Trait Implementations§
impl Freeze for StartStreamSessionInputBuilder
impl RefUnwindSafe for StartStreamSessionInputBuilder
impl Send for StartStreamSessionInputBuilder
impl Sync for StartStreamSessionInputBuilder
impl Unpin for StartStreamSessionInputBuilder
impl UnwindSafe for StartStreamSessionInputBuilder
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);