Recall API

Recall API की मदद से, गेम Google Play Games Services (PGS) के उपयोगकर्ताओं और उनके इन-गेम खातों के बीच के लिंक मैनेज कर सकते हैं. इसके लिए, Google के सर्वर पर रीकॉल टोकन सेव किए जाते हैं. यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि Recall API का इस्तेमाल कैसे किया जा सकता है.

1. कोई उपयोगकर्ता किसी ऐसे गेम को खेल रहा है जिसमें डेवलपर के पास उपयोगकर्ता की प्रोग्रेस को ट्रैक करने के लिए, पहचान से जुड़ा सिस्टम है. साथ ही, उपयोगकर्ताओं को अपने गेम में लॉग इन करने के लिए, पुष्टि करने के अन्य तरीकों के साथ-साथ PGS का इस्तेमाल करता है. इस उदाहरण में, कोई उपयोगकर्ता अपने PGS खाते Laura में लॉग इन करता है और डेवलपर के पहचान सिस्टम Racer94 की मदद से, गेम में खाता बनाता है. जब उपयोगकर्ता गेम खेलता है, तो डेवलपर का गेम सर्वर उसकी प्रोग्रेस को सिंक करता है.

   

2. इसके अलावा, डेवलपर Google के साथ एक रीकॉल टोकन सेव करता है. यह टोकन, उपयोगकर्ता के इन-गेम खाते से जुड़ा होता है. Google, उस Recall टोकन को उपयोगकर्ता की पीजीएस प्रोफ़ाइल में अपने-आप सेव कर लेता है.

   

3. उपयोगकर्ता अब पहली बार पीसी के लिए GPG पर गेम खेलने का फ़ैसला करता है. उपयोगकर्ता अपने PGS खाते से अपने-आप साइन इन हो जाता है. साथ ही, गेम क्लाइंट यह देखता है कि इस PGS उपयोगकर्ता के लिए कोई प्रोग्रेस उपलब्ध है या नहीं. इसके बाद, गेम सर्वर Google से यह क्वेरी करता है कि इस PGS खाते के लिए कोई टोकन है या नहीं. इसलिए, Google, रीकॉल टोकन वापस भेजता है. इसके बाद, गेम सर्वर उस टोकन का इस्तेमाल करके, उपयोगकर्ता से जुड़ा खाता Racer94 ढूंढता है और उसकी प्रोग्रेस को वापस लाता है. पीजीएस की मदद से साइन इन करना आसान है. इसलिए, ऐप्लिकेशन में उपयोगकर्ता की प्रोग्रेस को वापस लाया जा सकता है. इसके लिए, उपयोगकर्ता को उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं होती. इसके अलावा, डेवलपर अपने मौजूदा पहचान सिस्टम के साथ PGS साइन-इन का इस्तेमाल कर सकता है. साथ ही, खिलाड़ी की प्रोग्रेस और उनके PGS खाते के बीच के लिंक को सेव करने के लिए, Google पर भरोसा कर सकता है.

   

जैसा कि ऊपर दिए गए उदाहरण में देखा गया है, Recall API दो मुख्य कार्रवाइयां करता है:

• जब कोई उपयोगकर्ता इन-गेम खातों में से किसी एक से लॉग इन करता है, तो Google के साथ टोकन को सेव करना.

• किसी उपयोगकर्ता के इन-गेम खातों को वापस लाने के लिए, उसका टोकन पाना.

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

एलिमेंट की संख्या के नियम

रीकॉल एपीआई, पीजीएस प्रोफ़ाइलों और इन-गेम खातों (जिन्हें एलिमेंट की संख्या से जुड़े नियम कहा जाता है) के बीच 1:1 का संबंध लागू करता है. इसमें, एक व्यक्तित्व को सिर्फ़ एक पीजीएस प्रोफ़ाइल से लिंक किया जा सकता है और एक पीजीएस प्रोफ़ाइल को सिर्फ़ एक व्यक्तित्व से लिंक किया जा सकता है. गेम में मौजूद खाते के लिए, व्यक्तित्व का इस्तेमाल एक स्थिर आइडेंटिफ़ायर के तौर पर किया जाता है, क्योंकि रीकॉल टोकन समय के साथ बदल सकते हैं.

PGS प्रोफ़ाइल से जुड़ा व्यक्तित्व भी समय के साथ बदल सकता है. ऐसा इसलिए होता है, क्योंकि अलग-अलग इन-गेम खाते, PGS प्रोफ़ाइल से लिंक होते हैं.

रीकॉल टोकन को सेव और वापस पाने के लिए तकनीकी फ़्लो

इस सेक्शन में, गेम क्लाइंट और सर्वर के बीच के तकनीकी फ़्लो के बारे में बताया गया है. इसमें, रीकॉल टोकन को सेव और वापस पाने के दौरान, Google के सर्वर के साथ इंटरैक्ट करने की जानकारी भी शामिल है.

पहला चरण: PGS उपयोगकर्ता के तौर पर साइन इन करना और सेशन आईडी हासिल करना

गेम, PGS SDK टूल को शुरू करता है और उपयोगकर्ता को PGS की मदद से साइन इन करने की कोशिश करता है.

यह मानते हुए कि उपयोगकर्ता ने साइन इन किया है, गेम क्लाइंट पर Games SDK टूल से सेशन आईडी का अनुरोध करें. साथ ही, Google के OAuth बैकएंड से OAuth 2.0 टोकन का अनुरोध करें. सेशन आईडी और OAuth 2.0 टोकन का इस्तेमाल, Google Games के बैकएंड के साथ इंटरैक्ट करने के लिए किया जाता है.

दूसरा चरण: उपलब्ध रिकॉर्ड वापस पाने का टोकन पाना

पीजीएस उपयोगकर्ता के खाते से जुड़े किसी भी रीकॉल टोकन का अनुरोध करें. अगर कोई टोकन मौजूद है, तो तीसरे चरण के पहले हिस्से पर जाएं और प्रोग्रेस को वापस पाएं. अगर यह नया उपयोगकर्ता है और उसके पास कोई टोकन नहीं है, तो तीसरे चरण के बी में जाएं और नया टोकन सेव करें.

तीसरे चरण का पहला हिस्सा: अगर टोकन मौजूद है, तो प्रोग्रेस को वापस लाएं

अगर कोई टोकन मौजूद है, तो टोकन को वापस पाएं और उसे डिक्रिप्ट करें. इसके बाद, उपयोगकर्ता का डेटा वापस लाएं.

तीसरे चरण का दूसरा हिस्सा: अगर कोई टोकन मौजूद नहीं है, तो टोकन सेव करना

कोई टोकन मौजूद न होने की वजह से, कोई भी प्रोग्रेस वापस नहीं लाई जाती. उपयोगकर्ता, डेवलपर के आइडेंटिटी सिस्टम से साइन इन करता है. अगर कोई खाता मौजूद नहीं है, तो वह नया खाता बनाता है. ध्यान दें - यह पीजीएस (जो पहले ही किया जा चुका है) के साथ साइन इन नहीं है, बल्कि पीजीएस के बाहर डेवलपर के आइडेंटिटी सिस्टम के साथ साइन इन है.

एन्क्रिप्ट (सुरक्षित) किया गया रीकॉल टोकन बनाएं, जो उपयोगकर्ता के इन-गेम खाते को कोड में बदलता है. साथ ही, इसे सेशन आईडी और OAuth 2.0 टोकन के साथ Google को भेजता है. इस समय, Google, भेजे गए रीकॉल टोकन और खिलाड़ी के PGS खाते के बीच एक असोसिएशन बनाता है.

पीजीएस प्रोफ़ाइल के बिना उपयोगकर्ताओं के लिए फ़्लो

प्रोफ़ाइल के बिना काम करने वाले मोड का इस्तेमाल करके, ऐसे उपयोगकर्ता के लिए रीकॉल टोकन सेव किए जा सकते हैं जिसने अब तक पीजीएस प्रोफ़ाइल नहीं बनाई है. हालांकि, दो बातों का ध्यान रखें:

• ऐसे उपयोगकर्ता के लिए टोकन नहीं पाए जा सकते जिसके पास पीजीएस प्रोफ़ाइल नहीं है. जब उपयोगकर्ता किसी दूसरे डिवाइस पर, Play Games Services की मदद से आपके गेम में लॉग इन करने की कोशिश करता है, तो प्रोफ़ाइल बनाने का अनुरोध अपने-आप दिखता है.
• आपको अन्य दिशा-निर्देशों का पालन करना होगा, ताकि यह पक्का किया जा सके कि आपके पास इन आइटम के बारे में बताने वाली सही सूचना है और आपने असली उपयोगकर्ता की सही सहमति ली है:
  • Play Games खाते को लिंक करने की सुविधा चालू करने के लिए, Google के साथ डेटा शेयर करना.
  • इस शेयरिंग को मैनेज करने के लिए सेटिंग की उपलब्धता, जैसे कि Play Games की सेटिंग.
  • Google की निजता नीति के तहत, इस डेटा को प्रोसेस करना.

टोकन और व्यक्ति के बारे में जानकारी का जोड़ा सेव करना

1. पीजीएस प्रोफ़ाइल के बिना, कोई उपयोगकर्ता ऐसा गेम खोलता है जिसमें प्रोफ़ाइल के बिना रीकॉल की सुविधा चालू है.
2. Games SDK टूल, अपने-आप साइन इन करने की सुविधा को ट्रिगर करता है. हालांकि, यह सुविधा काम नहीं करती, क्योंकि उपयोगकर्ता के पास कोई पीजीएस प्रोफ़ाइल नहीं है.
3. Games SDK टूल, उपयोगकर्ता को एक स्नैकबार दिखाता है. इससे उपयोगकर्ता को पता चलता है कि गेम को Google के साथ इंटिग्रेट किया गया है. इस स्नैकबार पर कार्रवाई की जा सकती है—उपयोगकर्ता, प्रोफ़ाइल बनने तक रिकॉल की सुविधा को बंद कर सकता है.
4. गेम, ऐक्सेस वापस पाने का अनुरोध करता है. ध्यान दें कि जब डिवाइस पर पीजीएस प्रोफ़ाइलें होती हैं या डिवाइस पर कोई Google खाता नहीं होता है, तो पीजीएस, रीकॉल ऐक्सेस के अनुरोधों को अस्वीकार कर देता है. ऐसे में, गेम को PGS का इस्तेमाल किए बिना आगे बढ़ना चाहिए.
5. जब उपयोगकर्ता, गेम में मौजूद खाते से लॉग इन करता है, तो गेम उपयोगकर्ता के लिए एक टोकन और व्यक्तित्व का जोड़ा बनाता है. यह जोड़ा, गेम में मौजूद खाते से जुड़ा होता है. गेम, इस जोड़े को Google के साथ सेव करता है. अगर उपयोगकर्ता गेम में मौजूद अन्य खातों में लॉग इन करता है, तो गेम में बाद में ज़्यादा टोकन सेव हो सकते हैं.

नए डिवाइस पर गेम लॉन्च करना

1. पीजीएस प्रोफ़ाइल के बिना, किसी उपयोगकर्ता ने किसी डिवाइस पर ऐसा गेम खोला है जिसमें प्रोफ़ाइल के बिना रीकॉल की सुविधा चालू है.
2. गेम, टोकन और व्यक्तिगत जानकारी के जोड़े को सेव करना में बताए गए तरीके से, प्रोफ़ाइल के बिना Recall टोकन रिकॉर्ड करता है.
3. उपयोगकर्ता उसी गेम को किसी दूसरे डिवाइस पर खोलता है जिस पर उसी खाते का सेटअप है.
4. Games SDK टूल, प्रोफ़ाइल बनाने की प्रोसेस को ट्रिगर करता है. उपयोगकर्ता, पहले से सेव किए गए रीकॉल टोकन की समीक्षा कर सकता है और उन्हें अस्वीकार कर सकता है. उपयोगकर्ता इस समय पीजीएस प्रोफ़ाइल बनाता है.
5. PGS में अपने-आप साइन इन होने की प्रोसेस पूरी हो जाती है और गेम को पुष्टि की गई स्थिति मिल जाती है.
6. गेम, उपयोगकर्ता के लिए हमेशा की तरह रीकॉल टोकन वापस लेता है.

अगले चरण

अपने क्लाइंट और गेम सर्वर के साथ Recall API को इंटिग्रेट करने के लिए, इस दिशा-निर्देश का पालन करें.