प्लेटफ़ॉर्म SDK

<!-- Add this before your game's own code, in every game build -->
<script src="../_sdk/platform-sdk.js"></script>
<script>
  // gameId is read automatically from the page URL — nothing to hardcode.
  Platform.session.init().then(({ user, capabilities }) => {
    console.log('Playing as', user ? user.display_name : 'guest');
  });

  // ...your game runs, then when a round ends:
  const runId = Platform.scores.newRunId(); // hold this for the whole run
  Platform.scores.submit(1250, { durationSeconds: 42, runId }).then((result) => {
    if (result.accepted) console.log('New best?', result.best);
  });
</script>

// Nothing to write — this is automatic. Open your game's index.html
// directly (double-click the file, or any local dev server) and the SDK
// detects there's no platform host around it, then:
Platform.isStandalone; // true
// - Platform.session.init() resolves immediately with a local guest user
// - Platform.scores.submit() saves to THIS browser's localStorage only
// - achievements/missions/economy calls resolve honestly as unavailable
// The exact same file then works for real the moment it's embedded.

const { user, capabilities } = await Platform.session.init();
// user is null if the player isn't logged in, or if you're testing this
// file directly outside the platform (see "Standalone mode" below).
Platform.session.getConfig(); // { gameId, protocolVersion, standalone }

const user = await Platform.player.get();
// { id, display_name, avatar_url, level, xp, coins }

const runId = Platform.scores.newRunId();
const result = await Platform.scores.submit(score, { durationSeconds, runId });
// { accepted, scoreId?, reward?: { coins, xp }, reason? }
// Safe to retry with the SAME runId after a flaky network call —
// the server treats a repeated runId as the same submission, never
// double-credits coins/XP.

const rows = await Platform.leaderboard.get('daily'); // 'weekly'/'allTime' reserved
// [{ rank, user_id, display_name, avatar_url, score }, ...]

// Call this the moment you decide it's earned — as many times as you want.
// The server guarantees it's granted to a given player at most once.
Platform.achievements.unlock('no_hit_run');

Platform.missions.updateProgress('play_3_games', 1);

// Raw coin spend for an in-game perk (extra life, skip level, etc).
const result = await Platform.economy.spend(50, 'extra_life');
if (result.ok) grantExtraLife();

// Offline-first: writes go to localStorage instantly (your game never
// waits on a network round trip), and sync to the server in the background
// for a logged-in player. get() reads the local cache first, then refreshes
// it if the server has a newer value.
await Platform.storage.set('settings', { difficulty: 'hard' });
const settings = await Platform.storage.get('settings', { difficulty: 'normal' });

document.getElementById('fullscreenBtn').onclick = () => {
  Platform.ui.isFullscreen() ? Platform.ui.exitFullscreen() : Platform.ui.requestFullscreen();
};
Platform.ui.vibrate(40); // short haptic buzz, no-ops silently if unsupported

// One guard at the top of whatever plays a sound — that's the entire integration.
function beep(freq, dur) {
  if (Platform.audio.sfxMuted) return;
  // ...actually play the sound
}

// Or react live to changes (fires immediately with the current state, then on every change):
Platform.audio.onChange(({ sfxMuted, bgmMuted }) => {
  backgroundMusic.muted = bgmMuted;
});

// Only ever call this from a natural break point — game over, or an
// explicit "watch ad" button. Never mid-play.
const { shown } = await Platform.ads.showRewarded('extra_life');
if (shown) grantExtraLife();
// Today this always resolves { shown: false, reason: 'not_implemented' } —
// no ad network is wired in yet. Integrate the call now and it starts
// actually showing ads the day one is chosen, with no code changes on your end.

Platform.analytics.track('level_complete', { level: 4, timeSeconds: 96 });