Lingara inbed

Hierdie bladsy is uit Engels vertaal. As die twee verskil, is die Engelse bladsy korrek. Lees die Engelse bladsy

Lingara kan binne jou speletjie of jou webwerf woon. ‘n Karakter in jou wêreld kan ‘n gesprek op die speler se vlak voer, en oefening wat jou speler voltooi, tel as Lingara-oefening. Die inbedding het twee helftes, en die eerste ding om te besluit is watter helfte waar loop.

Wie hou wat

Jou bediener hou jou OAuth-kliënt se geheim en jou webhook-ondertekeningsgeheim. Nie een van die twee verlaat dit ooit nie.

Die speler se toestel hou een ding: ‘n inbedtoken, wat met lgr_et_ begin. Enigiets wat jy binne ‘n speletjie se binêre lêer of ‘n webblad saamstuur, is publiek, so die toestel hou nooit ‘n kliëntgeheim, ‘n webhook-geheim of ‘n toegangstoken van jou eie kliënt nie. ‘n Inbedtoken tree vir net een speler op, hou minute eerder as ure, en hou net die scopes wat jou bediener daaraan gegee het.

‘n Speler het geen Lingara-rekening nodig nie. Die eerste token wat jou bediener vir ‘n speler uitreik, skep ‘n gasleerder vir hulle, en elke latere token bereik dieselfde leerder. ‘n Speler wat reeds ‘n Lingara-rekening het, kan dit saambring: die bladsy Bedienerkits beskryf hoe jou bediener die twee koppel.

Hoe ‘n token die speler bereik

1. Die spelerkit, in jou speletjie of op jou bladsy, het ‘n token nodig en vra jou bediener deur sy tokenbron.
2. Jou bediener kontroleer sy eie sessie vir daardie speler en reik met die bedienerkit ‘n token vir hulle uit.
3. Jou bediener gee die token terug as twee velde, die token en sy vervaltyd, deur jou eie sessie en nooit in ‘n URL nie.
4. Die spelerkit gebruik die token totdat dit amper verval, en vra dan jou bediener weer. Lingara verfris nooit ‘n token nie.

 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 ─────────────────────▶

‘n Token vir ‘n webwerf is aan een oorsprong gebind: die bladsy se eie skema, gasheer en poort. Registreer elke oorsprong waarop jou widget loop voordat jy ‘n token daarvoor uitreik, soos die bladsy Bedienerkits beskryf. ‘n Token vir ‘n speletjie het geen oorsprong nie.

Wat ‘n token mag doen

Jou bediener kies elke token se scopes wanneer dit die token uitreik, uit hierdie vyf: events:read, events:write, lesson_plans:read, lesson_plans:write en embed:play. ‘n Token kan net scopes hou wat jou eie kliënt reeds hou. embed:play laat die speler gesprekke met jou karakters voer en die oefening rapporteer wat hulle voltooi.

Wie betaal

Net ‘n betaal-per-gebruik-kliënt mag tokens uitreik. Alles wat ‘n speler met ‘n token doen, word as jou kliënt se gebruik getel en aan jou gefaktureer, nie aan die speler nie.

‘n Speler skrap

Wanneer ‘n speler hul rekening in jou speletjie skrap, skrap jou bediener hulle ook by Lingara. Dit verwyder hul leerder en alles wat Lingara vir hulle hou, en herroep elke token wat hulle hou.

Watter kit jy nodig het

Elke integrasie gebruik twee kits: ‘n bedienerkit op jou bediener, en ‘n spelerkit waar die speler speel.

Lees dan NPC-dialoog en oefenresultate, wat in elke kit op dieselfde manier werk.