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.
| Parameter | Type | Required | Description |
|---|
disableGameLobby | Boolean | No | Set 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/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?
- Request Received: Our gateway sees the disableGameLobby=true flag.
- URL Generation: We generate a signed URL that includes the internal routing instructions to bypass the lobby.
- 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 /generate-launch-url API for better security and
reliability.
