AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Enables clients to reconnect to a stream session while preserving all session state
and data in the disconnected session. This reconnection process can be initiated when
a stream session is in either PENDING_CLIENT_RECONNECTION or ACTIVE
status. The process works as follows:
Initial disconnect:
When a client disconnects or loses connection, the stream session transitions from
CONNECTED to PENDING_CLIENT_RECONNECTION
Reconnection time window:
Clients have ConnectionTimeoutSeconds (defined in StartStreamSession)
to reconnect before session termination
Your backend server must call CreateStreamSessionConnection to initiate reconnection
Session transitions to RECONNECTING status
Reconnection completion:
On successful CreateStreamSessionConnection, session status changes to ACTIVE
Provide the new connection information to the requesting client
Client must establish connection within ConnectionTimeoutSeconds
Session terminates automatically if client fails to connect in time
For more information about the stream session lifecycle, see Stream sessions in the Amazon GameLift Streams Developer Guide.
To begin re-connecting to an existing stream session, specify the stream group ID and stream session ID that you want to reconnect to, and the signal request to use with the stream.
For .NET Core this operation is only available in asynchronous form. Please refer to CreateStreamSessionConnectionAsync.
Namespace: Amazon.GameLiftStreams
Assembly: AWSSDK.GameLiftStreams.dll
Version: 3.x.y.z
public abstract CreateStreamSessionConnectionResponse CreateStreamSessionConnection( CreateStreamSessionConnectionRequest request )
Container for the necessary parameters to execute the CreateStreamSessionConnection service method.
| Exception | Condition |
|---|---|
| AccessDeniedException | You don't have the required permissions to access this Amazon GameLift Streams resource. Correct the permissions before you try again. |
| ConflictException | The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request. |
| InternalServerException | The service encountered an internal error and is unable to complete the request. |
| ResourceNotFoundException | The resource specified in the request was not found. Correct the request before you try again. |
| ThrottlingException | The request was denied due to request throttling. Retry the request after the suggested wait time. |
| ValidationException | One or more parameter values in the request fail to satisfy the specified constraints. Correct the invalid parameter values before retrying the request. |
.NET Framework:
Supported in: 4.7.2 and newer