Pag-embed ng Lingara

Isinalin mula sa Ingles ang pahinang ito. Kung magkaiba ang dalawa, ang pahinang Ingles ang tama. Basahin ang pahinang Ingles

Puwedeng manirahan ang Lingara sa loob ng iyong laro o website. Ang isang karakter sa iyong mundo ay puwedeng makipag-usap ayon sa antas ng player, at ang pagsasanay na natatapos ng iyong player ay binibilang bilang pagsasanay sa Lingara. May dalawang bahagi ang embed, at ang unang dapat pagpasyahan ay kung aling bahagi ang tumatakbo saan.

Sino ang may hawak ng ano

Hawak ng iyong server ang secret ng iyong OAuth client at ang iyong webhook signing secret. Hindi kailanman lumalabas doon ang alinman sa mga ito.

Iisang bagay lang ang hawak ng device ng player: isang embed token, na nagsisimula sa lgr_et_. Pampubliko ang anumang isinasama mo sa binary ng laro o sa isang web page, kaya hindi kailanman humahawak ang device ng client secret, webhook secret o access token ng sarili mong client. Kumikilos ang isang embed token para sa iisang player lang, tumatagal nang ilang minuto sa halip na ilang oras, at hawak lang nito ang mga scope na ibinigay rito ng iyong server.

Hindi kailangan ng player ng Lingara account. Ang unang token na mina-mint ng iyong server para sa isang player ay gumagawa ng guest learner para sa kanya, at ang bawat susunod na token ay umaabot sa parehong learner. Ang player na may Lingara account na ay puwedeng gamitin iyon: inilalarawan ng page na mga server kit kung paano pinag-uugnay ng iyong server ang dalawa.

Paano umaabot sa player ang isang token

1. Ang player kit, sa iyong laro o sa iyong page, ay nangangailangan ng token at humihingi nito sa iyong server sa pamamagitan ng token source nito.
2. Sinusuri ng iyong server ang sarili nitong session para sa player na iyon at nagmi-mint ng token para sa kanya gamit ang server kit.
3. Ibinabalik ng iyong server ang token bilang dalawang field, ang token at ang expiry nito, sa pamamagitan ng sarili mong session at hindi kailanman sa isang URL.
4. Ginagamit ng player kit ang token hanggang malapit na itong mag-expire, saka muling humihingi sa iyong server. Hindi kailanman nire-refresh ng Lingara ang isang token.

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

Ang token para sa isang website ay nakatali sa iisang origin: ang sariling scheme, host at port ng page. Irehistro ang bawat origin na pinapatakbuhan ng iyong widget bago ka mag-mint para dito, gaya ng inilalarawan ng page na mga server kit. Walang origin ang token para sa isang laro.

Ang puwedeng gawin ng isang token

Pinipili ng iyong server ang mga scope ng bawat token kapag mina-mint ito, mula sa limang ito: events:read, events:write, lesson_plans:read, lesson_plans:write at embed:play. Ang isang token ay puwede lang humawak ng mga scope na hawak na ng sarili mong client. Pinapayagan ng embed:play ang player na makipag-usap sa iyong mga karakter at iulat ang pagsasanay na natatapos niya.

Sino ang nagbabayad

Ang client lang na nasa metered plan ang puwedeng mag-mint ng mga token. Lahat ng ginagawa ng player gamit ang isang token ay binibilang bilang paggamit ng iyong client at sinisingil sa iyo, hindi sa player.

Pagbura ng player

Kapag binura ng player ang kanyang account sa iyong laro, binubura rin siya ng iyong server sa Lingara. Inaalis nito ang kanyang learner at lahat ng hawak ng Lingara para sa kanya, at binabawi ang bawat token na hawak niya.

Aling kit ang kailangan mo

Dalawang kit ang ginagamit ng bawat integration: isang server kit sa iyong server, at isang player kit kung saan naglalaro ang player.

Pagkatapos, basahin ang usapan ng NPC at mga resulta ng pagsasanay, na pareho ang paggana sa bawat kit.