Skip to main content
By default, our launch URLs may load a game lobby that allows players to browse our portfolio. If you have built your own custom lobby on your website, you likely want to bypass ours and send the player directly into a specific game.

​
The Modern Approach

You no longer need to append complex options strings to the final URL. Instead, you simply tell our API your preference when requesting the launch link.

​
How to use the disableGameLobby Parameter

When calling the /generate-launch-url endpoint, include disableGameLobby as a query parameter.
ParameterTypeRequiredDescription
disableGameLobbyBooleanNoSet to true to skip the lobby. Defaults to false.

​
Example Request

Include the flag in your server-side API call: 
curl --request GET \
 --url 'https://api.smatvirtual.com/api/v1.1/operator-api/games/generate-launch-url?gameId=odd-even&playerId=user123&sessionId=sess999&disableGameLobby=true' \
 --header 'sv-api-key: SV.pk_live_12345.smatvirtual-us'

​
What Happens Next?

  1. Request Received: Our gateway sees the disableGameLobby=true flag.
  2. URL Generation: We generate a signed URL that includes the internal routing instructions to bypass the lobby.
  3. Seamless Transition: When the player is redirected to the returned URL, the game loads instantly without showing the smatvirtual selection screen.

​
Deprecation Notice

The previous method of appending options=$ {encodeURIComponent(JSON.stringify({ disableGameLobby: true }))} manually to the final game URL is now deprecated. Please update your integration to pass this flag directly to the /games/generate-launch-url API for better security and reliability.

Tournament-Specific Launches

Our flagship Tournament engine handles lobby states differently. Click here to see how to deep-link players into specific tournament leaderboards.