Recall API की मदद से, गेम Google Play की गेम सेवाओं (पीजीएस) के उपयोगकर्ताओं और उनके इन-गेम खातों के बीच लिंक मैनेज कर सकते हैं. इसके लिए, वे Google के सर्वर पर रीकॉल टोकन सेव करते हैं. यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि Recall API का इस्तेमाल कैसे किया जा सकता है.
कोई उपयोगकर्ता ऐसा गेम खेल रहा है जिसमें डेवलपर के पास उपयोगकर्ता की प्रोग्रेस को ट्रैक करने के लिए आइडेंटिटी सिस्टम है. साथ ही, वह उपयोगकर्ताओं को अपने गेम में लॉग इन करने के लिए, पुष्टि करने के अन्य तरीकों के साथ-साथ PGS का इस्तेमाल करता है. इस उदाहरण में, एक व्यक्ति ने अपने PGS खाते Laura में लॉग इन किया है. इसके बाद, उसने डेवलपर के आइडेंटिटी सिस्टम का इस्तेमाल करके, गेम में एक खाता बनाया है. इस खाते का नाम Racer94 है. जब उपयोगकर्ता गेम खेलता है, तब डेवलपर का गेम सर्वर, उसकी प्रोग्रेस को सिंक करता है.
इसके अलावा, डेवलपर Google के साथ एक रिकॉल टोकन सेव करता है. यह टोकन, गेम में मौजूद उपयोगकर्ता के खाते से जुड़ा होता है. Google, उपयोगकर्ता की PGS प्रोफ़ाइल में उस Recall टोकन को अपने-आप सेव कर लेता है.
अब उपयोगकर्ता पहली बार GPG on PC पर गेम खेलने का फ़ैसला करता है. उपयोगकर्ता की पुष्टि, उसके PGS खाते से अपने-आप हो जाती है. इसके बाद, गेम क्लाइंट यह देखता है कि इस PGS उपयोगकर्ता के लिए कोई प्रोग्रेस उपलब्ध है या नहीं. इसके बाद, गेम सर्वर Google से यह क्वेरी करता है कि इस PGS खाते के लिए कोई टोकन है या नहीं. ऐसा होने पर, Google वापस रिकॉल टोकन भेजता है. गेम सर्वर, इस टोकन का इस्तेमाल करके, उपयोगकर्ता के Racer94 खाते का पता लगाता है और उसकी प्रोग्रेस को वापस लाता है. पीजीएस से पुष्टि करने की प्रोसेस आसान होती है. इसलिए, ऐप्लिकेशन उपयोगकर्ता की प्रोग्रेस को वापस ले आता है. इसके लिए, उपयोगकर्ता को उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं होती. इसके अलावा, डेवलपर अपने मौजूदा आइडेंटिटी सिस्टम के साथ PGS की पुष्टि करने की सुविधा का इस्तेमाल कर सकता है. साथ ही, खिलाड़ी की प्रोग्रेस और उसके PGS खाते के बीच लिंक को सेव करने के लिए, Google पर भरोसा कर सकता है.
ऊपर दिए गए उदाहरण में, Recall API की दो मुख्य कार्रवाइयां दिखाई गई हैं:
जब कोई उपयोगकर्ता गेम में मौजूद किसी खाते से लॉग इन करता है, तब Google के साथ टोकन स्टोर करना.
उपयोगकर्ता के इन-गेम खातों को वापस लाने के लिए, उसके टोकन को फिर से पाना.
रीकॉल टोकन के अलावा, Recall API को गेम में मौजूद खाते से जुड़ा एक स्टेबल आइडेंटिफ़ायर भी चाहिए होता है. इसे पर्सोना कहा जाता है. पर्सोना को ऐसे लेबल के तौर पर देखा जा सकता है जो डेवलपर के आइडेंटिटी सिस्टम में, उपयोगकर्ता के इन-गेम खाते को दिखाता है. वहीं, रिकॉल टोकन को ऐसी कुंजी के तौर पर देखा जा सकता है जिसका इस्तेमाल, उपयोगकर्ता के इन-गेम खाते को गेम में वापस लाने के लिए किया जाता है. अलग-अलग PGS प्रोजेक्ट में, पर्सोना और टोकन वैल्यू का दोबारा इस्तेमाल नहीं किया जाना चाहिए. साथ ही, समय के साथ-साथ Recall टोकन में बदलाव हो सकता है. हालांकि, उपयोगकर्ता के इन-गेम खाते के हिसाब से पर्सोना में बदलाव नहीं होना चाहिए.
Recall टोकन को सेव और वापस पाने के लिए तकनीकी फ़्लो
इस सेक्शन में, रीकॉल टोकन सेव करने और वापस पाने के दौरान, गेम क्लाइंट और सर्वर के बीच होने वाले टेक्निकल फ़्लो के बारे में बताया गया है.
पहला चरण: PGS उपयोगकर्ता की पुष्टि करना और सेशन आईडी वापस पाना
गेम, PGS SDK टूल को शुरू करता है और PGS की मदद से उपयोगकर्ता की पुष्टि करने की कोशिश करता है.
मान लें कि उपयोगकर्ता की पुष्टि हो गई है. इसके बाद, गेम क्लाइंट पर Games SDK से सेशन आईडी का अनुरोध करें. साथ ही, Google के OAuth बैकएंड से OAuth 2.0 टोकन का अनुरोध करें. सेशन आईडी और OAuth 2.0 टोकन का इस्तेमाल, Google Games के बैकएंड से कम्यूनिकेट करने के लिए किया जाता है.
दूसरा चरण: वापस मंगाए गए किसी भी प्रॉडक्ट के लिए उपलब्ध रीकॉल टोकन वापस पाना
पीजीएस उपयोगकर्ता के खाते से जुड़े किसी भी Recall टोकन के लिए अनुरोध करें. अगर कोई टोकन मौजूद है, तो चरण 3a पर जाएं और प्रोग्रेस वापस पाएं. अगर यह नया उपयोगकर्ता है और इसके पास कोई टोकन मौजूद नहीं है, तो तीसरे चरण पर जाएं और नया टोकन सेव करें.
तीसरे चरण का पहला हिस्सा: अगर टोकन मौजूद है, तो प्रोग्रेस वापस लाएं
अगर कोई टोकन मौजूद है, तो उसे वापस पाएं और डिक्रिप्ट करें. इसके बाद, उपयोगकर्ता का डेटा वापस लाएं.
तीसरे चरण का दूसरा हिस्सा: अगर कोई टोकन मौजूद नहीं है, तो टोकन सेव करें
कोई टोकन मौजूद न होने की वजह से, प्रोग्रेस को वापस नहीं लाया जा सकता. उपयोगकर्ता, डेवलपर के पहचान सिस्टम की मदद से प्लैटफ़ॉर्म पर पुष्टि करता है. अगर उसके पास कोई खाता नहीं है, तो वह नया खाता बनाता है. ध्यान दें - यह PGS में पुष्टि करने की प्रोसेस नहीं है. यह प्रोसेस पहले ही पूरी हो चुकी है. हालांकि, यह PGS से बाहर डेवलपर के आइडेंटिटी सिस्टम में पुष्टि करने की प्रोसेस है.
एक एन्क्रिप्ट (सुरक्षित) किया गया रीकॉल टोकन बनाएं. यह टोकन, गेम में मौजूद उपयोगकर्ता के खाते को एन्कोड करता है. इसके बाद, इसे Google को भेजें. साथ ही, सेशन आईडी और OAuth 2.0 टोकन भी भेजें. इस समय, Google भेजे गए रिकॉल टोकन और खिलाड़ी के PGS खाते के बीच एक असोसिएशन बनाता है.
पीजीएस प्रोफ़ाइल के बिना उपयोगकर्ताओं के लिए फ़्लो
प्रोफ़ाइल के बिना गेम खेलने की सुविधा का इस्तेमाल करके, ऐसे व्यक्ति के लिए रीकॉल टोकन सेव किए जा सकते हैं जिसने अब तक पीजीएस प्रोफ़ाइल नहीं बनाई है. हालांकि, यहां दो अहम चेतावनियां दी गई हैं:
- जिन लोगों के पास पीजीएस प्रोफ़ाइल नहीं है उनके लिए टोकन वापस नहीं पाए जा सकते. जब कोई उपयोगकर्ता दूसरे डिवाइस पर Play Games Services का इस्तेमाल करके आपके गेम में लॉग इन करने की कोशिश करता है, तो उसे प्रोफ़ाइल बनाने के लिए अपने-आप प्रॉम्प्ट मिलता है.
- आपको अतिरिक्त दिशा-निर्देशों का पालन करना होगा. इससे यह पक्का किया जा सकेगा कि आपके पास एक सही सूचना है, जिसमें इन आइटम के बारे में बताया गया है. साथ ही, असली उपयोगकर्ता की ज़रूरी सहमति ली गई है:
- Play Games खाते को लिंक करने की सुविधा चालू करने के लिए, Google के साथ डेटा शेयर करना.
- शेयर करने की सुविधा को मैनेज करने के लिए सेटिंग उपलब्ध हैं या नहीं. जैसे, Play Games की सेटिंग.
- Google की निजता नीति के तहत, इस तरह के डेटा को प्रोसेस किया जाता है.
यह कुकी, टोकन और पर्सोना के पेयर को सेव करती है
- जब कोई ऐसा उपयोगकर्ता गेम खोलता है जिसके पास पीजीएस प्रोफ़ाइल नहीं है और उस गेम में प्रोफ़ाइल के बिना रीकॉल करने की सुविधा चालू है.
- Games SDK टूल, प्लैटफ़ॉर्म की पुष्टि करने की प्रोसेस को अपने-आप ट्रिगर करता है. हालांकि, यह प्रोसेस पूरी नहीं हो पाती, क्योंकि उपयोगकर्ता के पास PGS प्रोफ़ाइल नहीं है.
- Games SDK टूल, एक स्नैकबार दिखाता है. इससे उपयोगकर्ता को पता चलता है कि गेम को Google के साथ इंटिग्रेट किया गया है. इस स्नैकबार पर कार्रवाई की जा सकती है. उपयोगकर्ता, प्रोफ़ाइल बनने तक याददाश्त की सुविधा को बंद कर सकता है.
- गेम, कॉल करने के लिए ऐक्सेस का अनुरोध करता है. ध्यान दें कि डिवाइस पर पीजीएस प्रोफ़ाइलें मौजूद होने पर या डिवाइस पर कोई Google खाता न होने पर, पीजीएस, रीकॉल ऐक्सेस करने के अनुरोधों को अस्वीकार कर देता है. ऐसे में, गेम को PGS का इस्तेमाल किए बिना आगे बढ़ना चाहिए.
- जब उपयोगकर्ता, गेम में मौजूद खाते से लॉग इन करता है, तो गेम उसके लिए एक टोकन और पर्सोना पेयर बनाता है. यह पेयर, गेम में मौजूद खाते से मेल खाता है. गेम, इस पेयर को Google के साथ सेव करता है. अगर उपयोगकर्ता गेम में मौजूद अन्य खातों में लॉग इन करता है, तो गेम बाद में ज़्यादा टोकन सेव कर सकता है.
किसी नए डिवाइस पर गेम लॉन्च करना
- पीजीएस प्रोफ़ाइल के बिना कोई उपयोगकर्ता, किसी ऐसे गेम को खोलता है जिसमें प्रोफ़ाइल के बिना रीकॉल करने की सुविधा चालू है.
- गेम, प्रोफ़ाइल के बिना Recall टोकन को रिकॉर्ड करता है. इसके बारे में टोकन और पर्सोना का पेयर सेव करना लेख में बताया गया है.
- उपयोगकर्ता, उसी खाते से किसी दूसरे डिवाइस पर गेम खोलता है.
- Games SDK, प्रोफ़ाइल बनाने की प्रोसेस शुरू करता है. उपयोगकर्ता, पहले से सेव किए गए Recall टोकन की समीक्षा कर सकता है और उन्हें अस्वीकार कर सकता है. इस समय उपयोगकर्ता, PGS प्रोफ़ाइल बनाता है.
- PGS में प्लैटफ़ॉर्म की पुष्टि अपने-आप हो जाती है. इसके बाद, गेम को पुष्टि किए गए स्टेटस का बैज मिल जाता है.
- गेम, उपयोगकर्ता के लिए सामान्य तरीके से Recall टोकन वापस पाता है.
अगले चरण
Recall API को अपने क्लाइंट और गेम सर्वर के साथ इंटिग्रेट करने के लिए, इस गाइड में दिए गए निर्देशों का पालन करें.