Lingaran upottaminen

Tämä sivu on käännetty englannista. Jos ne eroavat toisistaan, englanninkielinen sivu on oikea. Lue englanninkielinen sivu

Lingara voi toimia pelisi tai verkkosivustosi sisällä. Maailmasi hahmo voi keskustella pelaajan tasolla, ja pelaajasi suorittama harjoittelu lasketaan Lingara-harjoitteluksi. Upotuksessa on kaksi puoliskoa, ja ensimmäiseksi on ratkaistava, kumpi puolisko toimii missäkin.

Kuka säilyttää mitäkin

Palvelimesi säilyttää OAuth-asiakkaasi salaisuuden ja webhookiesi allekirjoitussalaisuuden. Kumpikaan ei koskaan poistu sieltä.

Pelaajan laite säilyttää vain yhden asian: upotustunnuksen, joka alkaa merkkijonolla lgr_et_. Kaikki, mitä toimitat pelin binääritiedoston tai verkkosivun sisällä, on julkista, joten laite ei koskaan säilytä asiakassalaisuutta, webhook-salaisuutta tai oman asiakkaasi käyttöoikeustunnusta. Upotustunnus toimii vain yhden pelaajan puolesta, kestää minuutteja eikä tunteja ja sisältää vain ne oikeudet, jotka palvelimesi sille antoi.

Pelaaja ei tarvitse Lingara-tiliä. Ensimmäinen tunnus, jonka palvelimesi luo pelaajalle, luo hänelle vierasoppijan, ja jokainen myöhempi tunnus tavoittaa saman oppijan. Pelaaja, jolla on jo Lingara-tili, voi tuoda sen mukanaan: palvelinpakettien sivu kuvaa, miten palvelimesi yhdistää nämä kaksi.

Miten tunnus tavoittaa pelaajan

1. Pelaajapaketti pelissäsi tai sivullasi tarvitsee tunnuksen ja pyytää sitä palvelimeltasi tunnuslähteensä kautta.
2. Palvelimesi tarkistaa oman istuntonsa kyseiselle pelaajalle ja luo hänelle tunnuksen palvelinpaketilla.
3. Palvelimesi palauttaa tunnuksen kahtena kenttänä, tunnuksena ja sen vanhenemisaikana, oman istuntosi kautta eikä koskaan URL-osoitteessa.
4. Pelaajapaketti käyttää tunnusta, kunnes se lähestyy vanhenemistaan, ja pyytää sitten palvelimeltasi uuden. Lingara ei koskaan uusi tunnusta.

 player's device                your server                    Lingara
 ───────────────                ───────────                    ───────
 player kit ── needs a token ──▶ your token route
                                 server kit ── mint ─────────▶ token for one player
 player kit ◀── token, expiry ── your token route ◀──────────
 player kit ── API calls with the token ─────────────────────▶

Verkkosivuston tunnus on sidottu yhteen alkuperään: sivun omaan skeemaan, isäntään ja porttiin. Rekisteröi jokainen alkuperä, jossa widgettisi toimii, ennen kuin luot tunnuksia sille, kuten palvelinpakettien sivu kuvaa. Pelin tunnuksella ei ole alkuperää.

Mitä tunnus saa tehdä

Palvelimesi valitsee kunkin tunnuksen oikeudet luodessaan sen, näistä viidestä: events:read, events:write, lesson_plans:read, lesson_plans:write ja embed:play. Tunnus voi sisältää vain oikeuksia, jotka omalla asiakkaallasi jo on. embed:play antaa pelaajan keskustella hahmojesi kanssa ja raportoida suorittamansa harjoittelun.

Kuka maksaa

Vain käyttöperusteisella hinnoittelulla oleva asiakas voi luoda tunnuksia. Kaikki, mitä pelaaja tekee tunnuksella, lasketaan asiakkaasi käytöksi ja laskutetaan sinulta, ei pelaajalta.

Pelaajan poistaminen

Kun pelaaja poistaa tilinsä pelissäsi, palvelimesi poistaa hänet myös Lingarasta. Tämä poistaa hänen oppijansa ja kaiken, mitä Lingara hänestä säilyttää, ja mitätöi jokaisen hänen hallussaan olevan tunnuksen.

Minkä paketin tarvitset

Jokainen integraatio käyttää kahta pakettia: palvelinpakettia palvelimellasi ja pelaajapakettia siellä, missä pelaaja pelaa.

Lue sitten NPC-dialogit ja harjoittelun tulokset, jotka toimivat samalla tavalla jokaisessa paketissa.