Interface ILobbyService

Service for Lobbies. Provides user the ability to create, delete, update, and query Lobbies. Includes operations for interacting with given players in a Lobby context.

Namespace: Unity.Services.Lobbies

Assembly: solution.dll

Syntax

public interface ILobbyService

Properties

ConcurrencyControlEnabled

Applies concurrency control by adding an If-match header with the latest version of the lobby to applicable lobby operations.
When enabled, operations are only allowed if the latest version matches the current version on the server.
Applies to the following operations:
• Deleting a lobby
• Removing a player from a lobby
• Updating a lobby information
• Updating a lobby player

Declaration

bool ConcurrencyControlEnabled { get; set; }

Property Value

Type	Description
bool

Methods

CreateLobbyAsync(string, int, CreateLobbyOptions)

Create a Lobby with a given name and specified player limit. Async operation.

Declaration

Task<Lobby> CreateLobbyAsync(string lobbyName, int maxPlayers, CreateLobbyOptions options = null)

Parameters

Type	Name	Description
string	lobbyName	Name of new lobby.
int	maxPlayers	Player limit.
CreateLobbyOptions	options	Optional request parameters.

Returns

Type	Description
Task<Lobby>	Lobby data for the lobby that was just created.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

CreateOrJoinLobbyAsync(string, string, int, CreateLobbyOptions)

Create or join a Lobby with a given name and ID and specified player limit. Async operation.

Declaration

Task<Lobby> CreateOrJoinLobbyAsync(string lobbyId, string lobbyName, int maxPlayers, CreateLobbyOptions options = null)

Parameters

Type	Name	Description
string	lobbyId	ID of the lobby to create/join.
string	lobbyName	Name of the lobby to create/join.
int	maxPlayers	Player limit.
CreateLobbyOptions	options	Optional request parameters.

Returns

Type	Description
Task<Lobby>	Lobby data for the lobby that was just created/joined.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

DeleteLobbyAsync(string)

Deletes a lobby specified by its ID.

Declaration

Task DeleteLobbyAsync(string lobbyId)

Parameters

Type	Name	Description
string	lobbyId	The ID of the lobby to delete. Cannot be null, empty, or whitespace.

Returns

Type	Description
Task	A task representing the asynchronous delete operation.

Remarks

If ConcurrencyControlEnabled is enabled, an If-Match header with the latest lobby version will be sent and the deletion will only succeed if the server version matches.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

See Also

ConcurrencyControlEnabled

DownloadMigrationDataAsync(MigrationDataInfo, LobbyDownloadMigrationDataOptions)

Download lobby migration data.

Declaration

Task<LobbyMigrationData> DownloadMigrationDataAsync(MigrationDataInfo migrationDataInfo, LobbyDownloadMigrationDataOptions options)

Parameters

Type	Name	Description
MigrationDataInfo	migrationDataInfo	Is the lobby migration data information.
LobbyDownloadMigrationDataOptions	options	Is the migration Data download request Parameters.

Returns

Type	Description
Task<LobbyMigrationData>	Task for MigrationData. Data is null if not present.

Remarks

This task is not cancellable. Timeout can be configured in DownloadMigrationDataOptions.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error. MigrationDataRequestTimeout in case of request timeout.

GetJoinedLobbiesAsync()

Async Operation. Get currently joined lobbies.

Declaration

Task<List<string>> GetJoinedLobbiesAsync()

Returns

Type	Description
Task<List<string>>	List of lobbies the active player has joined.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

GetLobbyAsync(string)

Retrieve data for a Lobby by specifying a Lobby ID. Async operation.

Declaration

Task<Lobby> GetLobbyAsync(string lobbyId)

Parameters

Type	Name	Description
string	lobbyId	ID of the Lobby to retrieve.

Returns

Type	Description
Task<Lobby>	Lobby data.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

See Also

https://services.docs.unity.com/lobby/v1/#tag/Lobby/operation/getLobby

GetLobbyAsync(string, string)

Retrieve data for a Lobby by specifying a Lobby ID. Async operation.

Declaration

Task<Lobby> GetLobbyAsync(string lobbyId, string ifNoneMatchVersion)

Parameters

Type	Name	Description
string	lobbyId	ID of the Lobby to retrieve.
string	ifNoneMatchVersion	If provided, the version will be submitted in the If-None-Match header.

Returns

Type	Description
Task<Lobby>	Lobby data.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

See Also

https://services.docs.unity.com/lobby/v1/#tag/Lobby/operation/getLobby

GetMigrationDataInfoAsync(string)

Get lobby migration data information.

Declaration

Task<MigrationDataInfo> GetMigrationDataInfoAsync(string lobbyId)

Parameters

Type	Name	Description
string	lobbyId	The ID of the lobby to get migration data information.

Returns

Type	Description
Task<MigrationDataInfo>	The migration data information for the lobby.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

JoinLobbyByCodeAsync(string, JoinLobbyByCodeOptions)

Join a Lobby using a given Lobby Invite Code. Async operation.

Declaration

Task<Lobby> JoinLobbyByCodeAsync(string lobbyCode, JoinLobbyByCodeOptions options = null)

Parameters

Type	Name	Description
string	lobbyCode	Invite Code for target lobby.
JoinLobbyByCodeOptions	options	Optional request parameters.

Returns

Type	Description
Task<Lobby>	Lobby data for the lobby joined.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

JoinLobbyByIdAsync(string, JoinLobbyByIdOptions)

Join a Lobby by specifying the Lobby ID. Async operation.

Declaration

Task<Lobby> JoinLobbyByIdAsync(string lobbyId, JoinLobbyByIdOptions options = null)

Parameters

Type	Name	Description
string	lobbyId	ID of the Lobby to join.
JoinLobbyByIdOptions	options	Optional request parameters.

Returns

Type	Description
Task<Lobby>	Lobby data for the lobby joined.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

QueryLobbiesAsync(QueryLobbiesOptions)

Query and retrieve a list of lobbies that meet specified query parameters. Async operation.

Declaration

Task<QueryResponse> QueryLobbiesAsync(QueryLobbiesOptions options = null)

Parameters

Type	Name	Description
QueryLobbiesOptions	options	Query parameters.

Returns

Type	Description
Task<QueryResponse>	Query response that includes list of Lobbies meeting specified parameters.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

QuickJoinLobbyAsync(QuickJoinLobbyOptions)

Query available lobbies and join a randomly selected instance. Async operation.

Declaration

Task<Lobby> QuickJoinLobbyAsync(QuickJoinLobbyOptions options = null)

Parameters

Type	Name	Description
QuickJoinLobbyOptions	options	Optional parameters (includes queryable arguments).

Returns

Type	Description
Task<Lobby>	Lobby data for the lobby joined.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

ReconnectToLobbyAsync(string)

Reconnects to the lobby.

Declaration

Task<Lobby> ReconnectToLobbyAsync(string lobbyId)

Parameters

Type	Name	Description
string	lobbyId	The ID of the lobby to reconnect to.

Returns

Type	Description
Task<Lobby>	The lobby you reconnected to.

RemovePlayerAsync(string, string)

Removes a player from the specified lobby.

Declaration

Task RemovePlayerAsync(string lobbyId, string playerId)

Parameters

Type	Name	Description
string	lobbyId	The target lobby's ID. Cannot be null, empty, or consist only of whitespace.
string	playerId	The player ID to remove. Cannot be null, empty, or consist only of whitespace.

Returns

Type	Description
Task	A task representing the asynchronous remove operation.

Remarks

If ConcurrencyControlEnabled is enabled, an If-Match header with the latest lobby version will be sent and the removal will only succeed if the server version matches.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

See Also

ConcurrencyControlEnabled

SendHeartbeatPingAsync(string)

Send a heartbeat ping to keep the Lobby active. Async operation.

Declaration

Task SendHeartbeatPingAsync(string lobbyId)

Parameters

Type	Name	Description
string	lobbyId	ID of the Lobby to ping.

Returns

Type	Description
Task	Awaitable task.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

SubscribeToLobbyEventsAsync(string, LobbyEventCallbacks)

A subscription to the given lobby is created and the given callbacks are associated with it. The return ILobbyEvents interface can be used to unsubscribe and re-subscribe to the connection. The callbacks object provided will be used to provide the notifications from the subscription.

Declaration

Task<ILobbyEvents> SubscribeToLobbyEventsAsync(string lobbyId, LobbyEventCallbacks callbacks)

Parameters

Type	Name	Description
string	lobbyId	The ID of the lobby you are subscribing to events for.
LobbyEventCallbacks	callbacks	The callbacks you provide, which will be called as notifications arrive from the subscription.

Returns

Type	Description
Task<ILobbyEvents>	An interface to change the callbacks associated with the subscription, or to unsubscribe and re-subscribe to the lobby's events.

UpdateLobbyAsync(string, UpdateLobbyOptions)

Updates the specified lobby's properties using the provided options.

Declaration

Task<Lobby> UpdateLobbyAsync(string lobbyId, UpdateLobbyOptions options)

Parameters

Type	Name	Description
string	lobbyId	The ID of the lobby to update. Cannot be null, empty, or whitespace.
UpdateLobbyOptions	options	Options describing which lobby fields to update. Cannot be null.

Returns

Type	Description
Task<Lobby>	A task that resolves to the updated Lobby.

Remarks

When ConcurrencyControlEnabled is enabled, an If-Match header with the latest lobby version will be sent. The update will only succeed if the server version matches the provided version.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

See Also

ConcurrencyControlEnabled

UpdatePlayerAsync(string, string, UpdatePlayerOptions)

Updates the specified player's lobby-associated data using the provided options.

Declaration

Task<Lobby> UpdatePlayerAsync(string lobbyId, string playerId, UpdatePlayerOptions options)

Parameters

Type	Name	Description
string	lobbyId	The ID of the lobby that contains the player. Cannot be null, empty, or whitespace.
string	playerId	The ID of the player to update. Cannot be null, empty, or whitespace.
UpdatePlayerOptions	options	Options describing which player fields to update. Cannot be null.

Returns

Type	Description
Task<Lobby>	A task that resolves to the updated Lobby.

Remarks

When ConcurrencyControlEnabled is enabled, an If-Match header with the latest lobby version will be sent. The update will only succeed if the server version matches the provided version.
For the modern, streamlined workflow see here.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.

See Also

ConcurrencyControlEnabled

UploadMigrationDataAsync(MigrationDataInfo, byte[], LobbyUploadMigrationDataOptions)

Upload lobby migration data.

Declaration

Task<LobbyUploadMigrationDataResults> UploadMigrationDataAsync(MigrationDataInfo migrationDataInfo, byte[] data, LobbyUploadMigrationDataOptions options)

Parameters

Type	Name	Description
MigrationDataInfo	migrationDataInfo	Is the lobby migration data information.
byte[]	data	Is the binary migration data.
LobbyUploadMigrationDataOptions	options	Is the migration data download request Parameters.

Returns

Type	Description
Task<LobbyUploadMigrationDataResults>	Task for LobbyUploadMigrationDataResults.

Remarks

This task is not cancellable. Timeout can be configured in DownloadMigrationDataOptions.

Exceptions

Type	Condition
LobbyServiceException	Thrown when the lobby service returns an error.The LobbyExceptionReason property reflects the error. MigrationDataRequestTimeout in case of request timeout.