Platform (required)
The Platform module exposes host-platform data and lets the game report lifecycle events back to the host.
Implementation order
Required — Read
platform.languageand apply localization.Required — Send
platform.sendMessage('game_ready')when the first playable frame is ready.Required — On game start, check
platform.isAudioEnabledand mute the game if it isfalse. Also react to audio and pause state events to mute or pause the game when the user switches tabs or the platform requests it.Recommended — Send additional
sendMessagelifecycle events (level_started,level_completed, etc.).
Language
Returns the language selected by the user on the host platform. If the platform does not provide a language, Bridge falls back to the browser language.

If the platform provides user language data, this will be the language set by the user on the platform. If not, it will be the browser language.
Format: ISO 639-1. Example: ru, en.
Sending a Message to the Platform
Send lifecycle messages to the host platform. game_ready is required; the other messages help the platform understand gameplay state.
Add the PlaygamaBridge Send Message to Platform action and pick a message from the list (see the table below). Send Game Ready once the first playable frame is ready.
Add the Send Message action and pick a message from the list (see the table below). Send Game Ready once the first playable frame is ready.
To use constants for convenience:

game_ready
No parameters
The game has loaded, all loading screens have passed, the player can interact with the game.
in_game_loading_started
No parameters
Any loading within the game has started. For example, when a level is loading.
in_game_loading_stopped
No parameters
In-game loading has finished.
player_got_achievement
No parameters
The player reached a significant moment. For example, defeating a boss, setting a record, etc.
level_started
optional "world" and "level", example:
{"world":"desert","level":"1"}
Gameplay has started. For example, the player has entered a level from the main menu.
level_completed
optional "world" and "level", example:
{"world":"desert","level":"1"}
Gameplay has completed. For example, the player won level.
level_failed
optional "world" and "level", example:
{"world":"desert","level":"1"}
Gameplay has failed. For example, the player lost level.
level_paused
optional "world" and "level", example:
{"world":"desert","level":"1"}
Gameplay has paused. Opened settings menu or used pause button
level_resumed
optional "world" and "level", example:
{"world":"desert","level":"1"}
Gameplay has resumed. Returned from settings menu or hit unpause button
Sending a Custom Message
Sends a message with an id of your own, for game events the built-in list does not cover — shop_opened, boss_defeated, settings_closed. Bridge treats it like a built-in message:
the message is recorded in Bridge analytics under its id;
it triggers the matching Advanced Banners placement, if the config declares one;
it shows an interstitial when the id is listed in
advertisement.interstitial.autoShowin the config.
This is what makes banners and interstitials follow your own game flow without extra show/hide calls.
Add the PlaygamaBridge Send Custom Message to Platform action and type your own id.
Add the Send Custom Message action and type your own id.
Use the send custom message [id] to platform with data [data] block and leave data empty — the field is not forwarded anywhere.
Is Audio Enabled
Returns whether the host platform currently allows game audio.
On game start, check the Is Platform Audio Enabled condition and mute the game if it is false. React to later changes with the On Platform Audio State Changed trigger condition (re-check Is Platform Audio Enabled inside it).
On game start, check the Platform Is Audio Enabled condition and mute the game if it is false. React to later changes with the Platform On Audio State Changed trigger condition (re-check Platform Is Audio Enabled inside it).

Pause
Listen for host pause/resume requests. Pause gameplay, timers, and audio while isPaused is true.
React to host pause/resume with the On Platform Pause State Changed trigger condition, and read the current state with the Is Platform Paused condition. Pause gameplay, timers, and audio while paused.
React to host pause/resume with the Platform On Pause State Changed trigger condition, and read the current state with the Platform Is Paused condition. Pause gameplay, timers, and audio while paused.

Platform ID

Returns the ID of the platform on which the game is currently running.
URL Parameter
Read optional launch data passed through the platform URL. Use it for referral codes, deep links, invited-user context, or other launch parameters.

The payload works only on platforms that pass it into the game URL. The exact URL format is platform-specific:
Playgama
playgama.com/game/game_name?payload=your-info
VK
http://vk.com/game_id#your-info
Yandex
http://yandex.com/games/app/game_id?payload=your-info
Crazy Games
crazygames.com/game/game_name?payload=your-info
On any other platform there is no way to pass the payload through the URL, so the value is null.
Launch Source
Tells where the game was opened from: notification for a scheduled notification, post for one of the game's own posts. It is null on an ordinary launch, which is the common case — treat anything else as a bonus path, never as a requirement.
Launch Data
Everything the launch carries, as key-value pairs: the parameters the platform passed to the game, plus postId — the id of the social.posts entry the post was created from — when the game was opened from a post. Together with payload this is what lets a game restore what was shared: the entry says which kind of post it is, the payload carries the level, seed or challenge itself.
PlaygamaBridge.PlatformDataAsJSON returns everything at once.
PlaygamaBridge::PlatformDataAsJSON() returns everything at once.
Server Time
Returns trusted UTC server time. Use it for daily rewards, cooldowns, or time-limited offers where local device time is not reliable.
In the event sheet:
On a trigger (e.g. Button → On clicked), add the Get Server Time action.
Add the On Get Server Time Completed condition. Inside it, check Has Server Time and read the
PlaygamaBridge.ServerTimeexpression (UTC time in milliseconds).
In the events sheet:
On a trigger (e.g. Button is clicked), add the Get Server Time action.
Add the On Get Server Time Completed condition. Inside it, check Has Server Time and read the
PlaygamaBridge::ServerTime()expression (UTC time in milliseconds).
Native SDK
Returns the original platform SDK object when Bridge exposes it. Use it only for platform-specific features that Bridge does not wrap.
Domain Information
Returns the platform top-level domain when the host provides it. Use it for regional links, legal text, or domain-specific configuration.

Returns null when no data is available; otherwise returns a TLD such as com or ru.
Is External Calls Supported
Returns whether the platform environment allows the game to make external HTTP requests (your own backend, third-party services). Some platforms run games in a sandbox that blocks outgoing requests — check this flag before relying on any external service.
Use the PlaygamaBridge condition Is Platform External Calls Supported.
Use the PlaygamaBridge condition Is External Calls Supported.
Is External Links Allowed
Returns whether the platform allows opening external links from the game. Hide buttons that lead outside the platform (your socials, other stores) when this is false.
Use the PlaygamaBridge Is External Links Allowed condition. Hide buttons that lead outside the platform when it is false.
Use the PlaygamaBridge Is External Links Allowed condition. Hide buttons that lead outside the platform when it is false.
Last updated