Preskoči na sadržaj
kružić podrška

Game SDK — Uvod

Game SDK povezuje vašu igru sa kružić platformom. Nije obavezan — igra radi i bez njega.

Šta dobijate:

  • Čuvanje podataka — napredak, rezultati, podešavanja igrača
  • Autentifikacija — saznajte da li je igrač prijavljen i ko je
  • Sinhronizacija — podaci prate korisnika između web-a i mobilne aplikacije
  • Rang liste — automatske, za svako brojčano polje koje definišete

Kako radi

Igra se izvršava u izolovanom okruženju — iframe na webu, WebView na mobilnom. SDK komunicira sa platformom kroz postMessage u pozadini, a vi radite sa običnim async pozivima:

import { KruzicClient } from '@kruzic/game-sdk/client';


const sdk = new KruzicClient();
sdk.ready();


const signedIn = await sdk.isSignedIn();
await sdk.setData('highscore', 1500);
const score = await sdk.getData('highscore');

Gde se čuvaju podaci

Prijavljenim korisnicima podaci idu na server i dostupni su sa svakog uređaja. Neprijavljeni igrači dobijaju localStorage — podaci ostaju samo na tom uređaju.

Klijent vs. server

PaketKada ga koristite
@kruzic/game-sdk/clientU samoj igri, u browseru
@kruzic/game-sdk/serverNa vašem backend-u (Node.js) — za validaciju, anti-cheat, automatizaciju

Većina igara treba samo klijentski deo.

Polja podataka

Kroz kontrolnu tablu možete definisati polja podataka koja daju dodatnu kontrolu nad time šta se čuva:

  • Prava pristupa — ograničite da li klijent sme da čita ili piše
  • Rang liste — uključite za bilo koje brojčano polje
  • Best score — platforma automatski čuva samo bolji rezultat

Polja su opciona. setData i getData rade i bez definisanih polja.

Uključivanje

Otvorite igru u kontrolnoj tabli, pa idite na SDK → Pregled i uključite Game SDK.

Ili iz terminala: kruzic sdk enable

Dalje