Interface IHostSession
A host's mutable handle on a session.
Inherited Members
Namespace: Unity.Services.Multiplayer
Syntax
public interface IHostSession : ISessionProperties
Host
ID of the session host.
Declaration
string Host { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |
Remarks
Host migration is NOT supported on Multiplay Game Server Hosting server builds.
Exceptions
| Type | Condition |
|---|---|
| SessionException | Thrown when attempting to change the value on a Multiplay Game Server Hosting server build. The Error property will be set to InvalidPlatformOperation. |
IsLocked
Whether the session is locked
Declaration
bool IsLocked { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
IsPrivate
Whether the session is private
Declaration
bool IsPrivate { get; set; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Name
The Name of the session.
Declaration
string Name { get; set; }Property Value
| Type | Description |
|---|---|
| System.String |
Password
The password used to connect to the Session.
Declaration
string Password { set; }Property Value
| Type | Description |
|---|---|
| System.String |
Players
The list of players in the session
Declaration
IReadOnlyList<IPlayer> Players { get; }Property Value
| Type | Description |
|---|---|
| System.Collections.Generic.IReadOnlyList<IPlayer> |
Methods
DeleteAsync()
Delete the session.
Declaration
Task DeleteAsync()Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task | A System.Threading.Tasks.Task representing the asynchronous operation. |
RemovePlayerAsync(String)
Removes a player from the session.
Declaration
Task RemovePlayerAsync(string playerId)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | playerId | Identifier for the player to remove. |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task | A task for the operation. |
SavePlayerDataAsync(String)
Save the updated properties of a player.
Declaration
Task SavePlayerDataAsync(string playerId)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | playerId | The ID of the player whose data will be saved. |
Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task | A System.Threading.Tasks.Task representing the asynchronous operation. |
Exceptions
| Type | Condition |
|---|---|
| SessionException | Thrown when the player does is not found. The Error property will be set to InvalidOperation. |
SavePropertiesAsync()
Saves the property changes of the session.
Declaration
Task SavePropertiesAsync()Returns
| Type | Description |
|---|---|
| System.Threading.Tasks.Task | A task for the operation. |
SetProperties(Dictionary<String, SessionProperty>)
Set properties.
Declaration
void SetProperties(Dictionary<string, SessionProperty> properties)Parameters
| Type | Name | Description |
|---|---|---|
| System.Collections.Generic.Dictionary<System.String, SessionProperty> | properties | The SessionProperty to be set on the session. |
Remarks
Passing null to SetProperty removes the property from the session.
However passing a SessionProperty with a null value (new SessionProperty(null)) keeps the session property and sets its value to null.
SetProperty(String, SessionProperty)
Set a property.
Declaration
void SetProperty(string key, SessionProperty property)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | key | The SessionProperty's key to bet set on the session. |
| SessionProperty | property | The SessionProperty's value. |
Remarks
Passing null to SetProperty removes the property from the session.
However passing a SessionProperty with a null value (new SessionProperty(null)) keeps the session property and sets its value to null.