Kupachika Lingara

Ukurasa huu umetafsiriwa kutoka Kiingereza. Ikiwa hizi mbili zinatofautiana, ukurasa wa Kiingereza ndio sahihi. Soma ukurasa wa Kiingereza

Lingara inaweza kuishi ndani ya mchezo wako au tovuti yako. Mhusika katika ulimwengu wako anaweza kufanya mazungumzo kwa kiwango cha mchezaji, na mazoezi ambayo mchezaji wako anakamilisha huhesabiwa kama mazoezi ya Lingara. Upachikaji una nusu mbili, na jambo la kwanza la kuamua ni nusu ipi inaendeshwa wapi.

Nani anashikilia nini

Seva yako inashikilia siri ya mteja wako wa OAuth na siri yako ya kutia sahihi webhook. Hakuna kati ya hizo inayoondoka humo kamwe.

Kifaa cha mchezaji kinashikilia kitu kimoja: tokeni ya upachikaji, inayoanza na lgr_et_. Chochote unachoweka ndani ya faili ya mchezo au ukurasa wa wavuti ni cha umma, kwa hivyo kifaa hakishikilii kamwe siri ya mteja, siri ya webhook wala tokeni ya ufikiaji ya mteja wako mwenyewe. Tokeni ya upachikaji hutenda kwa niaba ya mchezaji mmoja tu, hudumu dakika badala ya saa, na hushikilia tu ruhusa ambazo seva yako iliipa.

Mchezaji hahitaji akaunti ya Lingara. Tokeni ya kwanza ambayo seva yako inatengeneza kwa mchezaji humuundia mwanafunzi mgeni, na kila tokeni inayofuata hufikia mwanafunzi huyo huyo. Mchezaji ambaye tayari ana akaunti ya Lingara anaweza kuileta: ukurasa wa vifurushi vya seva unaeleza jinsi seva yako inavyoviunganisha viwili hivyo.

Jinsi tokeni inavyomfikia mchezaji

1. Kifurushi cha mchezaji, ndani ya mchezo wako au kwenye ukurasa wako, kinahitaji tokeni na kuiomba kutoka kwa seva yako kupitia chanzo chake cha tokeni.
2. Seva yako hukagua kipindi chake yenyewe kwa mchezaji huyo na kumtengenezea tokeni kwa kutumia kifurushi cha seva.
3. Seva yako hurudisha tokeni kama sehemu mbili, tokeni na muda wake wa kuisha, kupitia kipindi chako mwenyewe na kamwe si ndani ya URL.
4. Kifurushi cha mchezaji hutumia tokeni hadi inapokaribia kuisha, kisha huiomba seva yako tena. Lingara haifanyi upya tokeni kamwe.

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

Tokeni ya tovuti imefungwa kwa asili (origin) moja: scheme, host na port ya ukurasa wenyewe. Sajili kila asili ambayo wijeti yako inaendeshwa juu yake kabla ya kutengeneza tokeni kwa ajili yake, kama ukurasa wa vifurushi vya seva unavyoeleza. Tokeni ya mchezo haina asili.

Kile tokeni inaweza kufanya

Seva yako huchagua ruhusa za kila tokeni inapoitengeneza, kutoka kwa hizi tano: events:read, events:write, lesson_plans:read, lesson_plans:write na embed:play. Tokeni inaweza kushikilia tu ruhusa ambazo mteja wako mwenyewe tayari anazo. embed:play humruhusu mchezaji kufanya mazungumzo na wahusika wako na kuripoti mazoezi anayokamilisha.

Nani analipa

Ni mteja aliye kwenye mpango wa malipo kwa matumizi pekee anayeweza kutengeneza tokeni. Kila kitu ambacho mchezaji hufanya kwa tokeni huhesabiwa kama matumizi ya mteja wako na hutozwa kwako, si kwa mchezaji.

Kumfuta mchezaji

Mchezaji anapofuta akaunti yake ndani ya mchezo wako, seva yako humfuta kwenye Lingara pia. Hilo huondoa mwanafunzi wake na kila kitu ambacho Lingara inashikilia kwa ajili yake, na hubatilisha kila tokeni anayoshikilia.

Kifurushi unachohitaji

Kila muunganisho hutumia vifurushi viwili: kifurushi cha seva kwenye seva yako, na kifurushi cha mchezaji mahali mchezaji anapocheza.

Kisha soma mazungumzo ya NPC na matokeo ya mazoezi, ambayo hufanya kazi kwa njia ileile katika kila kifurushi.