v1.0.0
Latest
2022.3+

Class UpdateRequest

The body of an Update Lobby request.

Inheritance
System.Object
UpdateRequest
Inherited Members
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Unity.Services.Lobbies.Models
Syntax
public class UpdateRequest

Constructors

UpdateRequest(String, Nullable<Int32>, Nullable<Boolean>, Nullable<Boolean>, Dictionary<String, DataObject>, String, String)

The body of an Update Lobby request.

Declaration
public UpdateRequest(string name = null, int? maxPlayers = null, bool? isPrivate = null, bool? isLocked = null, Dictionary<string, DataObject> data = null, string hostId = null, string password = null)
Parameters
TypeNameDescription
System.Stringname

The name of the lobby that should be displayed to users. All whitespace will be trimmed from the name.

System.Nullable<System.Int32>maxPlayers

The maximum number of players that can be members of the lobby. Must be greater than or equal to the current number of players in the lobby.

System.Nullable<System.Boolean>isPrivate

Whether or not the lobby is private. Private lobbies do not appear in query results and cannot be fetched by non-members using the GetLobby API. If the lobby is not publicly visible, the creator can share the lobbyCode with other users who can use it to join this lobby.

System.Nullable<System.Boolean>isLocked

Whether or not the lobby is locked. If true, new players will not be able to join.

System.Collections.Generic.Dictionary<System.String, DataObject>data

Custom game-specific properties to add, update, or remove from the lobby (e.g. mapName or gameType). To remove an existing property, include it in data but set the property object to null. To update the value to null, set the value property of the object to null.

System.StringhostId

The ID of the player to make the host of the lobby. As soon as this is updated, the current host will no longer have permission to modify the lobby.

System.Stringpassword

Updates the password for this lobby. If previously unspecified, HasPassword set to true. If becoming null, HasPassword will be set to false. All future joins will be rejected unless provided password matches.

Properties

Data

Custom game-specific properties to add, update, or remove from the lobby (e.g. mapName or gameType). To remove an existing property, include it in data but set the property object to null. To update the value to null, set the value property of the object to null.

Declaration
public JsonObject Data { get; }
Property Value
TypeDescription
JsonObject

HostId

The ID of the player to make the host of the lobby. As soon as this is updated, the current host will no longer have permission to modify the lobby.

Declaration
public string HostId { get; }
Property Value
TypeDescription
System.String

IsLocked

Whether or not the lobby is locked. If true, new players will not be able to join.

Declaration
public bool? IsLocked { get; }
Property Value
TypeDescription
System.Nullable<System.Boolean>

IsPrivate

Whether or not the lobby is private. Private lobbies do not appear in query results and cannot be fetched by non-members using the GetLobby API. If the lobby is not publicly visible, the creator can share the lobbyCode with other users who can use it to join this lobby.

Declaration
public bool? IsPrivate { get; }
Property Value
TypeDescription
System.Nullable<System.Boolean>

MaxPlayers

The maximum number of players that can be members of the lobby. Must be greater than or equal to the current number of players in the lobby.

Declaration
public int? MaxPlayers { get; }
Property Value
TypeDescription
System.Nullable<System.Int32>

Name

The name of the lobby that should be displayed to users. All whitespace will be trimmed from the name.

Declaration
public string Name { get; }
Property Value
TypeDescription
System.String

Password

Updates the password for this lobby. If previously unspecified, HasPassword set to true. If becoming null, HasPassword will be set to false. All future joins will be rejected unless provided password matches.

Declaration
public string Password { get; }
Property Value
TypeDescription
System.String