Recall API

Recall API की मदद से, Play की गेम सेवाओं (पीजीएस) को गेम के साथी के तौर पर इस्तेमाल किया जा सकता है साइन-इन करने के मौजूदा तरीके. उदाहरण के लिए, Google साइन-इन और बिना किसी रुकावट के सिंक करने की सुविधा खिलाड़ियों का अपने सभी डिवाइसों पर साइन-इन करने की जानकारी देकर, सदस्यता छोड़ने की दर कम की जा सकती है और D1 रिटेंशन को बढ़ाया जा सकता है. यह एपीआई, उपयोगकर्ता के Play की गेम सेवाओं (पीजीएस) खाते और अपने इन-गेम खातों से साइन इन करने के लिए, उन्हें Google के सर्वर पर रीकॉल टोकन सेव करने होंगे. यहाँ है Recall API के इस्तेमाल का सैंपल:

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

   

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

   

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

   

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

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

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

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

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

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

स्टोर करने और स्टोर करने से जुड़े तकनीकी फ़्लो की जानकारी Recall टोकन हासिल करना

इस सेक्शन में गेम क्लाइंट, गेम सर्वर, और गेम सर्वर के बीच के तकनीकी फ़्लो के बारे में बताया गया है और Recall टोकन सेव करते समय Google के सर्वर पर:

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

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

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

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

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

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

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

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

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

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

जिन लोगों के पास पीजीएस प्रोफ़ाइल नहीं है उनके लिए फ़्लो

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

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

टोकन और पर्सोना पेयर को सेव करें

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

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

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

अगले चरण

Recall API को अपने क्लाइंट और गेम सर्वर के साथ इंटिग्रेट करने के लिए, यह तरीका अपनाएं लागू करने की गाइड देखें.