This function is part of the Lobby Interface.
Creates a lobby and adds the user to the lobby membership. There is no data associated with the lobby at the start and can be added vis {UpdateLobbyModification}
If the lobby is successfully created with an RTC Room enabled, the lobby system will automatically join and maintain the connection to the RTC room as long as the
local user remains in the lobby. Applications can use the {GetRTCRoomName} to get the name of the RTC Room associated with a lobby, which may be used with
suite of functions. This can be useful to: register for notifications for talking status; to mute or unmute the local user's audio output;
to block or unblock room participants; to set local audio device settings; and more.
{Result.InvalidParameters} if any of the options are incorrect
{Result.LimitExceeded} if the number of allowed lobbies is exceeded
Return Value
{Result.Success} if the creation completes successfully
Parameters
Lobby.LobbyInterface.CreateLobby
Parameter Type And Name
|
Usage Information
|
CreateLobbyOptions options
|
Required fields for the creation of a lobby such as a user count and its starting advertised state
|
object clientData
|
Arbitrary data that is passed back to you in the CompletionDelegate
|
OnCreateLobbyCallback completionDelegate
|
A callback that is fired when the create operation completes, either successfully or in error
|
This function is asynchronous; the EOS SDK guarantees that your callback (the CompletionDelegate
parameter) will run when the operation completes, regardless of whether it succeeds or fails. Use the object
parameter to pass any contextual information the callback may need in order to react properly. Relevant information can be copied from the EOS SDK's cache while the callback function is running. You do not need to remove the callback function.
Because this function is asynchronous, it employs a callback of type Lobby.OnCreateLobbyCallback to report the results of its operation.
Function prototype definition for callbacks passed to {LobbyInterface.CreateLobby}
Callback Parameters
Lobby.OnCreateLobbyCallback
Parameter Type And Name
|
Usage Information
|
CreateLobbyCallbackInfo data
|
A EOS_Lobby_CreateLobby CallbackInfo containing the output information and result
|