BalkTalk

Za developere

Igre i katalog

Javna aplikacija sa adresom okvira se otvara na samom BalkTalku. Član je već prijavljen, pa prijava ide bez preusmjeravanja, kroz mali SDK.

Kako radi

  1. U portalu upiši adresu okvira (https). To je stranica tvoje igre koja se otvara u okviru na stranici aplikacije u katalogu.
  2. Na tu stranicu dodaj SDK:
<script src="https://www.balktalk.net/sdk/v1.js"></script>
  1. Prijavi člana i zovi API:
await BalkTalk.ready()

const session = await BalkTalk.authorize({
  clientId: 'TVOJ_CLIENT_ID',
  scopes: ['scores', 'activity'],
})

const me = await BalkTalk.api('/me')
console.log('Igra', me.data.display_name)

Prvi put BalkTalk pita člana za pristanak u svom prozoru. Sljedeći put authorize odmah vrati token.

SDK

Poziv Šta radi
BalkTalk.isEmbedded() true kad aplikacija radi u okviru na BalkTalku
BalkTalk.ready() javi da je aplikacija učitana; vraća { locale, theme, app }
BalkTalk.authorize({ clientId, scopes }) prijava bez preusmjeravanja (PKCE); vraća { accessToken, expiresAt, scopes }
BalkTalk.requestCode({ scopes, codeChallenge }) samo kod prijave, za aplikaciju koja ga mijenja za token na svom serveru
BalkTalk.api(path, { method, body }) poziv javnog API-ja; token se obnavlja sam
BalkTalk.share({ text }) prozor za objavu na Mreži sa tvojim tekstom (dozvola share)
BalkTalk.close() zatvori okvir

Greške su Error sa poljem code: access_denied (član je odbio), insufficient_scope, not_embedded (aplikacija nije u okviru), timeout, te kodovi javnog API-ja.

Token živi samo u memoriji stranice. Ne spremaj ga u localStorage.

Aplikacija sa serverom

Ako kod mijenjaš za token na svom serveru (tajni ključ), u pregledniku uzmi samo kod:

const { code, redirectUri } = await BalkTalk.requestCode({
  scopes: ['scores'],
  codeChallenge: IZAZOV_SA_TVOG_SERVERA,
})
// pošalji code svom serveru; on zove https://www.balktalk.net/oauth/token sa redirect_uri = redirectUri

redirect_uri je u ovom toku uvijek tvoja adresa okvira. Ne moraš je upisivati među povratne adrese.

Rang liste

Rang liste praviš u portalu (najviše 5 po aplikaciji). Svaka ima ključ, redoslijed (veći ili manji rezultat je bolji) i prikaz (broj ili vrijeme u milisekundama).

const result = await BalkTalk.api('/boards/glavna/scores/me', {
  method: 'PUT',
  body: { score: 1200 },
})
if (result.improved) showNewRecord(result.data.rank)

const top = await BalkTalk.api('/boards/glavna/scores?limit=10')

Čuva se samo najbolji rezultat člana. Rang lista se vidi i na stranici tvoje aplikacije u katalogu.

Rezultat šalje tvoja aplikacija i BalkTalk ga ne može provjeriti. Ako ti je poredak važan, rezultat računaj i šalji sa svog servera, ne iz preglednika.

„Igra …” u razgovorima

Dok je okvir otvoren, BalkTalk sam prikazuje da član koristi tvoju aplikaciju. Ako aplikacija radi na tvom sajtu, javljaj se sama jednom u minuti (dozvola activity):

await BalkTalk.api('/activity', { method: 'POST' })

Ko to vidi određuje član u svojim postavkama (Online status → Radio i igre).

Okvir

  • Okvir je izolovan: nema pristup stranici BalkTalka, kolačićima ni sesiji člana. Sve ide kroz SDK i javni API.
  • Aplikacija ne može preusmjeriti cijelu stranicu ni otvarati nove prozore. Kamera, mikrofon i lokacija nisu dostupni.
  • Dozvoljeni su cijeli ekran, zvuk i kontroler za igre.
  • Okvir zauzima širinu stranice. Napravi igru da radi od 320 px širine naviše i na dodir.
  • Adresa okvira mora biti https. Dok razvijaš može http://localhost, a takvu aplikaciju vide samo ti i testeri.
  • Neki preglednici za http://localhost u okviru traže dozvolu za pristup lokalnoj mreži ili ga blokiraju. Ako se okvir ne učita, igru dok razvijaš stavi na https adresu (npr. kroz tunel).

Aplikacija na svom sajtu

Aplikacija bez adrese okvira je u katalogu sa linkom na svoj sajt. Tamo koristi običnu prijavu preko BalkTalka.

Neophodni kolačići drže sajt u radu. Uz tvoj pristanak koristimo i dodatne (npr. analitiku) - izbor možeš promijeniti bilo kada. Politika kolačića

Neophodni kolačići drže sajt u radu. Uz tvoj pristanak koristimo i dodatne (npr. analitiku) - izbor možeš promijeniti bilo kada. Politika kolačića

Neophodni

Uvijek aktivno

Bez njih sajt ne radi: prijava, sigurnost, jezik i tvoji izbori. Ne traže pristanak i ne koriste se za praćenje.

  • bt_session kolačić · 30 dana

    Sesija: drži te prijavljenim dok koristiš sajt.

    BalkTalk

  • XSRF-TOKEN kolačić · 30 dana

    Zaštita formulara od lažnih zahtjeva (CSRF).

    BalkTalk

  • remember_web_* kolačić · 13 mjeseci

    „Zapamti me”: prijava ostaje i poslije zatvaranja preglednika.

    BalkTalk

  • bt_locale kolačić · 12 mjeseci

    Jezik koji si izabrao.

    BalkTalk

  • bt_2fa_device kolačić · 30 dana

    Dvostepena prijava: ovaj uređaj ne traži kod 30 dana (kad izabereš „Zapamti ovaj uređaj”).

    BalkTalk

  • bt_consent kolačić · 12 mjeseci

    Tvoj izbor o kolačićima (da te ne pitamo ponovo).

    BalkTalk

  • bt-*, bt:* localStorage · dok ga ne obrišeš

    Lokalna memorija preglednika: tema, jezik, radio stanica, nedavni emojiji, raspored chata, sakrivene napomene.

    BalkTalk

  • bt_invite kolačić · 30 dana

    Ko te pozvao na BalkTalk (link pozivnice) – da oboje dobijete nagradu kad postaneš aktivan član.

    BalkTalk

  • Cloudflare Turnstile servis

    Provjera „Nisi robot” na registraciji (challenges.cloudflare.com) - štiti sajt od lažnih naloga.

    Cloudflare, Inc. · Pravila privatnosti

Vanjski sadržaj

Kad ga otvoriš

Video, muzika, GIF-ovi, radio i mapa dolaze sa servera drugih kompanija. Kad ih otvoriš, ti serveri vide tvoju IP adresu i mogu postaviti svoje kolačiće.

  • Google Identity Services servis

    Prijava jednim klikom sa Google nalogom na koji si prijavljen u pregledniku („Nastavi kao …”, accounts.google.com). Google pri tome vidi da si posjetio sajt, a ime i e-mail dobijamo tek kad klikneš „Nastavi”. Google može postaviti kolačić g_state koji pamti da si zatvorio ponudu.

    Google Ireland Ltd. · Pravila privatnosti

  • YouTube servis

    Video u blogu i chatu (youtube-nocookie.com).

    Google Ireland Ltd. · Pravila privatnosti

  • Deezer servis

    Isječci i omoti pjesama na profilu, Mreži i u chatu.

    Deezer S.A. · Pravila privatnosti

  • KLIPY servis

    GIF-ovi u chatu i komentarima.

    KLIPY Inc. · Pravila privatnosti

  • Radio stanice servis

    Prijenos uživo kad pokreneš radio.

    Server izabrane stanice

  • OpenStreetMap servis

    Mapa u modulu U blizini (samo uz poseban pristanak za mapu).

    OpenStreetMap Foundation · Pravila privatnosti

  • OneSignal servis

    Push obavijesti na ovom uređaju – učitava se tek kad ih uključiš u Postavkama.

    OneSignal, Inc. · Pravila privatnosti

Analitika

Anonimna statistika posjeta koja nam pomaže da poboljšamo sajt. Samo uz tvoj pristanak.

  • Google Analytics servis

    Statistika posjeta (koje stranice se otvaraju, odakle dolaze posjetioci, uređaj) - bez reklama. Učitava se samo uz tvoj pristanak.

    Google Ireland Ltd. · Pravila privatnosti

  • _ga kolačić · 24 mjeseci

    Google Analytics: razlikuje posjetioce (nasumičan broj, bez imena i e-maila).

    Google Ireland Ltd. · Pravila privatnosti

  • _ga_0QPMP1EXWV kolačić · 24 mjeseci

    Google Analytics: pamti trenutnu posjetu.

    Google Ireland Ltd. · Pravila privatnosti