Ενσωμάτωση του Lingara

Αυτή η σελίδα έχει μεταφραστεί από τα αγγλικά. Αν οι δύο διαφέρουν, η αγγλική σελίδα είναι η σωστή. Διαβάστε την αγγλική σελίδα

Το Lingara μπορεί να ζει μέσα στο παιχνίδι ή στον ιστότοπό σας. Ένας χαρακτήρας του κόσμου σας μπορεί να κάνει συζήτηση στο επίπεδο του παίκτη, και η εξάσκηση που ολοκληρώνει ο παίκτης σας μετρά ως εξάσκηση στο Lingara. Η ενσωμάτωση έχει δύο μισά, και το πρώτο που πρέπει να ξεκαθαρίσετε είναι ποιο μισό εκτελείται πού.

Ποιος κρατά τι

Ο διακομιστής σας κρατά το μυστικό του πελάτη OAuth σας και το μυστικό υπογραφής των webhook σας. Κανένα από τα δύο δεν τον εγκαταλείπει ποτέ.

Η συσκευή του παίκτη κρατά ένα μόνο πράγμα: ένα token ενσωμάτωσης, που ξεκινά με lgr_et_. Ό,τι διανέμετε μέσα σε ένα εκτελέσιμο παιχνιδιού ή σε μια ιστοσελίδα είναι δημόσιο, οπότε η συσκευή δεν κρατά ποτέ μυστικό πελάτη, μυστικό webhook ή access token του δικού σας πελάτη. Ένα token ενσωμάτωσης ενεργεί για έναν μόνο παίκτη, διαρκεί λεπτά αντί για ώρες και κρατά μόνο τα scopes που του έδωσε ο διακομιστής σας.

Ένας παίκτης δεν χρειάζεται λογαριασμό Lingara. Το πρώτο token που εκδίδει ο διακομιστής σας για έναν παίκτη δημιουργεί γι’ αυτόν έναν μαθητή-επισκέπτη, και κάθε επόμενο token φτάνει στον ίδιο μαθητή. Ένας παίκτης που έχει ήδη λογαριασμό Lingara μπορεί να τον φέρει μαζί του: η σελίδα κιτ διακομιστή περιγράφει πώς ο διακομιστής σας συνδέει τα δύο.

Πώς φτάνει ένα token στον παίκτη

1. Το κιτ παίκτη, στο παιχνίδι ή στη σελίδα σας, χρειάζεται ένα token και το ζητά από τον διακομιστή σας μέσω της πηγής token του.
2. Ο διακομιστής σας ελέγχει τη δική του συνεδρία για αυτόν τον παίκτη και εκδίδει ένα token γι’ αυτόν με το κιτ διακομιστή.
3. Ο διακομιστής σας επιστρέφει το token ως δύο πεδία, το token και τη λήξη του, μέσω της δικής σας συνεδρίας και ποτέ σε URL.
4. Το κιτ παίκτη χρησιμοποιεί το token μέχρι να πλησιάσει τη λήξη του και έπειτα ζητά ξανά από τον διακομιστή σας. Το Lingara δεν ανανεώνει ποτέ ένα 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 ─────────────────────▶

Ένα token για ιστότοπο είναι δεσμευμένο σε μία προέλευση: το σχήμα, τον host και τη θύρα της ίδιας της σελίδας. Καταχωρίστε κάθε προέλευση στην οποία εκτελείται το widget σας πριν εκδώσετε token γι’ αυτήν, όπως περιγράφει η σελίδα κιτ διακομιστή. Ένα token για παιχνίδι δεν έχει προέλευση.

Τι μπορεί να κάνει ένα token

Ο διακομιστής σας επιλέγει τα scopes κάθε token όταν το εκδίδει, από αυτά τα πέντε: events:read, events:write, lesson_plans:read, lesson_plans:write και embed:play. Ένα token μπορεί να κρατά μόνο scopes που κατέχει ήδη ο δικός σας πελάτης. Το embed:play επιτρέπει στον παίκτη να κάνει συζητήσεις με τους χαρακτήρες σας και να αναφέρει την εξάσκηση που ολοκληρώνει.

Ποιος πληρώνει

Μόνο ένας πελάτης στο πρόγραμμα με χρέωση βάσει χρήσης μπορεί να εκδίδει token. Ό,τι κάνει ένας παίκτης με ένα token μετρά ως χρήση του πελάτη σας και χρεώνεται σε εσάς, όχι στον παίκτη.

Διαγραφή παίκτη

Όταν ένας παίκτης διαγράφει τον λογαριασμό του στο παιχνίδι σας, ο διακομιστής σας τον διαγράφει και στο Lingara. Αυτό αφαιρεί τον μαθητή του και ό,τι κρατά το Lingara γι’ αυτόν, και ανακαλεί κάθε token που κατέχει.

Ποιο κιτ χρειάζεστε

Κάθε ενσωμάτωση χρησιμοποιεί δύο κιτ: ένα κιτ διακομιστή στον διακομιστή σας και ένα κιτ παίκτη εκεί όπου παίζει ο παίκτης.

Έπειτα διαβάστε Διάλογοι με NPC και αποτελέσματα εξάσκησης, που λειτουργούν με τον ίδιο τρόπο σε κάθε κιτ.