Lingara को एम्बेड करना

यह पेज अंग्रेज़ी से अनुवादित है। अगर दोनों में अंतर हो, तो अंग्रेज़ी पेज सही है। अंग्रेज़ी पेज पढ़ें

Lingara आपके गेम या आपकी वेबसाइट के अंदर रह सकता है। आपकी दुनिया का कोई किरदार खिलाड़ी के स्तर पर बातचीत कर सकता है, और आपका खिलाड़ी जो अभ्यास पूरा करता है वह Lingara अभ्यास के रूप में गिना जाता है। एम्बेड के दो हिस्से हैं, और सबसे पहले यह तय करना है कि कौन-सा हिस्सा कहाँ चलता है।

किसके पास क्या रहता है

आपका सर्वर आपके OAuth क्लाइंट का सीक्रेट और आपका वेबहुक साइनिंग सीक्रेट रखता है। इनमें से कोई भी कभी उसे छोड़कर नहीं जाता।

खिलाड़ी का डिवाइस एक ही चीज़ रखता है: एक एम्बेड टोकन, जो lgr_et_ से शुरू होता है। गेम बाइनरी या वेब पेज के अंदर आप जो कुछ भी शिप करते हैं वह सार्वजनिक होता है, इसलिए डिवाइस कभी क्लाइंट सीक्रेट, वेबहुक सीक्रेट या आपके अपने क्लाइंट का एक्सेस टोकन नहीं रखता। एम्बेड टोकन केवल एक खिलाड़ी के लिए काम करता है, घंटों के बजाय मिनटों तक चलता है, और केवल वही स्कोप रखता है जो आपके सर्वर ने उसे दिए।

खिलाड़ी को Lingara खाते की ज़रूरत नहीं होती। आपका सर्वर किसी खिलाड़ी के लिए जो पहला टोकन मिंट करता है, वह उनके लिए एक अतिथि शिक्षार्थी बनाता है, और बाद का हर टोकन उसी शिक्षार्थी तक पहुँचता है। जिस खिलाड़ी के पास पहले से Lingara खाता है, वह उसे ला सकता है: सर्वर किट पेज बताता है कि आपका सर्वर दोनों को कैसे लिंक करता है।

टोकन खिलाड़ी तक कैसे पहुँचता है

1. प्लेयर किट, आपके गेम में या आपके पेज पर, को टोकन चाहिए होता है और वह अपने टोकन स्रोत के ज़रिए आपके सर्वर से माँगता है।
2. आपका सर्वर उस खिलाड़ी के लिए अपना सेशन जाँचता है और सर्वर किट से उनके लिए एक टोकन मिंट करता है।
3. आपका सर्वर टोकन को दो फ़ील्ड के रूप में लौटाता है, टोकन और उसकी समाप्ति, आपके अपने सेशन के ज़रिए और कभी URL में नहीं।
4. प्लेयर किट टोकन का उपयोग तब तक करता है जब तक वह समाप्ति के करीब न पहुँच जाए, फिर आपके सर्वर से दोबारा माँगता है। Lingara कभी टोकन रिफ़्रेश नहीं करता।

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

वेबसाइट के लिए टोकन एक ओरिजिन से बँधा होता है: पेज की अपनी स्कीम, होस्ट और पोर्ट। जिन ओरिजिन पर आपका विजेट चलता है, उन सभी को मिंट करने से पहले रजिस्टर करें, जैसा कि सर्वर किट पेज बताता है। गेम के लिए टोकन का कोई ओरिजिन नहीं होता।

टोकन क्या कर सकता है

आपका सर्वर हर टोकन को मिंट करते समय उसके स्कोप चुनता है, इन पाँच में से: events:read, events:write, lesson_plans:read, lesson_plans:write और embed:play। टोकन केवल वही स्कोप रख सकता है जो आपके अपने क्लाइंट के पास पहले से हैं। embed:play खिलाड़ी को आपके किरदारों के साथ बातचीत करने और अपने पूरे किए गए अभ्यास की रिपोर्ट करने देता है।

भुगतान कौन करता है

केवल मीटर्ड प्लान वाला क्लाइंट ही टोकन मिंट कर सकता है। खिलाड़ी टोकन से जो कुछ भी करता है, वह आपके क्लाइंट के उपयोग के रूप में गिना जाता है और उसका बिल आपको आता है, खिलाड़ी को नहीं।

खिलाड़ी को हटाना

जब कोई खिलाड़ी आपके गेम में अपना खाता हटाता है, तो आपका सर्वर उन्हें Lingara पर भी हटाता है। इससे उनका शिक्षार्थी और Lingara के पास उनका सब कुछ हट जाता है, और उनके पास मौजूद हर टोकन रद्द हो जाता है।

आपको कौन-सा किट चाहिए

हर इंटीग्रेशन दो किट का उपयोग करता है: आपके सर्वर पर एक सर्वर किट, और जहाँ खिलाड़ी खेलता है वहाँ एक प्लेयर किट।

फिर NPC संवाद और अभ्यास के परिणाम पढ़ें, जो हर किट में एक ही तरह काम करते हैं।